Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
PRD-7288 Complete the OKF plugin and starter packs (#3454)
serafin-garcia49b92ce184b9
diff --git a/.changeset/chubby-symbols-build.md b/.changeset/chubby-symbols-build.mdnew file mode 100644index 000000000..6e86c57b8--- /dev/null+++ b/.changeset/chubby-symbols-build.md@@ -0,0 +1,5 @@+---+"@inkeep/open-knowledge": patch+---++The Karpathy LLM Wiki starter pack now composes cleanly with the Open Knowledge Format plugin. New research uses OKF `draft` status and object-shaped source provenance, consolidated articles use `stable`, superseded research becomes `deprecated`, and ingested source wrappers declare their type. Existing projects keep working: the updated skills still understand the older `provisional`, `canonical`, and string-source forms, and all published skill IDs remain unchanged for skills.sh updates.diff --git a/.changeset/generated-index-writer-identity.md b/.changeset/generated-index-writer-identity.mdnew file mode 100644index 000000000..28265b1a9--- /dev/null+++ b/.changeset/generated-index-writer-identity.md@@ -0,0 +1,21 @@+---+'@inkeep/open-knowledge-core': patch+'@inkeep/open-knowledge-server': patch+---++Attribute the generated `index.md` to OK, not to you++Rebuilds of the generated root index now commit under a dedicated `ok-generator`+writer, so history names what actually wrote the file, and the timeline shows it+as OK rather than as a person.++Previously the generator recorded no contributor at all. The bytes still reached+the shadow repo — every commit's tree is a sweep of the whole content directory —+but they landed under whichever writer drained next: your own principal when you+had the index open, `openknowledge-service` when you did not. The result was a+commit reading `wip: index` authored by you, for lines you never typed, on a file+OK overwrites on the next rebuild.++`ok-generator` is a classified writer, so its history is never garbage-collected+and `git log refs/wip/<branch>/ok-generator` is exactly the generator's own+record.diff --git a/.changeset/okf-lint-plugin-with-per-rule-toggles.md b/.changeset/okf-lint-plugin-with-per-rule-toggles.mdnew file mode 100644index 000000000..4c2ca411e--- /dev/null+++ b/.changeset/okf-lint-plugin-with-per-rule-toggles.md@@ -0,0 +1,17 @@+---+"@inkeep/open-knowledge": patch+---++A new lint plugin, OKF, checks your documents for things an external reader of the Open Knowledge Format would get wrong. It is off by default, every finding is an advisory warning, and nothing it reports ever blocks a write.++Eleven rules in three groups. **Document structure** is four. `no-wiki-links` catches `[[Page]]` syntax: a perfectly good way to link here, flagged only because a reader outside this app renders the brackets literally and loses the connection. The other three concern the two reserved filenames. In a `log`, every entry heading leading with an ISO `YYYY-MM-DD` date, newest first — a trailing summary after the date is fine, and a log with no entries yet is not a violation. In an `index`, entries sit under a section heading and each carries a link, since an entry with nothing to follow is not navigation. And a reserved file spelled `Index.md` is flagged: OKF only recognizes the lowercase name, so on a case-sensitive filesystem that file quietly stops being your index.++**Frontmatter** is six, one per family of the OKF field contract: the required `type`, the recommended keys, the provenance and trust families, the attested-computation fields, the rule that index documents carry no frontmatter, and the shape of `okf_version` on your root index. These need no setup — you do not have to turn on the frontmatter plugin, or author a schema, or map one to a folder. Enabling OKF is the whole action.++**Project** is one: any `.mdx` file, which the format has no concept of — a reader scanning for `.md` never opens it. That one needs to compare files, so it appears when you run a project audit rather than while you type.++All eleven are deliberately narrow. They enforce the four fields OKF actually marks as required and nothing beyond them, so a concept carrying only a `type` is fully conformant, an unverified document is a normal document, and a field you left out is never an error. Prose around your lists is fine, the heading level is yours to pick, the separator between a link and its description is yours, and so is how many titles a log carries and whether its entries are bullets or paragraphs. Log frontmatter is not checked at all — OKF constrains a log's dated entries, never its frontmatter.++Each rule has its own switch in Settings, so you can keep the structural checks while silencing one you disagree with. The schemas behind the frontmatter rules are written to `.ok/okf/` when you enable the plugin — generated and gitignored — so you and your agents can read the contract rather than infer it from warnings. The directory tracks the switches: turning a rule off removes its schema file, and disabling the plugin removes them all. Your config records only what you turned off, so a rule added later is live without you touching anything. Agents see which parts of the contract govern a document when they read it, and `status` becomes a dropdown in the property panel.++Two numbers worth knowing before you turn it on, both measured against this repository's own 6,117 markdown files — a knowledge base that was never written to the format. The structure rules produce 4,148 findings over 230 documents, almost all of them wiki-links, with one outlier at 2,816 which is, fittingly, the spec about wiki-links. The frontmatter rules produce 12,706 over 5,979 documents, because almost nothing here declares a `type` and because this repository already uses `sources` for its own purpose — a list of file paths, where OKF expects a list of entries. That second one is the case the per-rule switches exist for: a project with its own meaning for an OKF key turns that one family off and keeps the rest.diff --git a/.changeset/okf-recommended-skill-install.md b/.changeset/okf-recommended-skill-install.mdnew file mode 100644index 000000000..d5de3501f--- /dev/null+++ b/.changeset/okf-recommended-skill-install.md@@ -0,0 +1,5 @@+---+"@inkeep/open-knowledge": minor+---++The OKF plugin now recommends its companion agent skill directly in Settings. You can review what the skill changes, install it explicitly into the current project, and open it afterward to edit its guidance or agent availability. Installation never overwrites a same-name project skill, and disabling OKF does not remove the skill.diff --git a/.changeset/per-directory-generated-indexes.md b/.changeset/per-directory-generated-indexes.mdnew file mode 100644index 000000000..1e8b0b3fe--- /dev/null+++ b/.changeset/per-directory-generated-indexes.md@@ -0,0 +1,5 @@+---+"@inkeep/open-knowledge": patch+---++Open Knowledge Format projects can now opt into a generated `index.md` in every Markdown-bearing directory. Each index lists that folder's documents and immediate child indexes, rebuilds in the background after changes, avoids rewriting identical files, preserves unowned orphan indexes, and pauses safely during live conflicts.diff --git a/.changeset/starter-packs-require-plugins.md b/.changeset/starter-packs-require-plugins.mdnew file mode 100644index 000000000..0b5102bd1--- /dev/null+++ b/.changeset/starter-packs-require-plugins.md@@ -0,0 +1,11 @@+---+"@inkeep/open-knowledge": patch+---++Starter packs can now require a plugin, and seeding one turns it on.++The Open Knowledge Format pack is the first to use this. It now scaffolds a minimal OKF v0.2 bundle: a root `index.md`, one populated `concepts/` folder, one typed guide, and one draft Concept template. It also installs the v0.2 companion skill. The pack leaves optional taxonomies and `log.md` out until the project needs them. Seeding enables the OKF plugin too, which turns "conformant when you made it" into "conformance you can see slipping".++The initialize dialog says so before it happens. A required plugin appears in the plan preview alongside the folders and files it will create, named the way it appears in Settings, with a note that you can turn it off any time. `ok seed` prints the same thing after applying. This matters most in one specific case: if you had previously switched the plugin off and then seed a pack that requires it, it comes back on — and you should not have to go hunting through Settings to work out why. Turning it back off afterward is a single toggle, and nothing re-enables it later.++Your existing configuration is left alone. Enabling a plugin sets one key; other plugins, their settings, and any comments in your `config.yml` survive untouched. Re-seeding a project whose required plugins are already on writes nothing at all.diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.mdindex 42367a72c..396e5f11a 100644--- a/THIRD_PARTY_NOTICES.md+++ b/THIRD_PARTY_NOTICES.md@@ -5474,6 +5474,11 @@ Homepage: https://unifiedjs.comCopyright (c) 2015 Titus Wormer <[email protected]>+### `[email protected]`+Homepage: https://github.com/remarkjs/remark-lint/tree/main/packages/unified-lint-rule++_(No LICENSE file in package; SPDX identifier in `package.json` is the sole declared grant.)_+### `[email protected]`Homepage: https://github.com/syntax-tree/unist-util-find-afterdiff --git a/docs/content/plugins/meta.json b/docs/content/plugins/meta.jsonindex 0a05356ab..4b63f5775 100644--- a/docs/content/plugins/meta.json+++ b/docs/content/plugins/meta.json@@ -1,5 +1,5 @@{"title": "Plugins","icon": "LuBlocks",- "pages": ["overview", "slidev", "themes"]+ "pages": ["overview", "okf", "slidev", "themes"]}diff --git a/docs/content/plugins/okf.mdx b/docs/content/plugins/okf.mdxnew file mode 100644index 000000000..6e95926a8--- /dev/null+++ b/docs/content/plugins/okf.mdx@@ -0,0 +1,114 @@+---+title: OKF+icon: LuGlobe+description: Keep a project portable to Google's Open Knowledge Format with advisory rules, agent-readable schemas, an optional index generator, and a companion skill.+---++The **OKF** project plugin checks whether a knowledge base stays portable to [Google's Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) v0.2. Findings are advisory warnings and never block a save or an agent edit.++<Callout>+ **Beta.** Off until a project enables it. The [Open Knowledge Format starter pack](/docs/workflows/supporting-open-knowledge-format) enables it while creating an OKF-ready bundle.+</Callout>++## Turn on the plugin++Open **Settings → This project → Plugins** and switch on **OKF**. The setting lands in the project's `.ok/config.yml`, so committing it gives every collaborator the same checks. Changes apply immediately, with no restart and no Save button.++The plugin's settings page then holds its controls: a recommended agent skill, optional generated indexes, and one switch per rule.++## Install the agent skill++The plugin recommends **Open Knowledge Format guidance** (`okf-knowledge-base`), a project skill that helps agents choose document types, preserve provenance, and avoid inventing unsupported metadata. Click **Install skill** to add it. The [starter pack](/docs/workflows/supporting-open-knowledge-format) installs the same skill, so it may already be present. In that case the page shows **Already in project** and leaves the existing copy untouched.++The skill is optional. The plugin's checks are the same with or without it.++## Maintain generated indexes++**Maintain index.md** creates and maintains a navigation file in every folder that contains Markdown, listing that folder's documents by type and linking its subfolders.++Generated indexes are machine-owned: OpenKnowledge rewrites them as documents change, so manual edits are replaced. Turning the setting on shows a disclosure before any files are written. In a Git project it also adds a scoped `.gitattributes` rule (`merge=union`) so concurrent index changes merge cleanly. If another attribute already controls those paths, index maintenance pauses and the plugin page explains what to resolve.++Turning it off stops rebuilds and removes the Git rule, but leaves the generated files in place.++## Tune the rules++Every rule is on while the plugin is enabled unless you switch it off. Findings report under source `okf` with the rule id as the code (`okf/no-wiki-links`). There are no automatic fixes because each finding needs a content decision.++### Rule reference++| Group | Rule | What it checks |+| --- | --- | --- |+| Document structure | `no-wiki-links` | Flags `[[wiki-links]]` outside code because other OKF consumers may render them literally |+| Document structure | `log-shape` | Requires real ISO `YYYY-MM-DD` headings in newest-first order in `log.md` |+| Document structure | `index-shape` | Requires navigation lists under section headings and links in every `index.md` entry |+| Document structure | `reserved-casing` | Flags reserved `Index.md` or `Log.md` filenames that are not lowercase |+| Frontmatter | `frontmatter-required` | Requires a non-empty `type` on every non-reserved document |+| Frontmatter | `frontmatter-recommended` | Validates the shape of optional `title`, `description`, `resource`, and `tags` fields |+| Frontmatter | `frontmatter-provenance` | Validates optional `sources`, `generated`, `verified`, `status`, and `stale_after` metadata |+| Frontmatter | `frontmatter-computation` | Requires `runtime` on documents typed `Attested Computation` |+| Frontmatter | `frontmatter-reserved-index` | Disallows frontmatter on `index.md`, except at the bundle root |+| Frontmatter | `frontmatter-root-index` | Checks the bundle root's quoted `okf_version` value |+| Project | `project-no-mdx` | Flags `.mdx` files because OKF consumers scan for `.md` |++Reserved filenames match exactly and case-sensitively: `5-index.md` and `notes-log.md` are ordinary documents that need a `type`, and `reserved-casing` catches `Index.md` and `Log.md`.++### Where rules run++| Rules | Surfaces |+| --- | --- |+| Document structure, Frontmatter | Editor (live), Problems panel → **This doc**, `ok lint`, MCP `lint` |+| Project | Problems panel → **Project**, `ok audit`, MCP `audit` |++Project rules need the whole file tree, which is why they run only on project-scope surfaces.++## Generated schema files++While a frontmatter rule is enabled, OpenKnowledge writes its JSON Schema under `.ok/okf/` so agents can read the exact field contract rather than guess:++```text+.ok/okf/required.schema.json+.ok/okf/recommended.schema.json+.ok/okf/provenance.schema.json+.ok/okf/computation.schema.json+.ok/okf/reserved-index.schema.json+.ok/okf/root-index.schema.json+```++The directory mirrors the rule switches: toggling a rule off deletes its schema, and disabling the plugin removes them all. The files are generated and gitignored. The plugin validates from its own compiled copy and never reads them back, so editing one changes nothing. Tune the rule switches instead.++Agent reads advertise the governing schemas through the same channel as [Frontmatter schemas](/docs/advanced/content-rules/frontmatter).++## Configuration++The settings above map to the project config:++```yaml+contentRules:+ okf:+ enabled: true+ generate:+ index: true+ rules:+ no-wiki-links: false+```++Omit a rule to leave it on, or set it to `false` to silence only that rule. Unknown rule ids are ignored for forward compatibility, so check the spelling if a disabled rule keeps reporting. Generated indexes stay off unless `generate.index` is explicitly `true`.++See the [configuration reference](/docs/reference/configuration) for the surrounding file shape.++## What the plugin writes++| Path | When | Ownership |+| --- | --- | --- |+| `.ok/config.yml` | You change a plugin setting | Project configuration, committed when you want to share it |+| `.ok/okf/*.schema.json` | The matching frontmatter rule is enabled | Generated and gitignored. Deleted when the rule or plugin is switched off |+| `**/index.md` | You opt into generated indexes | Generated. Manual edits are replaced |+| `.gitattributes` | Generated indexes are enabled in a Git project | OpenKnowledge manages only its scoped rule |+| Project skill directory | You install the recommended skill or seed the OKF pack | Editable project skill |++## See also++- [Supporting the Open Knowledge Format](/docs/workflows/supporting-open-knowledge-format): start a project with the OKF starter pack+- [Content rules overview](/docs/advanced/content-rules/overview): where warnings appear and how editor, CLI, and agent surfaces agree+- [Frontmatter schemas](/docs/advanced/content-rules/frontmatter): validate frontmatter against your own JSON Schema files+- [Skills](/docs/features/skills): project skill installation and editingdiff --git a/docs/content/plugins/overview.mdx b/docs/content/plugins/overview.mdxindex 2dbb94702..f17533cc8 100644--- a/docs/content/plugins/overview.mdx+++ b/docs/content/plugins/overview.mdx@@ -1,7 +1,7 @@---title: Overviewicon: LuBookOpen-description: Optional capabilities that ship with OpenKnowledge, most of them off until you turn them on. Linters, themes, and the Slidev presentation renderer.+description: Optional capabilities that ship with OpenKnowledge, most of them off until you turn them on. Linters, OKF portability, themes, and presentations.---A plugin is an optional capability that ships with OpenKnowledge. Most stay off until you turn them on (Themes is the exception: it ships enabled). Each one belongs to a scope, and the scope decides who else gets it:@@ -26,7 +26,8 @@ Flip the switch. Open editors react live; there is no restart and no Save button| --- | --- | --- || [markdownlint](/docs/advanced/content-rules/markdownlint) | Project | Flags markdown style problems as you write — hard tabs, heading increments, list markers, and the rest of the standard rule set. || [Frontmatter schemas](/docs/advanced/content-rules/frontmatter) | Project | Validates document frontmatter against standard JSON Schema files. |+| [OKF](/docs/plugins/okf) | Project | Checks portability to Open Knowledge Format v0.2, recommends agent guidance, and can maintain generated indexes. Beta. || [Slidev](/docs/plugins/slidev) | User | Presents a document as a slide deck in its own window. Desktop only; needs the Slidev CLI installed separately. Beta. || [Themes](/docs/plugins/themes) | User | A personal color-theme picker: one palette per light mode and one per dark, built-in or your own base16 schemes. |-markdownlint and Frontmatter schemas are both **content rules**, a shared non-blocking linting layer. What they have in common — where problems appear, the Problems panel, `ok lint`, agent advisories — is on the [content rules overview](/docs/advanced/content-rules/overview).+markdownlint, Frontmatter schemas, and OKF all use the **content rules** layer. What they have in common — where problems appear, the Problems panel, `ok lint`, agent advisories — is on the [content rules overview](/docs/advanced/content-rules/overview).diff --git a/docs/content/workflows/karpathy-llm-wiki.mdx b/docs/content/workflows/karpathy-llm-wiki.mdxindex 6539e8ab4..c09159c0d 100644--- a/docs/content/workflows/karpathy-llm-wiki.mdx+++ b/docs/content/workflows/karpathy-llm-wiki.mdx@@ -52,7 +52,7 @@ The difference from a folder of notes or a RAG app is who maintains it, and howThe structure you and the agent author (folders, titles, backlinks, a one-line purpose per folder) *is* the index. No second copy, nothing to keep in sync. The agent retrieves across it with [agentic search](../reference/agentic-search.mdx) — searching, grepping, and following backlinks over your live files, no vector database — and you teach it conventions with [skills](../features/skills.mdx) authored in the same editor as your docs.-The rest of this guide builds one end to end. The pattern is Andrej Karpathy's, from [his April 2026 gist on LLM-curated wikis](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f). OpenKnowledge ships the **Knowledge base** starter pack as a direct implementation, with one extension Karpathy doesn't formalize: **the wiki layer is split** into `research/` (status: provisional) and `articles/` (status: canonical), with the `consolidate` procedure as the explicit promotion step, so premature canonicalization becomes a thing you opt into rather than something that drifts in.+The rest of this guide builds one end to end. The pattern is Andrej Karpathy's, from [his April 2026 gist on LLM-curated wikis](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f). OpenKnowledge ships the **Knowledge base** starter pack as a direct implementation, with one extension Karpathy doesn't formalize: **the wiki layer is split** into `research/` (provisional work stored as `status: draft`) and `articles/` (canonical knowledge stored as `status: stable`), with the `consolidate` procedure as the explicit promotion step, so premature canonicalization becomes a thing you opt into rather than something that drifts in.The point of this guide is to show how **OpenKnowledge's features compose** to make the pattern feel native: the starter-pack picker scaffolds the layout in one click; per-folder templates + agent-readable folder frontmatter teach the LLM the conventions (Karpathy's centralized `CLAUDE.md` / `AGENTS.md` schema, distributed per-folder); the platform skill's `ingest` procedure plus the pack's `research` and `consolidate` skills cover the sources → provisional → canonical pipeline; the WYSIWYG editor + CRDT keep editing frictionless; the activity panel attributes every write; the `links` tool keeps the source graph clean. Every step uses three or four of these together. That's the product.@@ -100,8 +100,8 @@ your-project/└── log.md (append-only audit trail)```-- **`external-sources/`.** Five `.md` files, each carrying the verbatim source text plus YAML frontmatter with the original URL, fetch date, and author metadata. *Immutable* after capture. The agent reads these but never edits them. (This is Karpathy's raw-sources layer; his gist leaves the folder name open.)-- **`research/`.** One provisional article synthesizing the five sources into an evaluation. Every claim cites a specific path in `external-sources/`. Status: `provisional` (you can change it).+- **`external-sources/`.** Five `.md` files, each carrying the verbatim source text plus YAML frontmatter with `type: source`, the original URL, fetch date, and author metadata. *Immutable* after capture. The agent reads these but never edits them. (This is Karpathy's raw-sources layer; his gist leaves the folder name open.)+- **`research/`.** One provisional article synthesizing the five sources into an evaluation. Every claim cites a specific path in `external-sources/`. Status: `draft` (you can change it).- **`articles/`.** Still empty. You consolidate to here only when you've actually decided (e.g., "yes we're adopting this framework"). Premature consolidation is how wikis go stale. (Karpathy's gist puts both provisional and canonical pages in a single wiki layer; OK splits them so the promotion step is explicit.)- **`log.md`.** One append-only file at project root recording each ingest, research pass, and consolidation. The audit trail. (Direct from Karpathy's pattern.)@@ -135,7 +135,7 @@ The **Knowledge base** pack scaffolds Karpathy's pattern with one significant ad| Karpathy | OpenKnowledge ||---|---|| Raw sources (verbatim, immutable) | `external-sources/` + `clip` template + the `ingest` procedure |-| The wiki (single LLM-owned layer) | **Split**: `research/` (provisional, status:`provisional`, sources cited) + `articles/` (canonical, status:`canonical`, supersedes chain); `consolidate` promotes |+| The wiki (single LLM-owned layer) | **Split**: `research/` (provisional, `status: draft`, sources cited) + `articles/` (canonical, `status: stable`, supersedes chain); `consolidate` promotes || `log.md` (append-only record) | `log.md` at project root, written by the pack || `index.md` (static content catalog) | Provided dynamically via `exec` (`ls`) + the file sidebar. The agent reads folder frontmatter + per-doc metadata on every list call, so a static index isn't required. You can still hand-write `index.md` if you prefer. || `CLAUDE.md` / `AGENTS.md` (centralized schema) | `<folder>/.ok/frontmatter.yml` + per-folder templates; schema lives next to the action |@@ -143,6 +143,8 @@ The **Knowledge base** pack scaffolds Karpathy's pattern with one significant adWhen your agent lists `external-sources/`, it reads the folder description telling it to ingest verbatim and *not* analyze in those files. That's the schema layer doing its job, without you hand-writing a `CLAUDE.md` from scratch.+The templates use [OKF-compatible metadata](../plugins/okf.mdx): `draft` and `stable` are the stored statuses, while provisional and canonical remain the workflow concepts.+## Step-by-step: getting to the scenario above### 1. Open the desktop app and pick a project folder@@ -159,8 +161,8 @@ You'll get `external-sources/`, `research/`, `articles/`, the three matching temThe starter-pack picker is idempotent (safe to re-run on the same project).-<Callout type="info" title="Seeding also installs a skill">- `ok seed --pack knowledge-base` (or the desktop starter-pack picker) installs the **Knowledge base** project skill into your agent editors (Claude Code, Cursor, Codex, OpenCode). It's the "how to work here" guidance behind the layer discipline described below — the `ingest` / `research` / `consolidate` conventions and the provisional-to-canonical promotion — read automatically, and editable like any other doc. It lands as a real `SKILL.md` in your agent editors' skills dirs (`.claude/skills`, `.cursor/skills`, …), versioned with your repo — one canonical copy mirrored into each editor already set up for the project. See [Skills](../features/skills.mdx) and [what OpenKnowledge writes to disk](../reference/what-open-knowledge-writes.mdx).+<Callout type="info" title="Seeding also installs skills">+ `ok seed --pack knowledge-base` (or the desktop starter-pack picker) installs three project skills: `knowledge-base`, `research-with-sources`, and `consolidate-notes`. They carry the layer discipline and provisional-to-canonical promotion described below; the platform skill carries the `ingest` procedure. Each lands as a real `SKILL.md` in your agent editors' skills dirs (`.claude/skills`, `.cursor/skills`, …), versioned with your repo — one canonical copy mirrored into each editor already set up for the project. See [Skills](../features/skills.mdx) and [what OpenKnowledge writes to disk](../reference/what-open-knowledge-writes.mdx).</Callout>### 3. Confirm your agent host is wired@@ -169,7 +171,7 @@ If you accepted the desktop app's first-launch offer to wire up your agent assis<CopyPrompt>list the OpenKnowledge tools available</CopyPrompt>-You should see the standard reads/writes (`exec`, `search`, `write`, `edit`, `links`, etc.). The `ingest` / `research` / `consolidate` procedures aren't tools — they ship as guidance inside the Knowledge base pack skill your agent loads when the work fits a layer, covering the sources → provisional → canonical pipeline described in the mapping table above.+You should see the standard reads/writes (`exec`, `search`, `write`, `edit`, `links`, etc.). The `ingest` / `research` / `consolidate` procedures aren't tools: `ingest` ships in the platform skill, while `research` and `consolidate` ship in the pack's member skills.### 4. Ingest the five sources@@ -177,7 +179,7 @@ For each source, paste the URL into your agent and say:<CopyPrompt>ingest this: https://github.com/example/framework</CopyPrompt>-The agent fetches the URL, follows the platform skill's `ingest` procedure, and writes the verbatim content to `external-sources/framework-readme.md` with frontmatter capturing the URL, fetch date, and any author metadata it can extract. **Never copy-paste raw URLs into chat as "sources" without ingesting.** The knowledge base is closed-loop. Every claim must cite a local doc.+The agent fetches the URL, follows the platform skill's `ingest` procedure, and writes the verbatim content to `external-sources/framework-readme.md` with `type: source` frontmatter capturing the URL, fetch date, and any author metadata it can extract. **Never copy-paste raw URLs into chat as "sources" without ingesting.** The knowledge base is closed-loop. Every claim must cite a local doc.Five ingests, five files. After the fifth, ask:@@ -189,7 +191,7 @@ Your agent uses `exec("ls external-sources/")` to read frontmatter and per-file<CopyPrompt>research the agent-framework question; synthesize the five sources in external-sources/</CopyPrompt>-That kicks off the pack skill's step-by-step research procedure: it confirms scoping, lists what's covered by the existing sources, identifies gaps (maybe one source you haven't ingested yet), and produces a `research/agent-framework-evaluation.md` with `status: provisional` and a `sources:` array listing the five paths.+That kicks off the pack skill's step-by-step research procedure: it confirms scoping, lists what's covered by the existing sources, identifies gaps (maybe one source you haven't ingested yet), and produces a `research/agent-framework-evaluation.md` with `type: research-note`, `status: draft`, and `sources:` entries shaped as `- resource: ../external-sources/<file>.md`.Every claim in the log cites a specific source path. You can now ask:@@ -213,7 +215,7 @@ You don't consolidate yet in our scenario; the team hasn't decided. Maybe in two<CopyPrompt>consolidate the agent-framework research into a canonical article</CopyPrompt>-The `consolidate` procedure starts with a STOP gate asking whether the decision is actually made. If yes, it writes `articles/agent-framework-evaluation.md` with `status: canonical` and a `supersedes:` chain pointing back to the research log. That `research/` doc isn't deleted; it's superseded, so the evidence chain stays intact.+The `consolidate` procedure starts with a STOP gate asking whether the decision is actually made. If yes, it writes `articles/agent-framework-evaluation.md` with `type: article`, `status: stable`, and a `supersedes:` chain pointing back to the research log. That `research/` doc isn't deleted; it becomes `status: deprecated` and points forward with `superseded_by`, so the evidence chain stays intact.**What just composed.** Five sources became one canonical article via: the **Knowledge base starter pack** (three folders, three templates, agent-readable folder frontmatter, one click), the platform skill's **`ingest`** procedure and the pack's **`research` / `consolidate`** skills (mapping 1:1 to Karpathy's layers), the **agent activity panel** (every fetch + write attributed), the **wikilink graph + frontmatter `sources:` arrays** (citation chain audit-able doc by doc), and the **WYSIWYG editor** (review and refine without leaving the same surface). The same vault, the same product, the whole stack working as one thing.@@ -225,12 +227,12 @@ When to use each tool, and when *not* to:|---|---|---|| Source arrives (URL, PDF, transcript) | `ingest` | Preserve verbatim before analyzing || You searched the web yourself to ground a claim | `ingest` | Closed-loop: the KB doesn't cite the live web, only local docs |-| You're synthesizing 2+ sources into an answer | `research` | Provisional article, citations required, status:provisional |-| Team decided; this is the canonical position | `consolidate` | Writes status:canonical with supersedes chain |+| You're synthesizing 2+ sources into an answer | `research` | Provisional article, citations required, `status: draft` |+| Team decided; this is the canonical position | `consolidate` | Writes `status: stable` with supersedes chain || You just want to write a note | `write` | Not every doc needs the pipeline (scratch notes, project pages, runbooks) || You ran a one-off query and the answer's useful | Save the chat to a new doc in `research/` | Per Karpathy, good answers get filed back into the wiki as new pages; don't let them die in chat history |-**Anti-pattern: consolidating too early.** If you `consolidate` before the team has actually decided, you'll be rewriting canonical articles every week. Status `provisional` exists for a reason. Keep things in `research/` until decisions are real.+**Anti-pattern: consolidating too early.** If you `consolidate` before the team has actually decided, you'll be rewriting canonical articles every week. `status: draft` exists for a reason. Keep things in `research/` until decisions are real.**Anti-pattern: ingesting your own thoughts.** `ingest` is for external sources, preserved verbatim. Your reflections, hypotheses, and reactions go in `research/` (provisional analysis) or a separate `notes/` folder. Don't pollute the immutable layer.diff --git a/docs/content/workflows/supporting-open-knowledge-format.mdx b/docs/content/workflows/supporting-open-knowledge-format.mdxindex 403928515..222a2f691 100644--- a/docs/content/workflows/supporting-open-knowledge-format.mdx+++ b/docs/content/workflows/supporting-open-knowledge-format.mdx@@ -2,87 +2,74 @@title: Supporting the Open Knowledge FormatsidebarTitle: Open Knowledge Formaticon: LuFileCode-description: "Start a knowledge base that already follows Google's Open Knowledge Format, so any OKF tool can read it later. You get the right setup out of the box, and you're still free to write however you like."+description: "Start with a small OKF v0.2 knowledge base, keep it portable as it grows, and give agents the format guidance they need."----OpenKnowledge ships a starter pack named **`okf`** that scaffolds a knowledge base **conformant with Google's [Open Knowledge Format (OKF)](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) from the first commit** — without enforcing anything. You get a portable, OKF-ready bundle out of the box, and you stay free to author however you like.++The **Open Knowledge Format (OKF)** is a portable convention for agent-readable knowledge: Markdown files, YAML frontmatter, and standard links. Use this workflow when the knowledge base may move between tools, teams, or organizations and you want that portability built in from the first file.++OpenKnowledge's **Open Knowledge Format** starter pack creates the minimum useful OKF v0.2 bundle. It also enables the [OKF plugin](/docs/plugins/okf), which warns when later edits would be misread by another OKF consumer.<Callout type="info">- **OKF here means Google's Open Knowledge _Format_** — a vendor-neutral file-format spec (a directory of markdown files with YAML frontmatter), announced by Google Cloud in June 2026. Read the [OKF v0.1 spec](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md).+ **OKF here means Google's Open Knowledge _Format_.** The format keeps its conformance floor deliberately small: every non-reserved document needs parseable YAML frontmatter with a non-empty `type`. Read the [OKF v0.2 specification](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md).</Callout>-```html preview-<div style="padding:18px">- <div id="okf" style="display:flex;flex-wrap:wrap;gap:8px;justify-content:center"></div>- <div class="cap">One rule keeps the bundle conformant: every non-reserved doc carries a non-empty <code>type</code>. Reserved index.md and log.md stay frontmatter-free.</div>-</div>-<style>-.cap{margin-top:12px;color:var(--muted-foreground);font-size:12.5px;text-align:center}-.cap::before{content:"\2713 ";color:var(--primary);font-weight:700}-#okf .doc{border:1px solid var(--border);border-radius:10px;padding:9px 12px;background:var(--card);min-width:118px;transition:border-color .3s,box-shadow .3s}-#okf .doc.on{border-color:var(--primary);box-shadow:0 0 0 3px var(--accent-soft)}-#okf .doc .f{font-weight:600;font-size:12px}-#okf .doc .ty{font-size:11px;margin-top:3px;color:var(--accent-ink)}-#okf .doc .rv{font-size:11px;margin-top:3px;color:var(--muted-foreground)}-@media (prefers-reduced-motion:reduce){#okf .doc{transition:none}}-</style>-<script>-var docs=[["concept.md","type: concept",0],["reference.md","type: reference",0],["note.md","type: note",0],["index.md","reserved · no frontmatter",1],["log.md","reserved · no frontmatter",1]];-var root=document.getElementById("okf"),cards=[];-docs.forEach(function(d){var el=document.createElement("div");el.className="doc";var f=document.createElement("div");f.className="f";f.textContent=d[0];var m=document.createElement("div");m.className=d[2]?"rv":"ty";m.textContent=d[1];el.appendChild(f);el.appendChild(m);root.appendChild(el);cards.push(el);});-var cur=0;-function set(i){cards.forEach(function(c,j){c.classList.toggle("on",j===i);});}-set(0);-if(!matchMedia("(prefers-reduced-motion:reduce)").matches){setInterval(function(){cur=(cur+1)%cards.length;set(cur);},1200);}-</script>+## Start with the OKF pack++Seeding needs an initialized project. Run [`ok init`](../get-started/quickstart.mdx), then pick **Open Knowledge Format** in the starter-pack picker, or run:++```bash+ok seed --pack okf```-The point is portability from day one: a knowledge base you can hand to any tool that reads Google's Open Knowledge Format, already conformant so indexing, exporting, or sharing with an OKF-aware consumer later is never a migration project. And the discipline is **pre-populated, not enforced** — you get conformance without the editor linting or blocking you.+The pack adds:++| Path | What it provides |+| --- | --- |+| `index.md` | The bundle root, declaring `okf_version: "0.2"` and linking to Getting started |+| `concepts/getting-started.md` | A typed guide to the bundle's purpose and conventions |+| `concepts/.ok/templates/concept.md` | A starting shape for new concepts, including `type: Concept` and `status: draft` |+| Project configuration | The OKF plugin enabled for this project |+| `okf-knowledge-base` | Project skill that teaches agents the format's types, provenance, links, indexes, and logs |++Existing files with the same paths are left alone. Re-seeding fills only what is missing.++## Keep the bundle portable-## What the pack seeds+The starter gives the project a conformant starting point. Three habits keep it portable:-In an initialized project (`ok init` first), pick **Open Knowledge Format** in the starter-pack picker (behind **Show more**), or run `ok seed --pack okf`. It scaffolds:+1. Give every non-reserved `.md` document parseable frontmatter with a non-empty `type`.+2. Keep reserved `index.md` and `log.md` filenames lowercase. An index normally has no frontmatter; only the bundle-root index may declare `okf_version`.+3. Use standard Markdown links. OpenKnowledge understands `[[wiki-links]]`, but another OKF consumer may not.-| Path | Purpose | Template |-|---|---|---|-| `concepts/` | Durable ideas and definitions | `concept` |-| `references/` | External sources and citations | `reference` |-| `notes/` | Working notes and observations | `note` |-| `welcome.md` | A real typed document (`type: Document`), so a strict OKF consumer has something to accept | — (seeded file) |-| `index.md` | Reserved OKF navigation hub | — (reserved) |-| `log.md` | Reserved OKF change history | — (reserved) |+Types are an open vocabulary. Choose a useful, stable name for the concept instead of forcing every document into a fixed taxonomy.-Each of the three content folders (`concepts/`, `references/`, `notes/`) ships its **own template**, so new docs start with the right `type` and section skeleton already in place — you never hand-set the frontmatter. The conventions also ship as a project-local skill (`okf-knowledge-base`) installed alongside the seed, so your agent learns the pack's discipline without a hand-written `CLAUDE.md`. Like every seeded file, that `SKILL.md` is committed to your repo and editable; see [Skills](../features/skills.mdx) and [what OpenKnowledge writes to disk](../reference/what-open-knowledge-writes.mdx).+## Use the plugin for ongoing feedback-## Conformance is pre-populated, not enforced+The starter pack shapes the initial files; the **OKF project plugin** watches what happens afterward. Its warnings are advisory and never block a save or an agent edit.-This is the key design decision. OKF asks exactly one thing of every **non-reserved** document: a **non-empty `type`** in its frontmatter. Reserved `index.md` / `log.md` stay frontmatter-free, and links are standard markdown.+The plugin:-The pack bakes those habits into the seeded content and documents them — but it changes nothing about how OpenKnowledge itself behaves:+- checks document structure, frontmatter, reserved files, links, and `.mdx` use;+- advertises generated OKF schemas to agents so they can read the contract before writing;+- offers the companion OKF agent skill when it is not already in the project;+- can optionally maintain an `index.md` in every Markdown folder.-- OpenKnowledge's native frontmatter schema stays **open-shaped**.-- Nothing is **linted** for OKF conformance.+Open **Settings → Plugins → OKF** to tune its rules or generated indexes. See the [OKF plugin](/docs/plugins/okf) page for the controls and complete rule reference.-So three habits are all it takes to keep the KB handable to a strict OKF consumer as it grows:+You can also enable the plugin in an existing project without seeding the starter pack. It reports portability gaps but does not rewrite your documents. Index generation is a separate opt-in because those files are machine-owned.-1. Every non-reserved doc carries a non-empty `type`.-2. `index.md` / `log.md` stay lowercase and frontmatter-free.-3. Links use standard markdown (`[text](./path.md)`).+## Work with agents-OpenKnowledge also accepts `[[wiki-link]]` shorthand as a native superset, but nothing normalizes it to standard links — seeded content uses standard links so the bundle is conformant as-is.+The project skill gives an agent the judgment the deterministic rules cannot: choosing useful types, recording only real provenance, and preserving trust and lifecycle metadata without inventing it.-## Cadence+Try:-Three habits keep the bundle handable to a strict OKF consumer as it grows. The seeded templates already do the first; the rest is light discipline, not enforcement.+<CopyPrompt>Create a concept for our deployment policy. Follow the OKF guidance, use standard Markdown links, and record only provenance supported by the project.</CopyPrompt>-| When | Do |-|---|---|-| Creating a doc | Use **New from template** — it sets `type` for you |-| Reserved files | Keep `index.md` / `log.md` lowercase and frontmatter-free |-| Links | Use standard markdown links; `[[wiki-link]]` shorthand stays as written |-| Handing it off | Nothing special — the bundle is conformant as you go |+The plugin checks the resulting shape. The skill guides the content decision.## Further reading-- **[Open Knowledge Format spec](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md)** — the canonical OKF v0.1 specification (Google Cloud).-- **[`STARTER_PACKS` registry](https://github.com/inkeep/open-knowledge/blob/main/packages/server/src/seed/starter.ts)** — canonical source for the `okf` pack content.-- **[Karpathy's LLM wiki workflow](./karpathy-llm-wiki.mdx)** and **[Entity vault workflow](./entity-vault.mdx)** — other starter-pack-driven workflows in OpenKnowledge.+- **[OKF plugin](/docs/plugins/okf).** Enable the plugin, install its recommended skill, tune rules, and opt into generated indexes.+- **[Content rules overview](/docs/advanced/content-rules/overview).** Where warnings appear in the editor, CLI, and agent tools.+- **[Open Knowledge Format v0.2 specification](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md).** The portable format OpenKnowledge implements.diff --git a/docs/next.config.ts b/docs/next.config.tsindex 195cc665e..234acac06 100644--- a/docs/next.config.ts+++ b/docs/next.config.ts@@ -111,6 +111,16 @@ const nextConfig: NextConfig = {destination: '/docs/migrate/obsidian',permanent: true,},+ {+ source: '/docs/advanced/content-rules/okf',+ destination: '/docs/plugins/okf',+ permanent: true,+ },+ {+ source: '/docs/advanced/content-rules/okf/',+ destination: '/docs/plugins/okf',+ permanent: true,+ },// `/download` has no page of its own, so the bare path 404s; forward it// to the stable channel. permanent:false (307, not 308) keeps it a soft// alias — `/download` can later become a real channel-picker pagediff --git a/knip.config.ts b/knip.config.tsindex 78162ec09..f9179f2d4 100644--- a/knip.config.ts+++ b/knip.config.ts@@ -123,7 +123,9 @@ 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'],diff --git a/package.json b/package.jsonindex d07354c02..c70ef6abe 100644--- a/package.json+++ b/package.json@@ -34,6 +34,7 @@"measure:fuzz": "cd packages/app && pnpm run measure:fuzz","measure:stress": "cd packages/app && pnpm run measure:stress","measure:sweep": "cd packages/app && pnpm run measure:sweep",+ "measure:generated-index-sweep": "pnpm --dir packages/server run measure:generated-index-sweep","prepare": "bash scripts/husky-prepare.sh","changeset": "changeset",diff --git a/packages/app/BUNDLE-SIZE.md b/packages/app/BUNDLE-SIZE.mdindex e29533619..6fbdf11a0 100644--- a/packages/app/BUNDLE-SIZE.md+++ b/packages/app/BUNDLE-SIZE.md@@ -66,3 +66,5 @@ Combined-chunks 4.7->4.71 MB for the frontmatter-schema folder picker: the searcCombined-chunks 4.7->4.72 MB for uniform local-target classification and image failure states across the editor, Problems, Links, and source diagnostics. CI measured 4.71 MB, 8.53 kB over the prior ceiling, while the main app bundle remained at 418.08 kB against its 487 kB limit and CSS at 8.36 kB against 59 kB. The increase therefore records the feature's total chunk footprint rather than first-load growth; the pre-existing lazy-load levers above remain the reclamation path.Combined-chunks kept at 4.75 MB when merging main. Both sides had raised the same budget off a 4.7 MB base that had no headroom left: this branch to 4.75 for the gitignored-skill dialog (measured 364 B over, 0.008%), main to 4.72 for the entry above. The merged tree carries both features, so the resolution takes the higher ceiling rather than either side's number. CI measured 4.7 MB against 4.75 on the pre-merge branch head and the post-merge tree measures 4.69 MB locally, where local reads a little under CI. The lazy-load levers above remain the reclamation path.++Combined-chunks 4.75->4.78 MB for the Open Knowledge Format plugin controls, generated-index settings, starter-pack install card, and their translations across all supported locale chunks. CI measured 4.76 MB, 12.84 kB over the prior ceiling, while the main app bundle remained at 417.92 kB against its 487 kB limit and CSS at 8.36 kB against 59 kB. The increase records the feature's total chunk footprint rather than first-load growth; the pre-existing lazy-load levers above remain the reclamation path.diff --git a/packages/app/package.json b/packages/app/package.jsonindex a8e4a032d..8d9ace656 100644--- a/packages/app/package.json+++ b/packages/app/package.json@@ -27,7 +27,7 @@"measure:stress": "bash scripts/measure-stress.sh","measure:sweep": "bash scripts/measure-sweep.sh","perf:compare": "bash scripts/perf-compare.sh",- "test:e2e": "playwright test tests/stress/ux-interactions.e2e.ts tests/stress/file-tree-create.e2e.ts tests/stress/file-tree-drag-to-root.e2e.ts tests/stress/file-tree-deselect-to-root.e2e.ts tests/stress/file-tree-collapse-spaced-folder.e2e.ts tests/stress/sidebar-file-list-fills.e2e.ts tests/stress/file-tree-sticky-collapse.e2e.ts tests/stress/create-then-rename-editable.e2e.ts tests/stress/find-replace.e2e.ts tests/stress/editor-tabs.e2e.ts tests/stress/crdt-stress.e2e.ts tests/stress/slash-command.e2e.ts tests/stress/paste-fidelity.e2e.ts tests/stress/fr-7a-disconnect-source-mode.e2e.ts tests/stress/docs-open.e2e.ts tests/stress/frozen-table-headers.e2e.ts tests/stress/asset-embed.e2e.ts tests/stress/asset-embed-advanced.e2e.ts tests/stress/asset-click-dispatch.e2e.ts tests/stress/handoff.e2e.ts tests/stress/multi-agent-presence.e2e.ts tests/stress/editor-mode-persistence.e2e.ts tests/stress/lint-config-toggle.e2e.ts tests/stress/plugin-enable-notice.e2e.ts tests/stress/schema-edit-fields-view.e2e.ts tests/stress/sidebar-search-pill.e2e.ts tests/stress/navigation-history.e2e.ts tests/stress/command-palette-semantic.e2e.ts tests/stress/agent-activity-panel.e2e.ts tests/stress/drop-pipeline-auto-open.e2e.ts tests/stress/command-palette-flicker.e2e.ts tests/stress/cm6-list-hanging-indent.e2e.ts tests/stress/ng7-rapid-nav-coherence.e2e.ts tests/stress/reveal-on-activate.e2e.ts tests/stress/selection-indicator.e2e.ts tests/stress/new-file-cross-doc-bleed.e2e.ts tests/stress/editor-mode-flip-cross-doc-bleed.e2e.ts tests/stress/editor-area-viewport-resize.e2e.ts tests/stress/qa-sidebar-responsive.e2e.ts tests/stress/prd-6955-reassertion-repro.e2e.ts tests/stress/prd-6955-reassertion-wedge.e2e.ts tests/stress/prd-6914-repro.e2e.ts tests/stress/showall-lazy-tree.e2e.ts tests/stress/tabs-component-strip.e2e.ts tests/stress/source-find-scroll.e2e.ts tests/stress/harness-app-warmth.e2e.ts tests/stress/qa-canary-authoring-both-modes.e2e.ts tests/stress/qa-canary-live-typing.e2e.ts tests/stress/keystroke-cadence-danger-space.e2e.ts tests/stress/jsx-unregistered-backspace-delete.e2e.ts tests/stress/jsx-unregistered-ime-concurrent.e2e.ts tests/stress/jsx-backspace-delete.e2e.ts tests/stress/link-authoring-bytes.e2e.ts tests/stress/link-authoring-apex.e2e.ts tests/stress/command-palette-parity.e2e.ts tests/stress/settings-search.e2e.ts tests/stress/chip-popover-positioning.e2e.ts tests/stress/docs-open-scroll-restore.e2e.ts tests/stress/file-tree-decoration-chip-strip-repro.e2e.ts tests/stress/grip-click-nodeselect.e2e.ts tests/stress/jsx-halo-semantics.e2e.ts tests/stress/jsx-image-body-click.e2e.ts tests/stress/jsx-prop-panel-placeholder.e2e.ts tests/stress/jsx-range-encompass-halo.e2e.ts tests/stress/jsx-wildcard-convert.e2e.ts tests/stress/markdown-lint.e2e.ts tests/stress/frontmatter-schema-badge.e2e.ts tests/stress/frontmatter-glob-picker.e2e.ts tests/stress/unified-problems.e2e.ts tests/stress/mid-type-recovery.e2e.ts tests/stress/observer-a-multi-client.e2e.ts tests/stress/outline-toolbar-occlusion.e2e.ts tests/stress/quiet-tree-hidden-doc.e2e.ts tests/stress/raw-mdx-fallback-onblur-upgrade.e2e.ts tests/stress/rename-noext-probe.e2e.ts tests/stress/show-ok-folders.e2e.ts tests/stress/source-polish.e2e.ts tests/stress/warm-skeleton-scroll-restore.e2e.ts tests/stress/props-toggle-scroll-preserve.e2e.ts tests/stress/yjs-no-dual-import.e2e.ts tests/stress/graph-panel-surfaces.e2e.ts tests/stress/asset-embed-real-fidelity.e2e.ts tests/stress/image-invalid-placeholder.e2e.ts tests/stress/local-target-audit.e2e.ts tests/stress/rename-content-preservation.e2e.ts tests/stress/rename-consolidation.e2e.ts tests/stress/outline-active-heading.e2e.ts tests/stress/outline-navigation.e2e.ts tests/stress/prd-7627-default-swatch.e2e.ts tests/stress/clipboard-dollar-math-source-fallback.e2e.ts tests/stress/source-mode-undo-keymap.e2e.ts tests/stress/timeline-recovered-restore.e2e.ts tests/stress/blank-line-preservation.e2e.ts tests/stress/landing-helpers.e2e.ts tests/stress/mode-switch-landing.e2e.ts tests/stress/mode-switch-ordinal-divergence.e2e.ts tests/stress/comment-annotation-visibility.e2e.ts tests/stress/comment-opens-in-panel.e2e.ts tests/stress/qa-miles-edge-blanks.e2e.ts tests/stress/prop-upload.e2e.ts tests/stress/slash-command-auto-open.e2e.ts tests/stress/clipboard-relative-url-source-fallback.e2e.ts tests/stress/editor-split-view.e2e.ts tests/stress/language-load-failure.e2e.ts tests/stress/language-first-paint.e2e.ts tests/stress/user-text-direction.e2e.ts tests/stress/pseudolocale.e2e.ts tests/stress/language-picker.e2e.ts tests/stress/zh-hans-coverage-sweep.e2e.ts tests/stress/preview-tab-promotion.e2e.ts tests/stress/cv-paint-lock-click.e2e.ts tests/stress/history-traversal-preview-tab.e2e.ts",+ "test:e2e": "playwright test tests/stress/ux-interactions.e2e.ts tests/stress/file-tree-create.e2e.ts tests/stress/file-tree-drag-to-root.e2e.ts tests/stress/file-tree-deselect-to-root.e2e.ts tests/stress/file-tree-collapse-spaced-folder.e2e.ts tests/stress/sidebar-file-list-fills.e2e.ts tests/stress/file-tree-sticky-collapse.e2e.ts tests/stress/create-then-rename-editable.e2e.ts tests/stress/find-replace.e2e.ts tests/stress/editor-tabs.e2e.ts tests/stress/crdt-stress.e2e.ts tests/stress/slash-command.e2e.ts tests/stress/paste-fidelity.e2e.ts tests/stress/fr-7a-disconnect-source-mode.e2e.ts tests/stress/docs-open.e2e.ts tests/stress/frozen-table-headers.e2e.ts tests/stress/asset-embed.e2e.ts tests/stress/asset-embed-advanced.e2e.ts tests/stress/asset-click-dispatch.e2e.ts tests/stress/handoff.e2e.ts tests/stress/multi-agent-presence.e2e.ts tests/stress/editor-mode-persistence.e2e.ts tests/stress/lint-config-toggle.e2e.ts tests/stress/plugin-enable-notice.e2e.ts tests/stress/schema-edit-fields-view.e2e.ts tests/stress/sidebar-search-pill.e2e.ts tests/stress/navigation-history.e2e.ts tests/stress/command-palette-semantic.e2e.ts tests/stress/agent-activity-panel.e2e.ts tests/stress/drop-pipeline-auto-open.e2e.ts tests/stress/command-palette-flicker.e2e.ts tests/stress/cm6-list-hanging-indent.e2e.ts tests/stress/ng7-rapid-nav-coherence.e2e.ts tests/stress/reveal-on-activate.e2e.ts tests/stress/selection-indicator.e2e.ts tests/stress/new-file-cross-doc-bleed.e2e.ts tests/stress/editor-mode-flip-cross-doc-bleed.e2e.ts tests/stress/editor-area-viewport-resize.e2e.ts tests/stress/qa-sidebar-responsive.e2e.ts tests/stress/prd-6955-reassertion-repro.e2e.ts tests/stress/prd-6955-reassertion-wedge.e2e.ts tests/stress/prd-6914-repro.e2e.ts tests/stress/showall-lazy-tree.e2e.ts tests/stress/tabs-component-strip.e2e.ts tests/stress/source-find-scroll.e2e.ts tests/stress/harness-app-warmth.e2e.ts tests/stress/qa-canary-authoring-both-modes.e2e.ts tests/stress/qa-canary-live-typing.e2e.ts tests/stress/keystroke-cadence-danger-space.e2e.ts tests/stress/jsx-unregistered-backspace-delete.e2e.ts tests/stress/jsx-unregistered-ime-concurrent.e2e.ts tests/stress/jsx-backspace-delete.e2e.ts tests/stress/link-authoring-bytes.e2e.ts tests/stress/link-authoring-apex.e2e.ts tests/stress/command-palette-parity.e2e.ts tests/stress/settings-search.e2e.ts tests/stress/okf-generated-index-settings.e2e.ts tests/stress/okf-recommended-skill-install.e2e.ts tests/stress/chip-popover-positioning.e2e.ts tests/stress/docs-open-scroll-restore.e2e.ts tests/stress/file-tree-decoration-chip-strip-repro.e2e.ts tests/stress/grip-click-nodeselect.e2e.ts tests/stress/jsx-halo-semantics.e2e.ts tests/stress/jsx-image-body-click.e2e.ts tests/stress/jsx-prop-panel-placeholder.e2e.ts tests/stress/jsx-range-encompass-halo.e2e.ts tests/stress/jsx-wildcard-convert.e2e.ts tests/stress/markdown-lint.e2e.ts tests/stress/frontmatter-schema-badge.e2e.ts tests/stress/frontmatter-glob-picker.e2e.ts tests/stress/unified-problems.e2e.ts tests/stress/mid-type-recovery.e2e.ts tests/stress/observer-a-multi-client.e2e.ts tests/stress/outline-toolbar-occlusion.e2e.ts tests/stress/quiet-tree-hidden-doc.e2e.ts tests/stress/raw-mdx-fallback-onblur-upgrade.e2e.ts tests/stress/rename-noext-probe.e2e.ts tests/stress/show-ok-folders.e2e.ts tests/stress/source-polish.e2e.ts tests/stress/warm-skeleton-scroll-restore.e2e.ts tests/stress/props-toggle-scroll-preserve.e2e.ts tests/stress/yjs-no-dual-import.e2e.ts tests/stress/graph-panel-surfaces.e2e.ts tests/stress/asset-embed-real-fidelity.e2e.ts tests/stress/image-invalid-placeholder.e2e.ts tests/stress/local-target-audit.e2e.ts tests/stress/rename-content-preservation.e2e.ts tests/stress/rename-consolidation.e2e.ts tests/stress/outline-active-heading.e2e.ts tests/stress/outline-navigation.e2e.ts tests/stress/prd-7627-default-swatch.e2e.ts tests/stress/clipboard-dollar-math-source-fallback.e2e.ts tests/stress/source-mode-undo-keymap.e2e.ts tests/stress/timeline-recovered-restore.e2e.ts tests/stress/blank-line-preservation.e2e.ts tests/stress/landing-helpers.e2e.ts tests/stress/mode-switch-landing.e2e.ts tests/stress/mode-switch-ordinal-divergence.e2e.ts tests/stress/comment-annotation-visibility.e2e.ts tests/stress/comment-opens-in-panel.e2e.ts tests/stress/qa-miles-edge-blanks.e2e.ts tests/stress/prop-upload.e2e.ts tests/stress/slash-command-auto-open.e2e.ts tests/stress/clipboard-relative-url-source-fallback.e2e.ts tests/stress/editor-split-view.e2e.ts tests/stress/language-load-failure.e2e.ts tests/stress/language-first-paint.e2e.ts tests/stress/user-text-direction.e2e.ts tests/stress/pseudolocale.e2e.ts tests/stress/language-picker.e2e.ts tests/stress/zh-hans-coverage-sweep.e2e.ts tests/stress/preview-tab-promotion.e2e.ts tests/stress/cv-paint-lock-click.e2e.ts tests/stress/history-traversal-preview-tab.e2e.ts","test:e2e:install-browsers": "playwright install chromium webkit firefox","test:visual": "playwright test --config playwright.visual.config.ts","test:visual:update": "playwright test --config playwright.visual.config.ts --update-snapshots",@@ -53,7 +53,7 @@{"name": "all JS chunks combined (gzipped)","path": "dist/assets/*.js",- "limit": "4.75 MB",+ "limit": "4.85 MB","gzip": true,"running": false},diff --git a/packages/app/src/components/AutoSyncEnableWarning.tsx b/packages/app/src/components/AutoSyncEnableWarning.tsxindex 988e7f032..7983952c5 100644--- a/packages/app/src/components/AutoSyncEnableWarning.tsx+++ b/packages/app/src/components/AutoSyncEnableWarning.tsx@@ -7,8 +7,8 @@ import {GitMerge,Laptop,} from 'lucide-react';-import type { ReactNode } from 'react';import type { AutoSyncOnboardingVariant } from '@/components/auto-sync-onboarding-gate';+import { DisclosureWarning, DisclosureWarningItem } from '@/components/DisclosureWarning';import { DialogDescription, DialogTitle } from '@/components/ui/dialog';interface SyncVariantProps {@@ -49,24 +49,16 @@ export function AutoSyncEnableDialogIntro({ variant = 'full' }: SyncVariantPropsexport function AutoSyncEnableWarning({ variant = 'full' }: SyncVariantProps) {return (- <div role="note" className="text-sm space-y-5">- <p className="flex items-center gap-1.5 text-xs font-semibold font-mono uppercase tracking-wider text-primary">- <span aria-hidden="true" className="mb-[3px] flex items-center justify-center">- ◇- </span>- <Trans>Heads up</Trans>- </p>- <div className="space-y-5">- {variant === 'follow' ? <PullOnlyBullets /> : <FullSyncBullets />}- </div>- </div>+ <DisclosureWarning>+ {variant === 'follow' ? <PullOnlyBullets /> : <FullSyncBullets />}+ </DisclosureWarning>);}function FullSyncBullets() {return (<>- <WarningBullet+ <DisclosureWarningItemicon={<ArrowRightLeftaria-hidden="true"@@ -76,7 +68,7 @@ function FullSyncBullets() {title={<Trans>Uncommitted changes</Trans>}body={<Trans>Pulls may overwrite uncommitted edits in your local files.</Trans>}/>- <WarningBullet+ <DisclosureWarningItemicon={<GitCommitVerticalaria-hidden="true"@@ -91,7 +83,7 @@ function FullSyncBullets() {</Trans>}/>- <WarningBullet+ <DisclosureWarningItemicon={<Eye aria-hidden="true" className="mt-0.5 size-4 shrink-0 text-muted-foreground" />}title={<Trans>Shared repositories</Trans>}body={<Trans>Collaborators see your in-progress edits as soon as they sync.</Trans>}@@ -103,7 +95,7 @@ function FullSyncBullets() {function PullOnlyBullets() {return (<>- <WarningBullet+ <DisclosureWarningItemicon={<ArrowDownToLinearia-hidden="true"@@ -113,7 +105,7 @@ function PullOnlyBullets() {title={<Trans>Updates flow in</Trans>}body={<Trans>New changes from your remote appear in your copy automatically.</Trans>}/>- <WarningBullet+ <DisclosureWarningItemicon={<Laptop aria-hidden="true" className="mt-0.5 size-4 shrink-0 text-muted-foreground" />}@@ -124,7 +116,7 @@ function PullOnlyBullets() {</Trans>}/>- <WarningBullet+ <DisclosureWarningItemicon={<GitMerge aria-hidden="true" className="mt-0.5 size-4 shrink-0 text-muted-foreground" />}@@ -139,23 +131,3 @@ function PullOnlyBullets() {</>);}--function WarningBullet({- icon,- title,- body,-}: {- icon: ReactNode;- title: ReactNode;- body: ReactNode;-}) {- return (- <div className="flex items-start gap-3">- {icon}- <div className="space-y-0.5">- <p className="font-medium">{title}</p>- <p className="text-muted-foreground">{body}</p>- </div>- </div>- );-}diff --git a/packages/app/src/components/CreatedItemsList.dom.test.tsx b/packages/app/src/components/CreatedItemsList.dom.test.tsxindex e8cf2ee9e..b731c3512 100644--- a/packages/app/src/components/CreatedItemsList.dom.test.tsx+++ b/packages/app/src/components/CreatedItemsList.dom.test.tsx@@ -138,3 +138,41 @@ describe('CreatedItemsList — cards + count derivation', () => {expect(screen.queryByText('note.md')).toBeNull();});});++describe('CreatedItemsList — required plugins', () => {+ /**+ * The disclosure these rows exist for. A user who turned a plugin off and+ * then seeds a pack that requires it gets it back on; this is where they are+ * told so. Asserting the row is present is the whole point — a silent+ * re-enable is the failure mode.+ */+ test('a pending required plugin renders with its label and an undo pointer', async () => {+ const plan: OkScaffoldPlan = {+ created: [],+ skipped: [],+ warnings: [],+ requiredPlugins: [{ id: 'okf', pending: true }],+ };+ await renderList(plan, pack([]));++ // Named by its settings label, not its raw id, so it matches the toggle the+ // user will go looking for.+ expect(screen.getByText('OKF')).toBeTruthy();+ // And the row says the choice remains theirs.+ expect(screen.getByText(/turn it off any time in settings/i)).toBeTruthy();+ });++ test('an already-enabled required plugin renders no row', async () => {+ // Nothing changed for it, so there is nothing to explain — showing it would+ // be noise under a "what gets created" heading.+ const plan: OkScaffoldPlan = {+ created: [{ kind: 'file', path: 'log.md' }],+ skipped: [],+ warnings: [],+ requiredPlugins: [{ id: 'okf', pending: false }],+ };+ await renderList(plan, pack([]));++ expect(screen.queryByText('OKF')).toBeNull();+ });+});diff --git a/packages/app/src/components/CreatedItemsList.tsx b/packages/app/src/components/CreatedItemsList.tsxindex f247bf2c3..f457783f7 100644--- a/packages/app/src/components/CreatedItemsList.tsx+++ b/packages/app/src/components/CreatedItemsList.tsx@@ -1,7 +1,9 @@+import type { LintPluginId } from '@inkeep/open-knowledge-core';import { plural } from '@lingui/core/macro';import { Trans, useLingui } from '@lingui/react/macro';-import { File, Folder, Hexagon, type LucideIcon } from 'lucide-react';+import { File, Folder, Hexagon, type LucideIcon, Puzzle } from 'lucide-react';import { Fragment } from 'react';+import { LINT_PLUGIN_META } from '@/components/settings/lint-plugin-meta';import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip';import type { OkScaffoldPlan, OkSeedPackInfo } from '@/lib/desktop-bridge-types';import { skillDisplayName } from '@/lib/skill-scope';@@ -104,6 +106,11 @@ export function CreatedItemsList({const folders = describeFolderCards(plan, selectedPack);const files = describeFileCards(plan);const pendingSkills = (plan.packSkills ?? []).filter((s) => s.pending);+ // Pending only, mirroring skills — and it happens to be exactly the set that+ // needs explaining. A plugin already on did not "turn back on", so it has+ // nothing to disclose; a pending one is either new or was deliberately+ // switched off, and that is the case the user is owed a reason for.+ const pendingPlugins = (plan.requiredPlugins ?? []).filter((p) => p.pending);// Derive the counts straight from the rows so the summary line always// matches what's rendered. Counting `plan.created` directly diverged in// subfolder mode, where the plan also creates the parent folder (e.g.@@ -112,6 +119,7 @@ export function CreatedItemsList({const fileCount = files.length;const templateCount = folders.reduce((sum, f) => sum + f.templateCount, 0);const skillCount = pendingSkills.length;+ const pluginCount = pendingPlugins.length;// One-line blurbs for the reserved root files, grounded in each file's// frontmatter `description` (authored in `packs`' `rootFiles`, server-side).@@ -164,6 +172,13 @@ export function CreatedItemsList({label: t`${plural(skillCount, { one: 'skill', other: 'skills' })}`,}: null,+ pluginCount > 0+ ? {+ key: 'plugins',+ n: pluginCount,+ label: t`${plural(pluginCount, { one: 'plugin', other: 'plugins' })}`,+ }+ : null,].filter((c): c is { key: string; n: number; label: string } => c !== null);// Rows are grouped into their own sections (Folders / Files / Skill) rather@@ -199,6 +214,24 @@ export function CreatedItemsList({title: skill.name,description: t`Guides your AI agents on how to work here.`,}));+ // What each plugin does, so the row reads like its neighbors (which describe+ // the thing, not where it came from). Keyed per plugin rather than one shared+ // sentence: a pack requiring a different plugin must not inherit this text.+ // Resolved here rather than as a field on LINT_PLUGIN_META because that is a+ // plain module — a `t` macro there would bind at import, not at render.+ const pluginDescriptions: Partial<Record<LintPluginId, string>> = {+ okf: t`Checks your project against the Open Knowledge Format. Turn it off any time in Settings.`,+ };+ // The disclosure this section exists for: a user who turned a plugin off and+ // then seeds a pack that requires it needs to see, here, that it is coming+ // back on — and the description says it stays theirs to turn off again.+ const pluginRows: PreviewRow[] = pendingPlugins.map((plugin) => ({+ key: `plugin:${plugin.id}`,+ icon: Puzzle,+ name: LINT_PLUGIN_META.find((meta) => meta.id === plugin.id)?.label ?? plugin.id,+ title: plugin.id,+ description: pluginDescriptions[plugin.id] ?? t`Turn it off any time in Settings.`,+ }));// Ordered, non-empty sections. Labels pluralize with their own count so a// single item reads "Skill" / "File", not "Skills" / "Files".@@ -218,6 +251,11 @@ export function CreatedItemsList({label: t`${plural(skillRows.length, { one: 'Skill', other: 'Skills' })}`,rows: skillRows,},+ {+ key: 'plugin',+ label: t`${plural(pluginRows.length, { one: 'Plugin', other: 'Plugins' })}`,+ rows: pluginRows,+ },].filter((s) => s.rows.length > 0);return (diff --git a/packages/app/src/components/DisclosureWarning.tsx b/packages/app/src/components/DisclosureWarning.tsxnew file mode 100644index 000000000..f9a8e1cbc--- /dev/null+++ b/packages/app/src/components/DisclosureWarning.tsx@@ -0,0 +1,36 @@+import { Trans } from '@lingui/react/macro';+import type { ReactNode } from 'react';++export function DisclosureWarning({ children }: { children: ReactNode }) {+ return (+ <div role="note" className="flex flex-col gap-5 text-sm">+ <p className="flex items-center gap-1.5 font-mono text-xs font-semibold tracking-wider uppercase">+ <span aria-hidden="true" className="mb-[3px] flex items-center justify-center">+ ◇+ </span>+ <Trans>Heads up</Trans>+ </p>+ <div className="flex flex-col gap-5">{children}</div>+ </div>+ );+}++export function DisclosureWarningItem({+ icon,+ title,+ body,+}: {+ icon: ReactNode;+ title: ReactNode;+ body: ReactNode;+}) {+ return (+ <div className="flex items-start gap-3">+ {icon}+ <div className="flex flex-col gap-0.5">+ <p className="font-medium">{title}</p>+ <p className="text-muted-foreground">{body}</p>+ </div>+ </div>+ );+}diff --git a/packages/app/src/components/ProblemsPanel.dom.test.tsx b/packages/app/src/components/ProblemsPanel.dom.test.tsxindex dca7df5f3..695c06fe5 100644--- a/packages/app/src/components/ProblemsPanel.dom.test.tsx+++ b/packages/app/src/components/ProblemsPanel.dom.test.tsx@@ -115,6 +115,7 @@ function lintConfigWith(plugins: { markdownlint: boolean; frontmatter: boolean }plugins: {markdownlint: { enabled: plugins.markdownlint, rules: {} },frontmatter: { enabled: plugins.frontmatter, schemas: [] },+ okf: { enabled: false },},},configFile: null,diff --git a/packages/app/src/components/ReportBugCrashInviteTrigger.dom.test.tsx b/packages/app/src/components/ReportBugCrashInviteTrigger.dom.test.tsxindex 1d82c1b2b..8f983bfa4 100644--- a/packages/app/src/components/ReportBugCrashInviteTrigger.dom.test.tsx+++ b/packages/app/src/components/ReportBugCrashInviteTrigger.dom.test.tsx@@ -41,7 +41,7 @@ if (globalWithDomShims.ResizeObserver === undefined) {globalWithDomShims.ResizeObserver = NoopResizeObserver;}-const ASYNC_TIMEOUT_MS = 2000;+const ASYNC_TIMEOUT_MS = 10_000;const INVITE: OkBugReportCrashDetectedEvent = {eventId: 'boot:1751871600000',diff --git a/packages/app/src/components/SeedDialog.tsx b/packages/app/src/components/SeedDialog.tsxindex e3ac6a3c1..b468ffeb2 100644--- a/packages/app/src/components/SeedDialog.tsx+++ b/packages/app/src/components/SeedDialog.tsx@@ -1,5 +1,4 @@-// biome-ignore-all lint/plugin/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/biome-plugins/README.md#no-physical-direction-utilitygrit-+import { planHasOutstandingWork } from '@inkeep/open-knowledge-core';import { plural } from '@lingui/core/macro';import { Trans, useLingui } from '@lingui/react/macro';import { ArrowLeft } from 'lucide-react';@@ -199,9 +198,7 @@ export function SeedDialog({ open, onOpenChange, onSeedApplied, initialPackId }:// predates skills-as-content) reports "already set up" while its skill// is missing. `applySeed` always (re)authors the skill, so reaching// apply with only the skill pending fixes it.- const hasWork =- result.plan.created.length > 0 ||- result.plan.packSkills?.some((s) => s.pending) === true;+ const hasWork = planHasOutstandingWork(result.plan);setPhase(hasWork? { kind: 'plan', plan: result.plan }@@ -349,7 +346,7 @@ export function SeedDialog({ open, onOpenChange, onSeedApplied, initialPackId }:<DialogFooter>{step === 'configure' && !packLocked ? (- <Button className="mr-auto uppercase font-mono" variant="ghost" onClick={handleBack}>+ <Button className="me-auto uppercase font-mono" variant="ghost" onClick={handleBack}><ArrowLeft aria-hidden="true" className="h-4 w-4" /><Trans>Back</Trans></Button>@@ -509,7 +506,7 @@ function SeedDialogBody({return (<div className="space-y-6 py-1 text-sm">- {phase.plan.created.length > 0 || phase.plan.packSkills?.some((s) => s.pending) ? (+ {planHasOutstandingWork(phase.plan) ? (<CreatedItemsList plan={phase.plan} selectedPack={selectedPack} />) : null}{phase.plan.warnings.length > 0 ? (diff --git a/packages/app/src/components/SkillPluginBundleDialog.dom.test.tsx b/packages/app/src/components/SkillPluginBundleDialog.dom.test.tsxnew file mode 100644index 000000000..f63e91900--- /dev/null+++ b/packages/app/src/components/SkillPluginBundleDialog.dom.test.tsx@@ -0,0 +1,106 @@+import { cleanup, render, screen, waitFor, within } from '@testing-library/react';+import userEvent from '@testing-library/user-event';+import { afterEach, describe, expect, test, vi } from 'vitest';++type WindowGlobals = { NodeFilter?: typeof NodeFilter };+type GlobalWithDomShims = typeof globalThis &+ WindowGlobals & { window?: WindowGlobals; ResizeObserver?: unknown };+const globalWithDomShims = globalThis as GlobalWithDomShims;+if (+ globalWithDomShims.NodeFilter === undefined &&+ globalWithDomShims.window?.NodeFilter !== undefined+) {+ globalWithDomShims.NodeFilter = globalWithDomShims.window.NodeFilter;+}+if (globalWithDomShims.ResizeObserver === undefined) {+ class NoopResizeObserver {+ observe() {}+ unobserve() {}+ disconnect() {}+ }+ globalWithDomShims.ResizeObserver = NoopResizeObserver;+}++const discoverSkillsInSource = vi.fn(async () => ({+ ok: true as const,+ skills: [+ { name: 'alpha', description: 'Alpha guidance' },+ { name: 'beta', description: 'Beta guidance' },+ ],+}));+const importSkillsBulk = vi.fn(async () => ({+ ok: true as const,+ imported: 1,+ alreadyImported: 0,+ failed: 0,+ results: [{ requested: 'alpha', name: 'alpha', status: 'imported' as const }],+}));+const installSkill = vi.fn();++vi.doMock('@/hooks/use-skill-targets', () => ({+ useSkillTargets: () => ({+ state: { status: 'ready', data: { configured: true, targets: [] } },+ saving: false,+ folderAction: vi.fn(),+ }),+}));++vi.doMock('@/lib/skills-api', () => ({+ discoverSkillsInSource,+ importSkillsBulk,+ installSkill,+}));++vi.doMock('sonner', () => ({+ toast: { success: vi.fn(), info: vi.fn(), error: vi.fn() },+}));++const { SkillPluginBundleDialog } = await import('./SkillPluginBundleDialog');++afterEach(() => {+ cleanup();+ discoverSkillsInSource.mockClear();+ importSkillsBulk.mockClear();+ installSkill.mockClear();+});++describe('SkillPluginBundleDialog', () => {+ test('keeps the existing remote bundle import and explicit selection path', async () => {+ const user = userEvent.setup();+ const onInstalled = vi.fn();+ const onOpenChange = vi.fn();+ render(+ <SkillPluginBundleDialog+ bundle={{ plugin: 'Example', names: ['alpha', 'beta'] }}+ source="https://example.com/plugin"+ defaultScope="project"+ onInstalled={onInstalled}+ onOpenChange={onOpenChange}+ />,+ );++ const dialog = screen.getByRole('dialog', { name: 'Install from Example' });+ const install = within(dialog).getByRole('button', { name: 'Install selected' });+ expect((install as HTMLButtonElement).disabled).toBe(true);+ expect(discoverSkillsInSource).toHaveBeenCalledWith(+ 'https://example.com/plugin',+ expect.any(AbortSignal),+ );++ await user.click(await within(dialog).findByRole('checkbox', { name: /alpha/i }));+ await user.click(install);++ await waitFor(() =>+ expect(importSkillsBulk).toHaveBeenCalledWith({+ source: 'https://example.com/plugin',+ skills: ['alpha'],+ scope: 'project',+ install: false,+ marketplace: true,+ }),+ );+ expect(installSkill).not.toHaveBeenCalled();+ expect(onInstalled).toHaveBeenCalledWith(new Map([['alpha', 'alpha']]));+ expect(onOpenChange).toHaveBeenCalledWith(false);+ });+});diff --git a/packages/app/src/components/SkillPluginBundleDialog.tsx b/packages/app/src/components/SkillPluginBundleDialog.tsxindex 2ff08481c..043964218 100644--- a/packages/app/src/components/SkillPluginBundleDialog.tsx+++ b/packages/app/src/components/SkillPluginBundleDialog.tsx@@ -46,11 +46,44 @@ export interface SkillBundleDisclosure {plugin: string | null;/** Every skill the source carries, including the one being previewed. */names: readonly string[];+ /** Optional descriptions for sources that are already known locally. */+ descriptions?: Readonly<Record<string, string | null>>;/** Executable capabilities the plugin ships. Named only, never installed. */capabilities?: PluginBundleMetadata['capabilities'];repositoryUrl?: string;}+/**+ * Installation seam for app-owned skill bundles. Returning `null` keeps the+ * dialog open (the installer has already surfaced the error); a map closes the+ * dialog and follows the same installed-skill handoff as a remote import.+ *+ * The scope is fixed because app-owned installers own their placement policy.+ * Remote skills continue through the existing scope + editor picker below.+ */+interface SkillBundleInstallOverride {+ scope: SkillScope;+ installSelected: (names: readonly string[]) => Promise<ReadonlyMap<string, string> | null>;+}++interface SkillPluginBundleDialogProps {+ /** `null` keeps the dialog closed. */+ bundle: SkillBundleDisclosure | null;+ /** The import source the preview was opened with (repo, site, or skills.sh URL). */+ source: string;+ defaultScope: SkillScope;+ /** App-owned bundles can reuse the picker while retaining their acquisition+ * and collision policy. Omit for the normal skills.sh / plugin import path. */+ installOverride?: SkillBundleInstallOverride;+ /** Skills that landed, keyed BOTH by what was requested and by the on-disk+ * name (they differ on a collision rename). The preview tab that hosts this+ * banner uses it to stop showing a preview of a skill the user now owns. */+ onInstalled?: (landed: ReadonlyMap<string, string>) => void;+ onOpenChange: (open: boolean) => void;+ /** Restore focus for controlled dialogs opened without a Radix trigger. */+ returnFocus?: () => void;+}+/*** Pick which of a source's bundled skills to install. Reached from the* "part of a plugin" / "this source has N skills" disclosure on an un-imported@@ -63,34 +96,35 @@ export interface SkillBundleDisclosure {* (`POST /api/skills/import-bulk`), which is the reason this exists rather than* the per-skill Install menu run N times.*/-export function SkillPluginBundleDialog({+export function SkillPluginBundleDialog(props: SkillPluginBundleDialogProps) {+ if (!props.bundle) return null;+ return <OpenSkillPluginBundleDialog {...props} bundle={props.bundle} />;+}++/** The open dialog is a child so closing fully resets picker state on remount. */+function OpenSkillPluginBundleDialog({bundle,source,defaultScope,+ installOverride,onInstalled,onOpenChange,-}: {- /** `null` keeps the dialog closed. */- bundle: SkillBundleDisclosure | null;- /** The import source the preview was opened with (repo, site, or skills.sh URL). */- source: string;- defaultScope: SkillScope;- /** Skills that landed, keyed BOTH by what was requested and by the on-disk- * name (they differ on a collision rename). The preview tab that hosts this- * banner uses it to stop showing a preview of a skill the user now owns. */- onInstalled?: (landed: ReadonlyMap<string, string>) => void;- onOpenChange: (open: boolean) => void;-}) {+ returnFocus,+}: SkillPluginBundleDialogProps & { bundle: SkillBundleDisclosure }) {const { t } = useLingui();const scopeId = useId();const scopeLabels = useSkillScopeLabels();- const [scope, setScope] = useState<SkillScope>(defaultScope);- const [selected, setSelected] = useState<ReadonlySet<string>>(new Set());+ const [scope, setScope] = useState<SkillScope>(installOverride?.scope ?? defaultScope);+ const [selected, setSelected] = useState<ReadonlySet<string>>(() =>+ installOverride ? new Set(bundle.names) : new Set(),+ );const [busy, setBusy] = useState(false);// Descriptions come from the same enumeration the Import picker uses. The// manifest's `bundledSkills` is the fallback: names alone still install, and a// flaked discover shouldn't empty the list.- const [described, setDescribed] = useState<ReadonlyMap<string, string | null>>(new Map());+ const [described, setDescribed] = useState<ReadonlyMap<string, string | null>>(+ () => new Map(Object.entries(bundle.descriptions ?? {})),+ );// Which agents the selection is projected into. Seeded from the project's// configured targets — the set the server would have auto-projected into —// so the common case is one click, and any other set is a deliberate change.@@ -101,21 +135,17 @@ export function SkillPluginBundleDialog({const effectiveEditors: ReadonlySet<SkillTargetEditor> =editors ?? new Set(configuredTargets ?? []);- const open = bundle !== null;+ const usesInstallOverride = installOverride !== undefined;useEffect(() => {- if (!open) return;- setSelected(new Set());- setEditors(null);- setScope(defaultScope);+ if (usesInstallOverride) return;const ctrl = new AbortController();void discoverSkillsInSource(source, ctrl.signal).then((res) => {if (ctrl.signal.aborted || !res.ok) return;setDescribed(new Map(res.skills.map((s) => [s.name, s.description])));});return () => ctrl.abort();- }, [open, source, defaultScope]);+ }, [source, usesInstallOverride]);- if (!bundle) return null;const { plugin, names } = bundle;const allSelected = selected.size === names.length && names.length > 0;@@ -128,6 +158,14 @@ export function SkillPluginBundleDialog({async function install() {setBusy(true);+ if (installOverride) {+ const landed = await installOverride.installSelected([...selected]);+ setBusy(false);+ if (landed === null) return;+ if (landed.size > 0) onInstalled?.(landed);+ onOpenChange(false);+ return;+ }// Acquire with `install: false`, then project explicitly into the agents the// user ticked. Letting the server auto-project would silently install into// whatever it detects, which is the one thing a destination picker exists to@@ -196,12 +234,19 @@ export function SkillPluginBundleDialog({return (<Dialog- open={open}+ openonOpenChange={(next) => {if (!next && !busy) onOpenChange(false);}}>- <DialogContent className="sm:max-w-lg">+ <DialogContent+ className="sm:max-w-lg"+ onCloseAutoFocus={(event) => {+ if (!returnFocus) return;+ event.preventDefault();+ returnFocus();+ }}+ ><DialogHeader><DialogTitle>{plugin ? <Trans>Install from {plugin}</Trans> : <Trans>Install from {source}</Trans>}@@ -224,7 +269,11 @@ export function SkillPluginBundleDialog({<Label htmlFor={scopeId}><Trans>Level</Trans></Label>- <Select value={scope} onValueChange={(v) => setScope(v as SkillScope)}>+ <Select+ value={scope}+ disabled={busy || usesInstallOverride}+ onValueChange={(v) => setScope(v as SkillScope)}+ ><SelectTrigger id={scopeId} className="w-full"><SelectValue /></SelectTrigger>@@ -237,40 +286,44 @@ export function SkillPluginBundleDialog({</SelectContent></Select></div>- <div className="flex flex-col gap-2">- <Label>- <Trans>Install into</Trans>- </Label>- <div className="flex flex-wrap gap-x-4 gap-y-2">- {INSTALL_EDITORS.map((editor) => (- <Label- key={editor}- className="flex cursor-pointer items-center gap-2 text-sm font-normal"- >- <Checkbox- checked={effectiveEditors.has(editor)}- disabled={busy}- onCheckedChange={(checked) => {- const next = new Set(effectiveEditors);- if (checked === true) next.add(editor);- else next.delete(editor);- setEditors(next);- }}- />- {EDITOR_LABELS[editor] ?? editor}- </Label>- ))}+ {usesInstallOverride ? null : (+ <div className="flex flex-col gap-2">+ <Label>+ <Trans>Install into</Trans>+ </Label>+ <div className="flex flex-wrap gap-x-4 gap-y-2">+ {INSTALL_EDITORS.map((editor) => (+ <Label+ key={editor}+ className="flex cursor-pointer items-center gap-2 text-sm font-normal"+ >+ <Checkbox+ checked={effectiveEditors.has(editor)}+ disabled={busy}+ onCheckedChange={(checked) => {+ const next = new Set(effectiveEditors);+ if (checked === true) next.add(editor);+ else next.delete(editor);+ setEditors(next);+ }}+ />+ {EDITOR_LABELS[editor] ?? editor}+ </Label>+ ))}+ </div>+ {effectiveEditors.size === 0 ? (+ // Not an error: the skills still land as project skills you can+ // install later. Say so, so an empty set doesn't read as a failure.+ <p className="text-1sm text-muted-foreground">+ <Trans>+ No agents selected — the skills are saved but not installed anywhere.+ </Trans>+ </p>+ ) : null}</div>- {effectiveEditors.size === 0 ? (- // Not an error: the skills still land as project skills you can- // install later. Say so, so an empty set doesn't read as a failure.- <p className="text-1sm text-muted-foreground">- <Trans>No agents selected — the skills are saved but not installed anywhere.</Trans>- </p>- ) : null}- </div>+ )}<div className="flex items-center justify-between">- <p className="font-medium text-xs font-mono text-muted-foreground/80 uppercase tracking-wider">+ <p className="font-medium text-xs font-mono text-foreground/70 uppercase tracking-wider"><Trans>{selected.size} of {names.length} selected</Trans>@@ -323,6 +376,8 @@ export function SkillPluginBundleDialog({<Trans>Cancel</Trans></Button><Button+ variant="secondary"+ className="font-mono uppercase"data-testid="plugin-bundle-install"disabled={busy || selected.size === 0}onClick={() => void install()}diff --git a/packages/app/src/components/TimelinePanel.test.ts b/packages/app/src/components/TimelinePanel.test.tsindex 646bd3ba5..6eee38749 100644--- a/packages/app/src/components/TimelinePanel.test.ts+++ b/packages/app/src/components/TimelinePanel.test.ts@@ -8,7 +8,7 @@import type { TimelineEntry } from '@inkeep/open-knowledge-core';import { describe, expect, test } from 'vitest';-import { allSummariesFor } from './TimelinePanel.tsx';+import { allSummariesFor, contributorIconKind } from './TimelinePanel.tsx';function baseEntry(overrides: Partial<TimelineEntry>): TimelineEntry {return {@@ -82,3 +82,36 @@ describe('allSummariesFor (flat shape)', () => {).toEqual(['Cleaned up']);});});++describe('contributorIconKind', () => {+ // The list the server can write for a classified (non-session) writer. The+ // app cannot import the server's `WriterIdentity` constants, so this is the+ // hand-kept mirror — adding a system writer means adding it here.+ const SYSTEM_WRITER_NAMES = [+ 'File System',+ 'Git (upstream)',+ 'OpenKnowledge (service)',+ 'OpenKnowledge (generated)',+ ];++ test('no system writer renders as a person', () => {+ // The property that matters, stated once over the whole set. A writer that+ // falls through gets a human icon beside content no human wrote, and+ // nothing else in the UI would flag it.+ for (const name of SYSTEM_WRITER_NAMES) {+ expect(contributorIconKind(name)).not.toBe('person');+ }+ });++ test('the generated writer gets its own icon family, distinct from the service writer', () => {+ // Both are OK itself, but they mean different things: one authored a+ // document, the other flushed something nobody claimed.+ expect(contributorIconKind('OpenKnowledge (generated)')).toBe('generated');+ expect(contributorIconKind('OpenKnowledge (service)')).toBe('upstream');+ });++ test('a human or unknown contributor still falls back to a person', () => {+ expect(contributorIconKind('Serafin Garcia')).toBe('person');+ expect(contributorIconKind('')).toBe('person');+ });+});diff --git a/packages/app/src/components/TimelinePanel.tsx b/packages/app/src/components/TimelinePanel.tsxindex c7aceb274..992054e79 100644--- a/packages/app/src/components/TimelinePanel.tsx+++ b/packages/app/src/components/TimelinePanel.tsx@@ -38,6 +38,7 @@ import {iconFromClientName,isSurfacedCheckpointKind,ProblemDetailsSchema,+ SYSTEM_WRITER_DISPLAY_NAMES,type TimelineEntry,} from '@inkeep/open-knowledge-core';import { plural, t } from '@lingui/core/macro';@@ -231,6 +232,29 @@ function displayAuthor(entry: TimelineEntry): string {return entry.author;}+/**+ * Which icon family a contributor's display name belongs to.+ *+ * Split out from rendering because the interesting property is a NEGATIVE one:+ * no system writer may reach `person`. A writer that falls through shows a human+ * icon beside content no human wrote, which is the confusion the classified+ * writer ids exist to prevent — and it fails silently, since the fallback+ * renders perfectly well.+ *+ * Names come from `SYSTEM_WRITER_DISPLAY_NAMES` — the same constants the server+ * writes into commits — so adding a system writer cannot leave this matching on+ * a string that no longer exists.+ */+export function contributorIconKind(+ name: string,+): 'file-system' | 'upstream' | 'generated' | 'person' {+ const names = SYSTEM_WRITER_DISPLAY_NAMES;+ if (name === names.fileSystem) return 'file-system';+ if (name === names.service || name === names.gitUpstream) return 'upstream';+ if (name === names.generator) return 'generated';+ return 'person';+}+/** Icon for a timeline entry contributor. Brand icons for agents, lucide icons for system writers. */function ContributorIcon({ entry, isDark }: { entry: TimelineEntry; isDark: boolean }) {const iconClass = 'size-3.5 shrink-0 text-muted-foreground';@@ -254,14 +278,16 @@ function ContributorIcon({ entry, isDark }: { entry: TimelineEntry; isDark: bool);}- // Classified system writers- if (c.name === 'File System') return <HardDrive className={iconClass} />;- if (c.name === 'OpenKnowledge (service)' || c.name === 'Git (upstream)') {- return <ArrowDownToLine className={iconClass} />;+ switch (contributorIconKind(c.name)) {+ case 'file-system':+ return <HardDrive className={iconClass} />;+ case 'upstream':+ return <ArrowDownToLine className={iconClass} />;+ case 'generated':+ return <Sparkles className={iconClass} />;+ default:+ return <User className={iconClass} />;}-- // Human or unknown contributor- return <User className={iconClass} />;}// Pre-attribution fallbackdiff --git a/packages/app/src/components/settings/LintingSection.dom.test.tsx b/packages/app/src/components/settings/LintingSection.dom.test.tsxindex fe09ee58e..2dd9113d6 100644--- a/packages/app/src/components/settings/LintingSection.dom.test.tsx+++ b/packages/app/src/components/settings/LintingSection.dom.test.tsx@@ -5,11 +5,18 @@* editor's write calls + gated visibility of controls.*/-import type { Config, ConfigBinding } from '@inkeep/open-knowledge-core';-import { cleanup, render, screen, within } from '@testing-library/react';+import {+ type Config,+ type ConfigBinding,+ OKF_RULE_GROUPS,+ OKF_RULE_IDS,+ type SkillsListEntry,+} from '@inkeep/open-knowledge-core';+import { cleanup, render, screen, waitFor, within } from '@testing-library/react';import userEvent from '@testing-library/user-event';import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';import { TooltipProvider } from '@/components/ui/tooltip';+import { LINT_PLUGIN_META } from './lint-plugin-meta';import { describedTextOf } from './settings-a11y.test-helper';// Radix primitives reach for DOM globals the jsdom preload doesn't expose;@@ -37,6 +44,69 @@ let mockProjectConfig: Config | null = null;let mockUserConfig: Config | null = null;let mockProjectSynced = true;let mockProjectBinding: ConfigBinding | null = null;+const generatedIndexApiCalls: boolean[] = [];+let mockGeneratedIndexActive: boolean | null = null;+/** Drives `git.state` in the settings response; null keeps the healthy default. */+let mockGeneratedIndexGitState:+ | 'not-applicable'+ | 'ready'+ | 'missing'+ | 'conflict'+ | 'unavailable'+ | null = null;+/** Drives the POST outcome; null keeps the applied-cleanly default. */+let mockGeneratedIndexApplyResult: {+ applied: boolean;+ reason?: 'git-conflict' | 'git-unavailable' | 'config-write';+} | null = null;+/** Makes the settings fetch reject, which is the notice's `connection` path. */+let mockGeneratedIndexFetchRejects = false;+let mockSkillsState:+ | { status: 'idle' | 'loading' }+ | { status: 'ready'; data: readonly SkillsListEntry[] }+ | { status: 'error'; message: string } = { status: 'ready', data: [] };+const installPackSkillCalls: string[] = [];+const openSkillCalls: Array<[string, string]> = [];+let installPackSkillResult:+ | { ok: true; skills: Array<{ name: string; created: boolean }>; installedHosts: string[] }+ | { ok: false; error: string } = {+ ok: true,+ skills: [{ name: 'okf-knowledge-base', created: true }],+ installedHosts: ['Claude Code'],+};++function configuredGeneratedIndexEnabled(): boolean {+ return mockProjectConfig?.contentRules?.okf?.generate?.index === true;+}++async function generatedIndexFetch(input: string | URL | Request, init?: RequestInit) {+ const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;+ if (url !== '/api/generated-index/settings') throw new TypeError(`unmocked fetch: ${url}`);+ if (mockGeneratedIndexFetchRejects) throw new TypeError('Failed to fetch');++ const requested =+ init?.method === 'POST'+ ? (JSON.parse(String(init.body)) as { enabled: boolean }).enabled+ : configuredGeneratedIndexEnabled();+ if (init?.method === 'POST') generatedIndexApiCalls.push(requested);+ const applyResult =+ init?.method === 'POST' ? (mockGeneratedIndexApplyResult ?? { applied: true }) : {};+ // The server reports `enabled` by re-reading config, so a POST that did not+ // apply reports the value that is still on disk, not the one asked for.+ const effectiveEnabled =+ 'applied' in applyResult && applyResult.applied === false+ ? configuredGeneratedIndexEnabled()+ : requested;+ return new Response(+ JSON.stringify({+ enabled: effectiveEnabled,+ active: mockGeneratedIndexActive ?? effectiveEnabled,+ git: { state: mockGeneratedIndexGitState ?? 'not-applicable' },+ ...applyResult,+ }),+ { status: 200, headers: { 'content-type': 'application/json' } },+ );+}vi.doMock('@/lib/config-provider', () => ({useConfigContext: () => ({@@ -90,6 +160,23 @@ vi.doMock('@/editor/lint-config-client', () => ({},}));+vi.doMock('@/hooks/use-skills', () => ({+ useSkills: () => mockSkillsState,+}));++vi.doMock('@/hooks/use-open-skill', () => ({+ useOpenSkill: () => (scope: string, name: string) => {+ openSkillCalls.push([scope, name]);+ },+}));++vi.doMock('@/lib/skills-api', () => ({+ installPackSkill: async (packId: string) => {+ installPackSkillCalls.push(packId);+ return installPackSkillResult;+ },+}));+// The enable notice is a toast; capture it instead of rendering a Toaster so the// action's deep-link target is assertable without sonner's portal + timers.interface ToastOptions {@@ -102,26 +189,36 @@ interface CapturedToast extends ToastOptions {message: string;}const successToasts: CapturedToast[] = [];+const errorToasts: string[] = [];vi.doMock('sonner', () => ({toast: {success: (message: string, options?: ToastOptions) => {successToasts.push({ message, ...options });},- error: () => {},+ error: (message: string) => {+ errorToasts.push(message);+ },},}));-const { ProjectPluginsManageSection, UserPluginsManageSection, MarkdownlintPluginSection } =- await import('./LintingSection');+const {+ ProjectPluginsManageSection,+ UserPluginsManageSection,+ MarkdownlintPluginSection,+ OkfPluginSection,+} = await import('./LintingSection');interface SliceOverrides {markdownlint?: Record<string, unknown>;+ /** Omitted entirely when absent, so the okf-off default stays representable. */+ okf?: Record<string, unknown>;}function configWith(linter: SliceOverrides): Config {return {contentRules: {markdownlint: { enabled: true, ...linter.markdownlint },+ ...(linter.okf === undefined ? {} : { okf: { enabled: true, ...linter.okf } }),},} as unknown as Config;}@@ -158,11 +255,27 @@ beforeEach(() => {mockProjectLintData = null;writeMarkdownlintRuleCalls.length = 0;successToasts.length = 0;+ generatedIndexApiCalls.length = 0;+ mockGeneratedIndexActive = null;+ mockGeneratedIndexGitState = null;+ mockGeneratedIndexApplyResult = null;+ mockGeneratedIndexFetchRejects = false;+ installPackSkillCalls.length = 0;+ openSkillCalls.length = 0;+ errorToasts.length = 0;+ mockSkillsState = { status: 'ready', data: [] };+ installPackSkillResult = {+ ok: true,+ skills: [{ name: 'okf-knowledge-base', created: true }],+ installedHosts: ['Claude Code'],+ };+ vi.stubGlobal('fetch', generatedIndexFetch);window.location.hash = '';});afterEach(() => {cleanup();+ vi.unstubAllGlobals();});describe('ProjectPluginsManageSection', () => {@@ -178,8 +291,20 @@ describe('ProjectPluginsManageSection', () => {expect(screen.getByTestId('settings-plugins-audit-pointer').textContent).toContain('Run a project audit from the Problems panel',);+ // Beta tags follow `LINT_PLUGIN_META.beta`, so this asserts the rendered+ // rows against that registry rather than a hardcoded plugin name — a+ // graduation flips one flag and this test moves with it. The negative half+ // is the point: a plugin without the flag must not show the tag.const list = screen.getByTestId('settings-plugins-list');- expect(within(list).queryByText('Beta')).toBeNull();+ const labelled = (badge: HTMLElement) => badge.closest('label')?.textContent ?? '';+ const tagged = within(list).getAllByText('Beta').map(labelled).sort();+ const expected = LINT_PLUGIN_META.filter((plugin) => plugin.beta).map((plugin) => plugin.label);+ expect(tagged).toHaveLength(expected.length);+ for (const label of expected) {+ expect(tagged.some((text) => text.includes(label))).toBe(true);+ }+ // markdownlint is GA — its row carries no tag.+ expect(tagged.some((text) => text.includes('markdownlint'))).toBe(false);});test('every plugin toggle is described by its own row description', () => {@@ -191,7 +316,7 @@ describe('ProjectPluginsManageSection', () => {mockProjectBinding = binding;render(<ProjectPluginsManageSection />);- // Both plugins, because their descriptions come from separate branches of+ // Every plugin, because their descriptions come from separate branches of// PluginManageDescription and each carries the same screen-reader promise.expect(describedTextOf('settings-plugin-toggle-markdownlint')).toContain('Common markdown issues',@@ -199,6 +324,9 @@ describe('ProjectPluginsManageSection', () => {expect(describedTextOf('settings-plugin-toggle-frontmatter')).toContain('Validate document frontmatter',);+ expect(describedTextOf('settings-plugin-toggle-okf')).toBe(+ 'Keeps your knowledge base aligned with the Open Knowledge Format.',+ );});test('toggling a project plugin writes the per-plugin enabled patch', async () => {@@ -211,6 +339,30 @@ describe('ProjectPluginsManageSection', () => {});});+ test('renders the okf plugin row with an off toggle and a concise description', () => {+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ render(<ProjectPluginsManageSection />);+ const toggle = screen.getByTestId('settings-plugin-toggle-okf');+ // Off — okf is absent from the mock config's contentRules.+ expect(toggle.getAttribute('aria-checked')).toBe('false');+ // The row states the plugin's user-facing purpose without implementation detail.+ const row = toggle.closest('div');+ expect(row?.textContent).toContain(+ 'Keeps your knowledge base aligned with the Open Knowledge Format.',+ );+ });++ test('toggling the okf plugin writes its enabled patch', async () => {+ const { binding, calls } = makeBinding();+ mockProjectBinding = binding;+ render(<ProjectPluginsManageSection />);+ await userEvent.click(screen.getByTestId('settings-plugin-toggle-okf'));+ expect(calls).toContainEqual({+ contentRules: { okf: { enabled: true } },+ });+ });+test('enabling a plugin offers its settings panel, and the offer deep-links there', async () => {// The gap this closes: enabling happens here, but the plugin is configured// on its own page — which can sit scrolled off screen in the sidebar.@@ -415,3 +567,368 @@ describe('MarkdownlintPluginSection', () => {expect(rules.textContent).toContain('governs linting');});});++// The panel is a per-rule config surface: identity header plus one switch per+// registered OKF rule. The plugin's own on/off toggle lives on the manage page+// above, and the sidebar only offers this panel once the plugin is on — so there+// is no parent-disabled state to pin here.+describe('OkfPluginSection', () => {+ function renderPanel() {+ render(+ <TooltipProvider>+ <OkfPluginSection />+ </TooltipProvider>,+ );+ }++ async function generatedIndexToggle(): Promise<HTMLButtonElement> {+ const toggle = screen.getByTestId('settings-okf-generate-index') as HTMLButtonElement;+ await waitFor(() => expect(toggle.disabled).toBe(false));+ return toggle;+ }++ test('renders the okf plugin panel with its identity header and concise description', () => {+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ renderPanel();+ const panel = screen.getByTestId('settings-plugin-okf');+ expect(panel).toBeDefined();+ expect(within(panel).getByText('OKF')).toBeDefined();+ // okf is a project-scope plugin — the header carries a Project badge.+ expect(screen.getByTestId('settings-scope-badge-project')).toBeDefined();+ expect(screen.queryByTestId('settings-scope-badge-user')).toBeNull();+ expect(panel.textContent).toContain(+ 'Keeps your knowledge base aligned with the Open Knowledge Format.',+ );+ });++ test('the header carries the Beta tag and a link to the plugin docs', () => {+ // The manage row and this header are separate render sites; a badge on the+ // row says nothing about whether the panel someone actually configures the+ // plugin in shows its maturity.+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ renderPanel();+ const panel = screen.getByTestId('settings-plugin-okf');+ expect(within(panel).getByText('Beta')).toBeDefined();+ const docsLink = screen.getByTestId('settings-plugin-okf-title-docs-link');+ expect(docsLink.getAttribute('href')).toBe(+ LINT_PLUGIN_META.find((plugin) => plugin.id === 'okf')?.docUrl,+ );+ });++ test('offers the declared OKF agent skill as an explicit install', () => {+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ renderPanel();++ const card = screen.getByTestId('settings-okf-recommended-skill');+ expect(screen.getByRole('heading', { name: 'Recommended agent skill' })).toBeDefined();+ expect(card.textContent).toContain('Open Knowledge Format guidance');+ expect(within(card).getByRole('button', { name: 'Install skill' })).toBeDefined();+ });++ test('reuses the skill-bundle picker before installing the OKF skill', async () => {+ const user = userEvent.setup();+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ renderPanel();++ await user.click(screen.getByRole('button', { name: 'Install skill' }));+ const dialog = await screen.findByRole('dialog', { name: 'Install from OKF' });+ expect(within(dialog).getByTestId('plugin-bundle-install')).toBeDefined();+ expect(within(dialog).getByText('Project')).toBeDefined();+ expect(dialog.textContent).not.toContain('Install into');+ expect(dialog.textContent).toContain('okf-knowledge-base');+ expect(installPackSkillCalls).toEqual([]);++ await user.click(within(dialog).getByRole('button', { name: 'Install selected' }));++ await waitFor(() => expect(installPackSkillCalls).toEqual(['okf']));+ expect(successToasts.at(-1)?.message).toContain('OKF agent skill installed');+ expect(screen.getByTestId('settings-okf-recommended-skill').textContent).toContain('Installed');+ });++ test('recognizes a same-name project skill without claiming or overwriting it', async () => {+ const user = userEvent.setup();+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ mockSkillsState = {+ status: 'ready',+ data: [+ {+ name: 'okf-knowledge-base',+ description: 'Team-authored OKF conventions',+ scope: 'project',+ path: '.agents/skills/okf-knowledge-base/SKILL.md',+ installed: true,+ hosts: ['agents'],+ },+ ],+ };+ renderPanel();++ const card = screen.getByTestId('settings-okf-recommended-skill');+ expect(card.textContent).toContain('Already in project');+ expect(within(card).queryByRole('button', { name: 'Install skill' })).toBeNull();+ await user.click(within(card).getByRole('button', { name: 'Open skill' }));+ expect(openSkillCalls).toEqual([['project', 'okf-knowledge-base']]);+ expect(installPackSkillCalls).toEqual([]);+ });++ test('surfaces install failure and leaves the action available', async () => {+ const user = userEvent.setup();+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ installPackSkillResult = { ok: false, error: 'Skill source could not be authored.' };+ renderPanel();++ await user.click(screen.getByRole('button', { name: 'Install skill' }));+ await user.click(+ within(await screen.findByRole('dialog')).getByRole('button', { name: 'Install selected' }),+ );++ await waitFor(() => expect(errorToasts).toContain('Skill source could not be authored.'));+ expect(screen.getByTestId('settings-okf-recommended-skill').textContent).not.toContain(+ 'Installed',+ );++ await user.click(within(screen.getByRole('dialog')).getByRole('button', { name: 'Cancel' }));+ await waitFor(() =>+ expect(document.activeElement).toBe(screen.getByRole('button', { name: 'Install skill' })),+ );+ expect(screen.getByRole('button', { name: 'Install skill' })).toBeDefined();+ });++ test('renders a switch per registered rule, all on when config says nothing', () => {+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ renderPanel();+ const list = screen.getByTestId('settings-okf-rules-list');+ // Every registered rule is addressable — not a hardcoded subset.+ for (const id of OKF_RULE_IDS) {+ const toggle = within(list).getByTestId(`settings-okf-rule-toggle-${id}`);+ // Absent from config = on. This is the load-bearing default.+ expect(toggle.getAttribute('aria-checked')).toBe('true');+ }+ expect(screen.getByTestId('settings-plugin-okf').textContent).toContain(+ `${OKF_RULE_IDS.length}/${OKF_RULE_IDS.length} on`,+ );+ });++ test('rules render inside their declared group, and every rule is reachable through one', () => {+ // The groups are the only structure a reader has for deciding what to+ // silence — a rule rendered outside its group, or a group that quietly+ // swallowed another's rules, is invisible to the per-id assertions above.+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ renderPanel();++ const seen: string[] = [];+ for (const group of OKF_RULE_GROUPS) {+ const block = screen.getByTestId(`settings-okf-rule-group-${group.id}`);+ for (const id of group.ids) {+ expect(within(block).getByTestId(`settings-okf-rule-toggle-${id}`)).toBeDefined();+ seen.push(id);+ }+ // Each rule in the group carries its own sentence, not a bare id.+ expect(block.textContent?.length ?? 0).toBeGreaterThan(group.ids.join('').length);+ }+ // No rule is orphaned outside a group, and none is rendered twice.+ expect([...seen].sort()).toEqual([...OKF_RULE_IDS].sort());+ expect(new Set(seen).size).toBe(seen.length);+ });++ test('a rule set to false in config renders off, its siblings stay on', () => {+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ mockProjectConfig = configWith({ okf: { rules: { 'no-wiki-links': false } } });+ renderPanel();+ expect(+ screen.getByTestId('settings-okf-rule-toggle-no-wiki-links').getAttribute('aria-checked'),+ ).toBe('false');+ expect(+ screen.getByTestId('settings-okf-rule-toggle-index-shape').getAttribute('aria-checked'),+ ).toBe('true');+ expect(screen.getByTestId('settings-plugin-okf').textContent).toContain(+ `${OKF_RULE_IDS.length - 1}/${OKF_RULE_IDS.length} on`,+ );+ });++ // These assert only the patch SHAPE the pane emits. What that shape does to the+ // document is pinned by core's config-patch tests — a payload assertion alone+ // once passed while re-enabling was silently impossible.+ test('turning a rule off sends that rule as false', async () => {+ const { binding, calls } = makeBinding();+ mockProjectBinding = binding;+ mockProjectConfig = configWith({ okf: { rules: { 'log-shape': false } } });+ renderPanel();+ await userEvent.click(screen.getByTestId('settings-okf-rule-toggle-index-shape'));+ // Only the touched key is sent: the walker leaves unmentioned keys alone, so+ // an already-disabled sibling needs no re-sending to survive.+ expect(calls).toContainEqual({+ contentRules: { okf: { rules: { 'index-shape': false } } },+ });+ });++ test('turning a rule back on sends null, which deletes the key', async () => {+ const { binding, calls } = makeBinding();+ mockProjectBinding = binding;+ mockProjectConfig = configWith({ okf: { rules: { 'index-shape': false } } });+ renderPanel();+ await userEvent.click(screen.getByTestId('settings-okf-rule-toggle-index-shape'));+ // `null` is the walker's delete signal. Omitting the key means "leave alone",+ // which would strand the rule in the off state with no way back.+ expect(calls).toContainEqual({+ contentRules: { okf: { rules: { 'index-shape': null } } },+ });+ });++ test('rule switches are disabled until the config binding is ready', () => {+ mockProjectBinding = null;+ mockProjectSynced = false;+ renderPanel();+ const toggle = screen.getByTestId('settings-okf-rule-toggle-index-shape') as HTMLButtonElement;+ expect(toggle.disabled).toBe(true);+ });++ test('enabling generation asks for confirmation before writing any file', async () => {+ const user = userEvent.setup();+ const { binding, calls } = makeBinding();+ mockProjectBinding = binding;+ mockProjectConfig = configWith({ okf: {} });+ renderPanel();++ await user.click(await generatedIndexToggle());++ const dialog = await screen.findByRole('dialog', {+ name: 'Maintain generated indexes in every folder?',+ });+ expect(dialog.textContent).toContain('index.md');+ expect(dialog.textContent).toContain('.gitattributes');+ expect(dialog.textContent).toMatch(/every folder/i);+ expect(dialog.querySelector('[data-slot="dialog-body"]')).not.toBeNull();+ const note = within(dialog).getByRole('note');+ expect(note.textContent).toContain('Heads up');+ expect(note.textContent).toContain('Generated files');+ expect(note.textContent).toContain('Git merge rule');+ expect(note.textContent).toContain('Turning it off');+ expect(within(dialog).getByRole('button', { name: 'Cancel' })).toBeDefined();+ expect(within(dialog).getByRole('button', { name: 'Enable indexes' })).toBeDefined();+ expect(calls).toEqual([]);+ expect(generatedIndexApiCalls).toEqual([]);+ expect(screen.getByTestId('settings-okf-generate-index').getAttribute('aria-checked')).toBe(+ 'false',+ );+ });++ test('declining the confirmation leaves generation off and writes nothing', async () => {+ const user = userEvent.setup();+ const { binding, calls } = makeBinding();+ mockProjectBinding = binding;+ mockProjectConfig = configWith({ okf: {} });+ renderPanel();++ await user.click(await generatedIndexToggle());+ await screen.findByRole('dialog');+ await user.click(screen.getByRole('button', { name: 'Cancel' }));++ expect(calls).toEqual([]);+ expect(generatedIndexApiCalls).toEqual([]);+ expect(screen.getByTestId('settings-okf-generate-index').getAttribute('aria-checked')).toBe(+ 'false',+ );+ });++ test('confirming the disclosure coordinates enablement through the settings endpoint', async () => {+ const user = userEvent.setup();+ const { binding, calls } = makeBinding();+ mockProjectBinding = binding;+ mockProjectConfig = configWith({ okf: {} });+ renderPanel();++ await user.click(await generatedIndexToggle());+ await screen.findByRole('dialog');+ await user.click(screen.getByTestId('settings-okf-generate-index-confirm-accept'));++ await waitFor(() => expect(generatedIndexApiCalls).toEqual([true]));+ expect(calls).toEqual([]);+ });++ test('disabling generation uses the settings endpoint with no confirmation or index removal', async () => {+ const user = userEvent.setup();+ const { binding, calls } = makeBinding();+ mockProjectBinding = binding;+ mockProjectConfig = configWith({ okf: { generate: { index: true } } });+ renderPanel();++ await user.click(await generatedIndexToggle());++ expect(screen.queryByRole('dialog')).toBeNull();+ await waitFor(() => expect(generatedIndexApiCalls).toEqual([false]));+ expect(calls).toEqual([]);+ });++ test('an enabled setting stays on and can be disabled when Git admission degrades', async () => {+ const user = userEvent.setup();+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ mockProjectConfig = configWith({ okf: { generate: { index: true } } });+ mockGeneratedIndexActive = false;+ renderPanel();++ const toggle = await generatedIndexToggle();+ expect(toggle.getAttribute('aria-checked')).toBe('true');+ await user.click(toggle);++ expect(screen.queryByRole('dialog')).toBeNull();+ await waitFor(() => expect(generatedIndexApiCalls).toEqual([false]));+ });++ // The notice has four branches. The Git-conflict one is covered end-to-end in+ // okf-generated-index-settings.e2e.ts against a real .gitattributes; the three+ // below need a server response the E2E cannot stage, so they are pinned here.+ test('a config that could not be saved says so rather than reporting generation on', async () => {+ const user = userEvent.setup();+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ mockProjectConfig = configWith({ okf: {} });+ mockGeneratedIndexApplyResult = { applied: false, reason: 'config-write' };+ renderPanel();++ await user.click(await generatedIndexToggle());+ await screen.findByRole('dialog');+ await user.click(screen.getByTestId('settings-okf-generate-index-confirm-accept'));++ const notice = await screen.findByTestId('settings-okf-generate-index-status');+ expect(notice.textContent).toContain('the project setting could not be saved');+ expect(screen.getByTestId('settings-okf-generate-index').getAttribute('aria-checked')).toBe(+ 'false',+ );+ });++ test('an unreachable project server reads as a connection problem, not a silent no-op', async () => {+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ mockProjectConfig = configWith({ okf: {} });+ mockGeneratedIndexFetchRejects = true;+ renderPanel();++ const notice = await screen.findByTestId('settings-okf-generate-index-status');+ expect(notice.textContent).toContain('could not reach the project server');+ });++ test('an unconfirmable Git merge rule pauses generation and names Git as the cause', async () => {+ const { binding } = makeBinding();+ mockProjectBinding = binding;+ mockProjectConfig = configWith({ okf: { generate: { index: true } } });+ mockGeneratedIndexGitState = 'unavailable';+ mockGeneratedIndexActive = false;+ renderPanel();++ const notice = await screen.findByTestId('settings-okf-generate-index-status');+ expect(notice.textContent).toContain('could not confirm the required Git merge rule');+ // Distinct from the conflict branch, which blames a competing attribute.+ expect(notice.textContent).not.toContain('another Git attribute');+ });+});diff --git a/packages/app/src/components/settings/LintingSection.tsx b/packages/app/src/components/settings/LintingSection.tsxindex 0ede8d5b3..9af4c875f 100644--- a/packages/app/src/components/settings/LintingSection.tsx+++ b/packages/app/src/components/settings/LintingSection.tsx@@ -8,30 +8,67 @@* (per-plugin on/off, one manage page per scope) and `MarkdownlintPluginSection`* (the full-catalog rule browser — see `markdownlint-rule-browser.tsx`).*/-// biome-ignore-all lint/plugin/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/biome-plugins/README.md#no-physical-direction-utilitygrit-import {type AppliesToPatternSummary,+ assertNeverOkfRuleGroupId,+ assertNeverOkfRuleId,type ConfigBinding,type ConfigPatch,type FrontmatterSchemaMapping,findZeroMatchAppliesToPatterns,humanFormat,isFrontmatterSchemaAsset,+ isOkfRuleEnabled,type LintPluginId,+ OKF_RULE_GROUPS,+ OKF_RULE_IDS,+ type OkfRuleGroupId,+ type OkfRuleId,+ OPENKNOWLEDGE_SKILLS_REPO,summarizeAppliesTo,} from '@inkeep/open-knowledge-core';import { Plural, Trans, useLingui } from '@lingui/react/macro';-import { ArrowUpRight, Plus, SquarePen, Trash2 } from 'lucide-react';-import { useState } from 'react';+import {+ ArrowUpRight,+ CircleAlert,+ FileText,+ GitMerge,+ Plus,+ Power,+ SquarePen,+ Trash2,+} from 'lucide-react';+import { useRef, useState } from 'react';import { toast } from 'sonner';import { DeleteConfirmationDialog } from '@/components/DeleteConfirmationDialog';+import { DisclosureWarning, DisclosureWarningItem } from '@/components/DisclosureWarning';import { useOptionalPageList } from '@/components/PageListContext';+import { SkillPluginBundleDialog } from '@/components/SkillPluginBundleDialog';import { AlertDialog } from '@/components/ui/alert-dialog';+import { Badge } from '@/components/ui/badge';import { Button } from '@/components/ui/button';+import {+ Card,+ CardAction,+ CardDescription,+ CardFooter,+ CardHeader,+ CardTitle,+} from '@/components/ui/card';+import {+ Dialog,+ DialogBody,+ DialogClose,+ DialogContent,+ DialogDescription,+ DialogFooter,+ DialogHeader,+ DialogTitle,+} from '@/components/ui/dialog';import { Input } from '@/components/ui/input';import { Label } from '@/components/ui/label';import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';+import { Spinner } from '@/components/ui/spinner';import { Switch } from '@/components/ui/switch';import { TagPillInput } from '@/components/ui/tag-pill-input';import {@@ -41,10 +78,17 @@ import {useFrontmatterSchemaFiles,useProjectLintConfig,} from '@/editor/lint-config-client';+import {+ type GeneratedIndexSettingsIssue,+ useGeneratedIndexSettings,+} from '@/hooks/use-generated-index-settings';+import { useOpenSkill } from '@/hooks/use-open-skill';+import { useSkills } from '@/hooks/use-skills';import { useConfigContext } from '@/lib/config-provider';import { hashFromAssetPath } from '@/lib/doc-hash';import { dispatchExternalLinkClick } from '@/lib/external-link';import { requestSchemaFieldsView } from '@/lib/schema-fields-view-intent';+import { installPackSkill } from '@/lib/skills-api';import { countMatchingDocs } from './applies-to-folder-globs';import { AppliesToFolderPicker } from './applies-to-folder-picker';import { indexGlobProblemsByFile, parseAppliesToGlobProblem } from './applies-to-glob-problems';@@ -96,6 +140,8 @@ function PluginManageDescription({ id }: { id: LintPluginId }) {Validate document frontmatter against JSON Schema files, scoped to doc sets by glob.</Trans>);+ case 'okf':+ return <Trans>Keeps your knowledge base aligned with the Open Knowledge Format.</Trans>;}}@@ -140,8 +186,9 @@ export function ProjectPluginsManageSection() {className="inline-flex items-center gap-1.5 text-sm font-medium">{plugin.label}+ {plugin.beta ? <PluginBetaBadge /> : null}</Label>- <p id={descriptionId} className="text-1sm text-muted-foreground">+ <p id={descriptionId} className="text-sm text-muted-foreground"><PluginManageDescription id={plugin.id} /></p></div>@@ -286,6 +333,11 @@ function pluginDocUrl(id: LintPluginId): string | undefined {return LINT_PLUGIN_META.find((plugin) => plugin.id === id)?.docUrl;}+/** Whether one plugin carries the Beta tag — read from the same registry the row does. */+function pluginIsBeta(id: LintPluginId): boolean {+ return LINT_PLUGIN_META.find((plugin) => plugin.id === id)?.beta === true;+}+/** markdownlint plugin: the full-catalog rule browser. */export function MarkdownlintPluginSection({initialRuleQuery,@@ -330,6 +382,559 @@ export function MarkdownlintPluginSection({);}+/**+ * What one OKF rule checks, in a sentence. Ids are untranslated identifiers (like+ * the plugin labels in `LINT_PLUGIN_META`); only the prose is translated — the+ * same split `PluginManageDescription` uses.+ */+function OkfRuleDescription({ id }: { id: OkfRuleId }) {+ switch (id) {+ case 'no-wiki-links':+ return (+ <Trans>+ Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves+ nothing and shows the brackets.+ </Trans>+ );+ case 'log-shape':+ return (+ <Trans>+ In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many+ titles you use, and whether entries are bullets, is up to you.+ </Trans>+ );+ case 'index-shape':+ return (+ <Trans>+ In an index document: entries sit under a section heading and each one carries a link.+ Prose around the lists is fine.+ </Trans>+ );+ case 'reserved-casing':+ return (+ <Trans>+ Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem,+ Index.md is read as an ordinary document and loses its meaning.+ </Trans>+ );+ case 'frontmatter-required':+ return (+ <Trans>+ Every concept document carries a non-empty type. This is the whole of OKF's conformance+ floor — a document with only a type is fully conformant.+ </Trans>+ );+ case 'frontmatter-recommended':+ return (+ <Trans>+ The shapes of title, description, resource, and tags when you use them. None are required;+ declaring one only pins its type, so tags written as a comma-separated string is flagged.+ </Trans>+ );+ case 'frontmatter-provenance':+ return (+ <Trans>+ The provenance, trust, and lifecycle families: sources, generated, verified, status, and+ stale_after. Every field is optional, and absence is never an error.+ </Trans>+ );+ case 'frontmatter-computation':+ return (+ <Trans>+ The attested-computation contract. Only applies to documents typed Attested Computation,+ where OKF requires a runtime; ordinary concepts are unaffected.+ </Trans>+ );+ case 'frontmatter-reserved-index':+ return (+ <Trans>+ Index documents carry no frontmatter, except the one at your knowledge base's root. Log+ documents are not covered — OKF does not constrain their frontmatter.+ </Trans>+ );+ case 'frontmatter-root-index':+ return (+ <Trans>+ On the root index, okf_version is written as a quoted string like "0.2". Unquoted, YAML+ reads it as a number and 0.10 silently becomes 0.1.+ </Trans>+ );+ case 'project-no-mdx':+ return (+ <Trans>+ Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and+ if a .md of the same name exists, reads that one instead.+ </Trans>+ );+ default:+ return assertNeverOkfRuleId(id);+ }+}++/** The heading for one group of OKF rules. */+function OkfGroupLabel({ id }: { id: OkfRuleGroupId }) {+ switch (id) {+ case 'structure':+ return <Trans>Document structure</Trans>;+ case 'frontmatter':+ return <Trans>Frontmatter</Trans>;+ case 'project':+ return <Trans>Project</Trans>;+ default:+ return assertNeverOkfRuleGroupId(id);+ }+}++/**+ * When a group's rules behave differently from the rest, say so under its heading.+ * Project rules compare files, so they cannot run against a single open document — a+ * reader watching the Problems panel while typing would otherwise read their silence+ * as a pass.+ */+function OkfGroupNote({ id }: { id: OkfRuleGroupId }) {+ if (id !== 'project') return null;+ return (+ <p className="text-sm text-muted-foreground">+ <Trans>+ This one needs to see your files, not just the open document, so it appears when you run a+ project audit rather than while you type.+ </Trans>+ </p>+ );+}++function OkfRecommendedSkillCard({ packId, name }: { packId: string; name: string }) {+ const { t } = useLingui();+ const skills = useSkills();+ const openSkill = useOpenSkill();+ const [dialogOpen, setDialogOpen] = useState(false);+ const [optimisticStatus, setOptimisticStatus] = useState<'installed' | 'existing' | null>(null);+ const installSkillTriggerRef = useRef<HTMLButtonElement>(null);+ const description = t`Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata.`;+ const entry =+ skills.status === 'ready'+ ? skills.data.find((skill) => skill.scope === 'project' && skill.name === name)+ : undefined;+ const status = entry+ ? entry.origin?.source === OPENKNOWLEDGE_SKILLS_REPO+ ? 'installed'+ : 'existing'+ : optimisticStatus;+ const checking = skills.status === 'idle' || skills.status === 'loading';++ async function installSelected(+ selected: readonly string[],+ ): Promise<ReadonlyMap<string, string> | null> {+ if (!selected.includes(name)) return new Map();+ const result = await installPackSkill(packId);+ if (!result.ok) {+ toast.error(result.error);+ return null;+ }+ const installed = result.skills.find((skill) => skill.name === name);+ const nextStatus = installed?.created === false ? 'existing' : 'installed';+ setOptimisticStatus(nextStatus);+ toast.success(+ nextStatus === 'installed' ? t`OKF agent skill installed` : t`Skill already in project`,+ );+ return new Map([[name, name]]);+ }++ return (+ <>+ <Card size="sm" data-testid="settings-okf-recommended-skill">+ <CardHeader>+ <CardTitle>+ <Trans>Open Knowledge Format guidance</Trans>+ </CardTitle>+ <CardDescription>{description}</CardDescription>+ {status === 'installed' ? (+ <CardAction>+ <Badge variant="secondary">+ <Trans>Installed</Trans>+ </Badge>+ </CardAction>+ ) : status === 'existing' ? (+ <CardAction>+ <Badge variant="outline">+ <Trans>Already in project</Trans>+ </Badge>+ </CardAction>+ ) : null}+ </CardHeader>+ <CardFooter className="justify-end gap-2">+ {status !== null ? (+ <Button+ type="button"+ variant="outline"+ size="sm"+ onClick={() => openSkill('project', name)}+ >+ <Trans>Open skill</Trans>+ </Button>+ ) : (+ <Button+ ref={installSkillTriggerRef}+ type="button"+ variant="secondary"+ size="sm"+ disabled={checking}+ onClick={() => setDialogOpen(true)}+ >+ {checking ? <Trans>Checking skill</Trans> : <Trans>Install skill</Trans>}+ </Button>+ )}+ </CardFooter>+ </Card>+ <SkillPluginBundleDialog+ bundle={+ dialogOpen+ ? { plugin: 'OKF', names: [name], descriptions: { [name]: description } }+ : null+ }+ source={OPENKNOWLEDGE_SKILLS_REPO}+ defaultScope="project"+ installOverride={{ scope: 'project', installSelected }}+ onOpenChange={setDialogOpen}+ returnFocus={() => installSkillTriggerRef.current?.focus()}+ />+ </>+ );+}++/**+ * OKF plugin panel: the per-rule on/off list. The plugin's own toggle lives on the+ * Plugins manage page — the sidebar only offers this panel once the plugin is on,+ * so nothing here needs a parent-disabled state.+ *+ * A rule is on unless config says `false`, so the absent case reads as enabled and+ * only deviations are written.+ */+export function OkfPluginSection() {+ const { t } = useLingui();+ const { contentRules, bindingReady, write } = useLinterConfig();+ const rules = contentRules?.okf?.rules;+ const enabledCount = OKF_RULE_IDS.filter((id) => isOkfRuleEnabled(rules, id)).length;+ // Opt-in, unlike the rules: this one writes a file, so absent reads as off.+ const generateIndex = contentRules?.okf?.generate?.index === true;+ const generatedIndexSettings = useGeneratedIndexSettings();+ const generateIndexEnabled = generatedIndexSettings.status?.enabled ?? generateIndex;+ const [confirmingGenerateIndex, setConfirmingGenerateIndex] = useState(false);+ const generateIndexTriggerRef = useRef<HTMLButtonElement>(null);+ const recommendedSkills =+ LINT_PLUGIN_META.find((plugin) => plugin.id === 'okf')?.recommendedSkills ?? [];++ function toggleGenerateIndex(next: boolean): void {+ if (next) {+ // The config write starts generation, so the disclosure must complete before+ // this controlled switch can move to its on state.+ setConfirmingGenerateIndex(true);+ return;+ }+ // This key has a schema default, so `false` is the concrete off state. Unlike+ // rule overrides, disabling never needs the patch walker's delete signal.+ void generatedIndexSettings.setEnabled(false);+ }++ async function confirmGenerateIndex(): Promise<void> {+ await generatedIndexSettings.setEnabled(true);+ setConfirmingGenerateIndex(false);+ }++ function toggleRule(id: OkfRuleId, next: boolean): void {+ // Re-enabling must send an explicit `null`, which the patch walker turns into+ // a `deleteIn`. OMITTING the key does NOT remove it: the walker treats+ // `undefined` as "leave alone" (deep-partial semantics), so a rule switched+ // off would stay off forever with no way back on from this pane.+ const rules: Partial<Record<OkfRuleId, boolean | null>> = {};+ rules[id] = next ? null : false;+ if (write({ okf: { rules } })) {+ emitLintConfigChanged();+ }+ }++ return (+ <section+ aria-labelledby="settings-plugin-okf-title"+ className="space-y-4"+ data-testid="settings-plugin-okf"+ >+ <PluginSectionHeader+ titleId="settings-plugin-okf-title"+ title="OKF"+ scope="project"+ beta={pluginIsBeta('okf')}+ docUrl={pluginDocUrl('okf')}+ >+ <Trans>Keeps your knowledge base aligned with the Open Knowledge Format.</Trans>+ </PluginSectionHeader>++ {recommendedSkills.length > 0 ? (+ <div className="flex flex-col gap-2" data-testid="settings-okf-recommended-skills">+ <h4 className="text-sm font-medium">+ <Trans>Recommended agent skill</Trans>+ </h4>+ {recommendedSkills.map((skill) => (+ <OkfRecommendedSkillCard key={skill.name} packId={skill.packId} name={skill.name} />+ ))}+ </div>+ ) : null}++ <div className="space-y-2" data-testid="settings-okf-generated-files">+ <h4 className="text-sm font-medium">+ <Trans>Generated files</Trans>+ </h4>+ <div className="flex items-center justify-between gap-3 rounded-md border px-3 py-2">+ <div className="min-w-0">+ <Label htmlFor="settings-okf-generate-index" className="text-sm font-medium">+ <Trans>Maintain index.md</Trans>+ </Label>+ {/* States ownership plainly, because this is the one setting here+ that writes to the user's tree rather than reporting on it. */}+ <p className="text-sm text-muted-foreground">+ <Trans>+ Open Knowledge maintains a navigation file named index.md in every folder that+ contains Markdown, each listing that folder's documents by type and linking to its+ subfolders. It rewrites these files as your documents change, and anything you edit+ into them yourself is replaced.+ </Trans>+ </p>+ <p className="mt-1 text-sm text-muted-foreground">+ <Trans>+ In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent+ index changes combine before the next rebuild.+ </Trans>+ </p>+ </div>+ <Switch+ ref={generateIndexTriggerRef}+ id="settings-okf-generate-index"+ checked={generateIndexEnabled}+ disabled={+ !bindingReady ||+ generatedIndexSettings.status === null ||+ generatedIndexSettings.pending+ }+ onCheckedChange={toggleGenerateIndex}+ aria-label={+ generateIndexEnabled ? t`Stop maintaining index.md` : t`Start maintaining index.md`+ }+ data-testid="settings-okf-generate-index"+ />+ </div>+ <GeneratedIndexSettingsNotice+ enabled={generatedIndexSettings.status?.enabled ?? generateIndex}+ gitState={generatedIndexSettings.status?.git.state}+ issue={generatedIndexSettings.issue}+ />+ <Dialog open={confirmingGenerateIndex} onOpenChange={setConfirmingGenerateIndex}>+ <DialogContent+ className="sm:max-w-lg"+ data-testid="settings-okf-generate-index-confirm"+ onCloseAutoFocus={(event) => {+ event.preventDefault();+ generateIndexTriggerRef.current?.focus();+ }}+ >+ <DialogHeader>+ <DialogTitle>+ <Trans>Maintain generated indexes in every folder?</Trans>+ </DialogTitle>+ <DialogDescription className="text-inherit">+ <Trans>+ Open Knowledge creates and maintains a navigation file named index.md in every+ folder that contains Markdown.+ </Trans>+ </DialogDescription>+ </DialogHeader>+ <DialogBody>+ <DisclosureWarning>+ <DisclosureWarningItem+ icon={+ <FileText+ aria-hidden="true"+ className="mt-0.5 size-4 shrink-0 text-muted-foreground"+ />+ }+ title={<Trans>Generated files</Trans>}+ body={+ <Trans>+ Open Knowledge rewrites these index.md files as documents change, so manual+ edits to them are replaced.+ </Trans>+ }+ />+ <DisclosureWarningItem+ icon={+ <GitMerge+ aria-hidden="true"+ className="mt-0.5 size-4 shrink-0 text-muted-foreground"+ />+ }+ title={<Trans>Git merge rule</Trans>}+ body={+ <Trans>+ In Git projects, Open Knowledge adds a scoped rule to the repository-root+ .gitattributes file so concurrent index changes combine.+ </Trans>+ }+ />+ <DisclosureWarningItem+ icon={+ <Power+ aria-hidden="true"+ className="mt-0.5 size-4 shrink-0 text-muted-foreground"+ />+ }+ title={<Trans>Turning it off</Trans>}+ body={+ <Trans>+ The index files stay in place. Open Knowledge removes only the Git rule it+ added.+ </Trans>+ }+ />+ </DisclosureWarning>+ </DialogBody>+ <DialogFooter>+ <DialogClose asChild>+ <Button variant="outline">+ <Trans>Cancel</Trans>+ </Button>+ </DialogClose>+ <Button+ variant="secondary"+ className="font-mono uppercase"+ onClick={() => void confirmGenerateIndex()}+ disabled={generatedIndexSettings.pending}+ data-testid="settings-okf-generate-index-confirm-accept"+ >+ {generatedIndexSettings.pending ? (+ <>+ <Spinner aria-hidden="true" />+ <Trans>Enabling index generation</Trans>+ </>+ ) : (+ <Trans>Enable indexes</Trans>+ )}+ </Button>+ </DialogFooter>+ </DialogContent>+ </Dialog>+ </div>++ <div className="flex items-center justify-between">+ <h4 className="text-sm font-medium">+ <Trans>Rules</Trans>+ </h4>+ <span className="text-xs text-muted-foreground">+ <Trans>+ {enabledCount}/{OKF_RULE_IDS.length} on+ </Trans>+ </span>+ </div>++ <div className="space-y-4" data-testid="settings-okf-rules-list">+ {OKF_RULE_GROUPS.map((group) => (+ <div+ key={group.id}+ className="space-y-2"+ data-testid={`settings-okf-rule-group-${group.id}`}+ >+ <h5 className="text-xs font-medium uppercase tracking-wide text-muted-foreground">+ <OkfGroupLabel id={group.id} />+ </h5>+ <OkfGroupNote id={group.id} />+ <div className="divide-y rounded-md border">+ {group.ids.map((id) => {+ const on = isOkfRuleEnabled(rules, id);+ return (+ <div key={id} className="flex items-center justify-between gap-3 px-3 py-2">+ <div className="min-w-0">+ <Label+ htmlFor={`settings-okf-rule-toggle-${id}`}+ className="text-sm font-medium"+ >+ {id}+ </Label>+ <p className="text-sm text-muted-foreground">+ <OkfRuleDescription id={id} />+ </p>+ </div>+ <Switch+ id={`settings-okf-rule-toggle-${id}`}+ checked={on}+ disabled={!bindingReady}+ onCheckedChange={(next) => toggleRule(id, next)}+ aria-label={on ? t`Disable ${id}` : t`Enable ${id}`}+ data-testid={`settings-okf-rule-toggle-${id}`}+ />+ </div>+ );+ })}+ </div>+ </div>+ ))}+ </div>+ </section>+ );+}++function GeneratedIndexSettingsNotice({+ enabled,+ gitState,+ issue,+}: {+ enabled: boolean;+ gitState?: 'not-applicable' | 'ready' | 'missing' | 'conflict' | 'unavailable';+ issue: GeneratedIndexSettingsIssue | null;+}) {+ const effectiveIssue =+ issue ??+ (enabled && gitState === 'conflict'+ ? 'git-conflict'+ : enabled && (gitState === 'missing' || gitState === 'unavailable')+ ? 'git-unavailable'+ : null);+ if (effectiveIssue === null) return null;++ return (+ <div+ role="status"+ className="flex gap-2 rounded-md border border-amber-500/40 bg-amber-500/10 px-3 py-2 text-sm"+ data-testid="settings-okf-generate-index-status"+ >+ <CircleAlert+ aria-hidden="true"+ className="mt-0.5 size-4 shrink-0 text-amber-700 dark:text-amber-300"+ />+ <p>+ {effectiveIssue === 'git-conflict' ? (+ <Trans>+ Index maintenance is paused because another Git attribute controls index.md. Update+ .gitattributes so the scoped index.md paths use merge=union, then try again.+ </Trans>+ ) : effectiveIssue === 'config-write' ? (+ <Trans>+ Index maintenance stayed off because the project setting could not be saved. Check the+ project file permissions, then try again.+ </Trans>+ ) : effectiveIssue === 'connection' ? (+ <Trans>+ Index maintenance stayed off because Open Knowledge could not reach the project server.+ Try again when the project reconnects.+ </Trans>+ ) : (+ <Trans>+ Index maintenance is paused because Open Knowledge could not confirm the required Git+ merge rule. Check Git and .gitattributes, then try again.+ </Trans>+ )}+ </p>+ </div>+ );+}+/** Normalize a mapping's authored appliesTo (string | string[] | absent) for the pill editor. */function appliesToList(appliesTo: FrontmatterSchemaMapping['appliesTo']): string[] {if (appliesTo === undefined) return [];@@ -445,7 +1050,7 @@ function AppliesToSummaryLine({}/>{zeroMatchBareNameAuthored ? (- <span className="ml-1 text-muted-foreground/60">+ <span className="ms-1 text-muted-foreground/60"><Trans>(a bare folder name needs /** after it to match what's inside)</Trans></span>) : null}@@ -531,7 +1136,7 @@ function SchemaFileRow({</div></div>{on ? (- <div className="mt-2 space-y-1 pl-1.5">+ <div className="mt-2 space-y-1 ps-1.5"><Label htmlFor={`frontmatter-schema-applies-${file}`} className="text-xs"><Trans>Applies to (globs — leading ! excludes; empty means every doc)</Trans></Label>@@ -714,6 +1319,7 @@ export function FrontmatterPluginSection() {<PluginSectionHeadertitleId="settings-plugin-frontmatter-title"title={t`Frontmatter schemas`}+ beta={pluginIsBeta('frontmatter')}docUrl={pluginDocUrl('frontmatter')}><Trans>@@ -731,7 +1337,7 @@ export function FrontmatterPluginSection() {<p className="font-medium"><Trans>Configuration problems</Trans></p>- <ul className="list-disc pl-5 text-muted-foreground">+ <ul className="list-disc ps-5 text-muted-foreground">{problems.map((problem) => (<li key={problem}>{problem}</li>))}diff --git a/packages/app/src/components/settings/SettingsDialogBody.sections.dom.test.tsx b/packages/app/src/components/settings/SettingsDialogBody.sections.dom.test.tsxindex 62c8e6be7..caf112104 100644--- a/packages/app/src/components/settings/SettingsDialogBody.sections.dom.test.tsx+++ b/packages/app/src/components/settings/SettingsDialogBody.sections.dom.test.tsx@@ -132,6 +132,14 @@ vi.doMock('@/components/ui/input', () => ({Input: (props: React.InputHTMLAttributes<HTMLInputElement>) => <input {...props} />,}));+vi.doMock('@/hooks/use-skills', () => ({+ useSkills: () => ({ status: 'ready', data: [] }),+}));++vi.doMock('@/hooks/use-open-skill', () => ({+ useOpenSkill: () => () => {},+}));+const SelectHandlerCtx = createContext<((value: string) => void) | undefined>(undefined);vi.doMock('@/components/ui/select', () => ({Select: ({diff --git a/packages/app/src/components/settings/lint-plugin-meta.test.ts b/packages/app/src/components/settings/lint-plugin-meta.test.tsindex 6a6637af6..b985295a2 100644--- a/packages/app/src/components/settings/lint-plugin-meta.test.ts+++ b/packages/app/src/components/settings/lint-plugin-meta.test.ts@@ -24,4 +24,15 @@ describe('LINT_PLUGIN_META ⟷ plugin registry', () => {expect(meta.label.length).toBeGreaterThan(0);}});++ test('OKF declares its companion agent skill without making it a plugin dependency', () => {+ expect(LINT_PLUGIN_META.find((plugin) => plugin.id === 'okf')?.recommendedSkills).toEqual([+ { packId: 'okf', name: 'okf-knowledge-base' },+ ]);+ expect(+ LINT_PLUGIN_META.filter((plugin) => plugin.id !== 'okf').every(+ (plugin) => plugin.recommendedSkills === undefined,+ ),+ ).toBe(true);+ });});diff --git a/packages/app/src/components/settings/lint-plugin-meta.ts b/packages/app/src/components/settings/lint-plugin-meta.tsindex 5bf722d23..53f74273e 100644--- a/packages/app/src/components/settings/lint-plugin-meta.ts+++ b/packages/app/src/components/settings/lint-plugin-meta.ts@@ -13,6 +13,14 @@ export interface LintPluginMeta {label: string;/** Docs page for the plugin, linked from its settings panel. */docUrl: string;+ /**+ * Feature-maturity tag. A property of the plugin rather than a check against+ * its id at each render site, so every surface that shows a plugin agrees on+ * whether it is beta and a graduation is one edit here.+ */+ beta?: boolean;+ /** Companion skills the plugin recommends as a separate, explicit install. */+ recommendedSkills?: readonly { packId: string; name: string }[];}const DOCS_BASE = 'https://openknowledge.ai/docs/advanced/content-rules';@@ -25,4 +33,11 @@ export const LINT_PLUGIN_META: LintPluginMeta[] = [label: 'Frontmatter schemas',docUrl: `${DOCS_BASE}/frontmatter`,},+ {+ id: 'okf',+ label: 'OKF',+ docUrl: 'https://openknowledge.ai/docs/plugins/okf',+ beta: true,+ recommendedSkills: [{ packId: 'okf', name: 'okf-knowledge-base' }],+ },];diff --git a/packages/app/src/components/settings/lint-plugins.tsx b/packages/app/src/components/settings/lint-plugins.tsxindex 9ffd00f61..829692276 100644--- a/packages/app/src/components/settings/lint-plugins.tsx+++ b/packages/app/src/components/settings/lint-plugins.tsx@@ -6,7 +6,11 @@* future plugin's GUI = one `LINT_PLUGIN_META` entry + its Section in the map.*/import type { ReactNode } from 'react';-import { FrontmatterPluginSection, MarkdownlintPluginSection } from './LintingSection';+import {+ FrontmatterPluginSection,+ MarkdownlintPluginSection,+ OkfPluginSection,+} from './LintingSection';import { LINT_PLUGIN_META, type LintPluginMeta } from './lint-plugin-meta';type PluginSection = () => ReactNode;@@ -14,6 +18,7 @@ type PluginSection = () => ReactNode;const SECTIONS: Record<LintPluginMeta['id'], PluginSection> = {markdownlint: MarkdownlintPluginSection,frontmatter: FrontmatterPluginSection,+ okf: OkfPluginSection,};export interface LintPluginUi extends LintPluginMeta {diff --git a/packages/app/src/editor/useFrontmatterDiagnostics.ts b/packages/app/src/editor/useFrontmatterDiagnostics.tsindex 0e481aa9c..cc6b3f5b6 100644--- a/packages/app/src/editor/useFrontmatterDiagnostics.ts+++ b/packages/app/src/editor/useFrontmatterDiagnostics.ts@@ -58,17 +58,29 @@ export function partitionFrontmatterProblems(diagnostics: readonly LintDiagnosti}/**- * `config` with every plugin but frontmatter disabled. Derived from the plugin- * registry rather than naming markdownlint: the registry is append-designed, so- * a hardcoded list would silently start running a third plugin's pass here —+ * `config` with every plugin but frontmatter disabled. Derived from the config's+ * own plugin map rather than naming markdownlint: the registry is append-designed,+ * so a hardcoded list would silently start running a third plugin's pass here —* the same growth `partitionFrontmatterProblems` guards its output against.+ *+ * Rebuilt rather than mutated in place. Assigning through a union-typed key+ * (`plugins[id] = …`) asks for a value assignable to EVERY slice at once, which+ * no single slice satisfies once the registry holds more than one shape — so the+ * in-place form stopped compiling the moment a third plugin landed.+ *+ * Still driven by `LINT_PLUGINS`, not by the config's own keys: a config that+ * predates a plugin has no entry for it, and the registry walk is what puts a+ * disabled one there. Mapping `config.plugins` instead would leave that key+ * absent, and `lintDocument` reads `slice.enabled` off every registered plugin+ * without a presence check.*/function frontmatterOnly(config: LinterConfig): LinterConfig {- const plugins = { ...config.plugins };- for (const { id } of LINT_PLUGINS) {- if (id === 'frontmatter') continue;- plugins[id] = { ...plugins[id], enabled: false };- }+ const plugins = Object.fromEntries(+ LINT_PLUGINS.map(({ id }) => [+ id,+ id === 'frontmatter' ? config.plugins[id] : { ...config.plugins[id], enabled: false },+ ]),+ ) as LinterConfig['plugins'];return { ...config, plugins };}diff --git a/packages/app/src/hooks/use-generated-index-settings.dom.test.tsx b/packages/app/src/hooks/use-generated-index-settings.dom.test.tsxnew file mode 100644index 000000000..a7b34810d--- /dev/null+++ b/packages/app/src/hooks/use-generated-index-settings.dom.test.tsx@@ -0,0 +1,34 @@+import { act, cleanup, renderHook, waitFor } from '@testing-library/react';+import { afterEach, describe, expect, test, vi } from 'vitest';+import { useGeneratedIndexSettings } from './use-generated-index-settings.ts';++afterEach(() => {+ cleanup();+ vi.restoreAllMocks();+});++describe('useGeneratedIndexSettings', () => {+ test('surfaces a refresh failure while retaining the last known status', async () => {+ const activeStatus = {+ enabled: true,+ active: true,+ git: { state: 'ready', ownership: 'open-knowledge' },+ };+ vi.spyOn(globalThis, 'fetch')+ .mockResolvedValueOnce(+ new Response(JSON.stringify(activeStatus), {+ status: 200,+ headers: { 'Content-Type': 'application/json' },+ }),+ )+ .mockRejectedValueOnce(new Error('server unavailable'));++ const { result } = renderHook(() => useGeneratedIndexSettings());+ await waitFor(() => expect(result.current.status?.active).toBe(true));++ act(() => result.current.refresh());++ await waitFor(() => expect(result.current.issue).toBe('connection'));+ expect(result.current.status).toEqual(activeStatus);+ });+});diff --git a/packages/app/src/hooks/use-generated-index-settings.ts b/packages/app/src/hooks/use-generated-index-settings.tsnew file mode 100644index 000000000..4a9d4ec24--- /dev/null+++ b/packages/app/src/hooks/use-generated-index-settings.ts@@ -0,0 +1,83 @@+import { useEffect, useState } from 'react';+import { z } from 'zod';+import { parseServerResponse, parseSuccessOrWarn } from '@/lib/parse-server-response';++const GeneratedIndexSettingsStatusSchema = z.object({+ enabled: z.boolean(),+ active: z.boolean(),+ git: z.object({+ state: z.enum(['not-applicable', 'ready', 'missing', 'conflict', 'unavailable']),+ ownership: z.enum(['open-knowledge', 'existing']).optional(),+ }),+ applied: z.boolean().optional(),+ reason: z.enum(['git-conflict', 'git-unavailable', 'config-write']).optional(),+});++export type GeneratedIndexSettingsStatus = z.infer<typeof GeneratedIndexSettingsStatusSchema>;+export type GeneratedIndexSettingsIssue =+ | 'git-conflict'+ | 'git-unavailable'+ | 'config-write'+ | 'connection';++async function requestStatus(init?: RequestInit): Promise<{+ status: GeneratedIndexSettingsStatus | null;+ issue: GeneratedIndexSettingsIssue | null;+}> {+ try {+ const response = await fetch('/api/generated-index/settings', init);+ const parsed = await parseServerResponse(+ response,+ 'Open Knowledge could not update index generation.',+ );+ if (!parsed.ok) return { status: null, issue: 'connection' };+ const status = parseSuccessOrWarn(+ GeneratedIndexSettingsStatusSchema,+ parsed.body,+ 'generated-index-settings',+ null,+ );+ if (!status) return { status: null, issue: 'connection' };+ return {+ status,+ issue: status.applied === false ? (status.reason ?? 'connection') : null,+ };+ } catch {+ return { status: null, issue: 'connection' };+ }+}++export function useGeneratedIndexSettings() {+ const [status, setStatus] = useState<GeneratedIndexSettingsStatus | null>(null);+ const [issue, setIssue] = useState<GeneratedIndexSettingsIssue | null>(null);+ const [pending, setPending] = useState(false);++ function refresh(): void {+ void requestStatus().then((result) => {+ if (result.status) setStatus(result.status);+ setIssue(result.issue);+ });+ }++ // biome-ignore lint/correctness/useExhaustiveDependencies: one mount-owned poller; refresh closes only over stable state setters.+ useEffect(() => {+ refresh();+ const interval = window.setInterval(refresh, 5_000);+ return () => window.clearInterval(interval);+ }, []);++ async function setEnabled(enabled: boolean): Promise<boolean> {+ setPending(true);+ const result = await requestStatus({+ method: 'POST',+ headers: { 'Content-Type': 'application/json' },+ body: JSON.stringify({ enabled }),+ });+ setPending(false);+ if (result.status) setStatus(result.status);+ setIssue(result.issue);+ return result.status?.applied === true;+ }++ return { status, issue, pending, refresh, setEnabled };+}diff --git a/packages/app/src/lib/frontmatter-enum-constraints.test.ts b/packages/app/src/lib/frontmatter-enum-constraints.test.tsindex 0b3f4699e..883703dbb 100644--- a/packages/app/src/lib/frontmatter-enum-constraints.test.ts+++ b/packages/app/src/lib/frontmatter-enum-constraints.test.ts@@ -1,4 +1,4 @@-import type { LinterConfig } from '@inkeep/open-knowledge-core';+import type { LinterConfig, OkfRuleId } from '@inkeep/open-knowledge-core';import { describe, expect, test } from 'vitest';import { enumConstraintsForDoc } from './frontmatter-enum-constraints.ts';@@ -30,6 +30,68 @@ const DOC_SCHEMA = {},};+/**+ * The OKF profile is a second source of governing schemas, carrying no files and+ * gated on its own plugin. These exercise the REAL built-in schemas rather than a+ * stand-in, so a change to the shipped `status` vocabulary fails here.+ */+function configWithOkf(+ okf: { enabled: boolean; rules?: Partial<Record<OkfRuleId, boolean>> },+ frontmatter: { enabled: boolean; schemas: Parameters<typeof configWith>[0] } = {+ enabled: false,+ schemas: [],+ },+): LinterConfig {+ return {+ enabled: true,+ plugins: {+ markdownlint: { enabled: false, rules: {} },+ frontmatter,+ okf,+ },+ } as LinterConfig;+}++describe('enumConstraintsForDoc — the OKF profile', () => {+ test('OKF alone supplies the status vocabulary, with the frontmatter plugin off', () => {+ const constraints = enumConstraintsForDoc(configWithOkf({ enabled: true }), 'notes/concept');+ expect(constraints.get('status')).toEqual({+ values: ['draft', 'stable', 'deprecated'],+ multi: false,+ });+ });++ test('with OKF off it supplies nothing', () => {+ expect(enumConstraintsForDoc(configWithOkf({ enabled: false }), 'notes/concept').size).toBe(0);+ });++ test('a disabled rule withdraws its schema from the vocabulary', () => {+ const constraints = enumConstraintsForDoc(+ configWithOkf({ enabled: true, rules: { 'frontmatter-provenance': false } }),+ 'notes/concept',+ );+ expect(constraints.has('status')).toBe(false);+ });++ test('the two sources intersect rather than one winning', () => {+ // The project's own schema offers draft/review/published; OKF offers+ // draft/stable/deprecated. Only `draft` satisfies both, and the panel must+ // offer only what validates against every governing schema.+ const constraints = enumConstraintsForDoc(+ configWithOkf(+ { enabled: true },+ { enabled: true, schemas: [{ file: 'a.json', schema: DOC_SCHEMA }] },+ ),+ 'notes/concept',+ );+ expect(constraints.get('status')).toEqual({ values: ['draft'], multi: false });+ });++ test('scoping is honored — a nested index is governed by a schema with no vocabularies', () => {+ expect(enumConstraintsForDoc(configWithOkf({ enabled: true }), 'notes/index').size).toBe(0);+ });+});+describe('enumConstraintsForDoc', () => {test('enum fields map to single-select; array items.enum to multi', () => {const constraints = enumConstraintsForDoc(diff --git a/packages/app/src/lib/frontmatter-enum-constraints.ts b/packages/app/src/lib/frontmatter-enum-constraints.tsindex 1b5180d5f..864128192 100644--- a/packages/app/src/lib/frontmatter-enum-constraints.ts+++ b/packages/app/src/lib/frontmatter-enum-constraints.ts@@ -12,7 +12,11 @@* validate.*/-import { type LinterConfig, selectApplicableFrontmatterSchemas } from '@inkeep/open-knowledge-core';+import {+ type LinterConfig,+ selectApplicableFrontmatterSchemas,+ selectOkfFrontmatterSchemas,+} from '@inkeep/open-knowledge-core';export interface FieldEnumConstraint {values: string[];@@ -50,11 +54,22 @@ export function enumConstraintsForDoc(// so the offered values would depend on schema order and could violate a// schema seen earlier.const droppedToFreeText = new Set<string>();- const slice = config?.plugins.frontmatter;- if (!config?.enabled || !slice?.enabled || docName === undefined || docName === '') {- return constraints;- }- for (const { schema } of selectApplicableFrontmatterSchemas(slice.schemas, docName)) {+ if (!config?.enabled || docName === undefined || docName === '') return constraints;++ // Both schema sources feed the same intersection: the project's authored mappings+ // and, when the OKF plugin is on, its built-in profile. A field governed by both+ // must offer only values satisfying both, which is what the conjunction below+ // already does — so the sources concatenate rather than branching.+ const frontmatterSlice = config.plugins.frontmatter;+ const okfSlice = config.plugins.okf;+ const governing = [+ ...(frontmatterSlice?.enabled+ ? selectApplicableFrontmatterSchemas(frontmatterSlice.schemas, docName)+ : []),+ ...(okfSlice?.enabled ? selectOkfFrontmatterSchemas(okfSlice.rules, docName) : []),+ ];++ for (const { schema } of governing) {const properties = isRecord(schema.properties) ? schema.properties : {};for (const [field, rawProperty] of Object.entries(properties)) {if (!isRecord(rawProperty)) continue;diff --git a/packages/app/src/lib/skills-api.pack-skill.dom.test.ts b/packages/app/src/lib/skills-api.pack-skill.dom.test.tsnew file mode 100644index 000000000..ab9859ab1--- /dev/null+++ b/packages/app/src/lib/skills-api.pack-skill.dom.test.ts@@ -0,0 +1,32 @@+import { afterEach, describe, expect, test, vi } from 'vitest';+import { installPackSkill } from './skills-api';++const originalFetch = globalThis.fetch;++describe('installPackSkill', () => {+ afterEach(() => {+ globalThis.fetch = originalFetch;+ });++ test('uses the explicit companion-skill endpoint and preserves its creation result', async () => {+ const fetchMock = vi.fn().mockResolvedValue(+ new Response(+ JSON.stringify({+ installedHosts: ['Claude Code'],+ skills: [{ name: 'okf-knowledge-base', created: true }],+ }),+ { status: 200, headers: { 'Content-Type': 'application/json' } },+ ),+ );+ globalThis.fetch = fetchMock;++ await expect(installPackSkill('okf')).resolves.toEqual({+ ok: true,+ installedHosts: ['Claude Code'],+ skills: [{ name: 'okf-knowledge-base', created: true }],+ });+ expect(fetchMock.mock.calls[0]?.[0]).toBe('/api/seed/install-pack-skill');+ expect(fetchMock.mock.calls[0]?.[1]?.method).toBe('POST');+ expect(JSON.parse(fetchMock.mock.calls[0]?.[1]?.body as string)).toEqual({ packId: 'okf' });+ });+});diff --git a/packages/app/src/lib/skills-api.ts b/packages/app/src/lib/skills-api.tsindex 92383a0ca..617a1c352 100644--- a/packages/app/src/lib/skills-api.ts+++ b/packages/app/src/lib/skills-api.ts@@ -1,4 +1,5 @@import type {+ SeedInstallPackSkillSuccess,SkillDetail,SkillDiscover,SkillFrontmatter,@@ -95,6 +96,23 @@ export async function searchSkills(query: string): Promise<WriteResult<SkillsSeareturn getJson<SkillsSearchSuccess>(`/api/skills/search?q=${encodeURIComponent(q)}`);}+/**+ * POST `/api/seed/install-pack-skill` — explicitly install the companion+ * skills shipped by one starter pack, without applying the pack's content+ * scaffold or changing plugin configuration.+ */+export async function installPackSkill(+ packId: string,+): Promise<WriteResult<SeedInstallPackSkillSuccess>> {+ const result = await sendJson<SeedInstallPackSkillSuccess>(+ '/api/seed/install-pack-skill',+ 'POST',+ { packId },+ );+ if (result.ok) emitSkillsChanged();+ return result;+}+/*** GET `/api/skills/popular` — the Discover blank-state list (server-scraped from* the skills.sh front page, cached + best-effort). A non-`ok` result OR an emptydiff --git a/packages/app/src/locales/ar/messages.json b/packages/app/src/locales/ar/messages.jsonindex ad73ec6fd..2a56b7f39 100644--- a/packages/app/src/locales/ar/messages.json+++ b/packages/app/src/locales/ar/messages.json@@ -142,6 +142,9 @@"0ySP5u": ["تُحفظ التغييرات تلقائيًا في هذه السمة."],"0zAhu6": ["كل مستند"],"10g8I_": ["إيقاف «ملفات Markdown فقط»"],+ "110eEb": [+ "يقوم Open Knowledge بإنشاء ملف تنقل يسمى index.md والحفاظ عليه في كل مجلد يحتوي على Markdown."+ ],"11ukmX": ["فشلت إعادة التسمية: ", ["0"]],"12F9WL": ["(بدون معرّف)"],"151wvk": ["إظهار الشريط الجانبي"],@@ -159,6 +162,9 @@"1GhYxC": ["من ", ["totalPages"]],"1HBhDS": ["يجري سحب الملفات"],"1J0c0X": ["ما زال الوصول إلى ", ["displayName"], " متعذّرًا. هل تريد محاولة أخيرة؟"],+ "1JpLgH": [+ "في مستند الفهرس: توجد الإدخالات تحت عنوان القسم ويحمل كل منها رابطًا. النثر حول القوائم على ما يرام."+ ],"1LtA5r": ["يربط المهارة رمزيًا بـ ", ["path"]],"1MGRQl": ["جلسات الطرفية"],"1NgrlY": ["طرق أخرى للتثبيت"],@@ -170,6 +176,7 @@"1V17kO": ["يجري تحميل النسختين"],"1VpfKR": ["أنشئ مهارة لهذا المشروع."],"1XSMhZ": ["سيُرفض التبديل إلى <0>local-only</0> حتى يُلغى تتبّعها عبر<1> git rm --cached</1>."],+ "1ZXkqM": ["قم بإيقاف تشغيله في أي وقت في الإعدادات."],"1ZpfyB": ["الفتح بالذكاء الاصطناعي ", ["displayName"], "، ", ["hint"]],"1a6ICf": ["يجري متابعة تعديلات الوكيل"],"1bDVu5": ["لوحة أوامر مساحة العمل"],@@ -337,6 +344,8 @@"3o3tur": ["محتوى البداية"],"3oh0nQ": ["خطأ في .okignore المتداخل في ", ["path"]],"3pU8e-": ["تثبيت التبويب"],+ "3qDsdf": ["مهارة التثبيت"],+ "3ri_4O": ["يحافظ على توافق قاعدة معارفك مع Open Knowledge Format."],"3s-k7L": [["0",@@ -505,6 +514,9 @@],"5tcmwY": ["إضافة قيمة"],"5vAI6Z": ["لم يناسب سير عملي"],+ "5w38tn": [+ "توقفت صيانة الفهرس بسبب تعذر على Open Knowledge الوصول إلى خادم المشروع. حاول مرة أخرى عند إعادة اتصال المشروع."+ ],"5wV2qQ": ["والمزيد"],"5y_9lO": ["في انتظار التفويض"],"6-wLTJ": [["behind"], " خلف origin"],@@ -667,6 +679,7 @@"7d1a0d": ["عام"],"7dZnmw": ["الصلة"],"7hctf2": ["صِف المشروع الذي تريد إنشاءه"],+ "7idx48": ["OKF تم تثبيت مهارة الوكيل"],"7jIIFX": ["اكتمل إعدادك!"],"7kb4LU": ["موافق عليه"],"7l15X4": ["فشل"],@@ -674,6 +687,20 @@"7m3Ade": ["التثبيتات:"],"7qRHf0": ["التثبيت لـ Claude Chat وCowork"],"7uBlRT": ["انسخ عنصر شجرة الملفات المركَّز عليه ليتمكن «لصق» من تكراره."],+ "7wogIQ": [+ [+ "0",+ "plural",+ {+ "zero": ["إضافات"],+ "one": ["إضافة"],+ "two": ["إضافتان"],+ "few": ["إضافات"],+ "many": ["إضافة"],+ "other": ["إضافة"]+ }+ ]+ ],"80c4-P": ["تم نسخ الكود إلى الحافظة"],"81H_23": ["إضافة خصائص"],"851WA-": ["يمكن ضبط هذا في الإعدادات > أدوات الذكاء الاصطناعي وواجهة سطر الأوامر"],@@ -732,6 +759,7 @@"8nWu1k": ["مخطط فارغ"],"8oWgty": ["تحديد كل التعليقات للإرسال"],"8qgfac": ["خوادم MCP"],+ "8rZ1pk": ["تمكين ", ["id"]],"8ruqQi": ["روابط داخلية معطلة"],"8sMErm": ["هل تفعّل المتابعة؟"],"8t9CRE": ["يجري تشغيل ", ["agentName"], "…"],@@ -942,6 +970,9 @@"BQKHuL": ["إعادة تشغيل الطرفية"],"BQu9Pg": ["رابط رمزي"],"BUyQnq": ["تعذّرت إعادة تشغيل الخادم. جرّب `ok start` في هذا المجلد."],+ "BVkqD9": [+ "تم إيقاف صيانة الفهرس مؤقتًا لأن سمة Git أخرى تتحكم في index.md. قم بتحديث .gitattributes بحيث تستخدم مسارات index.md المحددة النطاق merge=union، ثم حاول مرة أخرى."+ ],"BY-g4_": ["إضافة نمط"],"Ba4D2x": ["تم استيراد القالب"],"Bdha5y": ["يجري النشر..."],@@ -960,6 +991,7 @@"Bv5a9_": ["إحصاءات التحديد"],"Bx4EXG": ["إجراءات ", ["label"]],"By-7Pn": ["بدّل القائمة النقطية."],+ "ByIOcK": ["تظل ملفات الفهرس في مكانها. Open Knowledge يزيل فقط القاعدة Git التي أضافها."],"BymzO4": ["مخطط المستند"],"C-mmmK": ["معرّف النموذج الذي تخدمه نقطة نهايتك. يُكتشف حجم متجهه تلقائيًا — امسح الحقل للعودة إلى ",@@ -1012,6 +1044,9 @@"يبقى <0>~/.ok/bin</0> و<1>~/.ok/env.sh</1> في الحالتين — يتولى التطبيق صيانتهما دائمًا."],"CXTwen": ["لا يمكن تحرير إعداد هذا المشروع بأمان"],+ "CXcveY": [+ "يحتفظ Open Knowledge بملف تنقل يسمى index.md في كل مجلد يحتوي على Markdown، حيث يسرد كل منها مستندات هذا المجلد حسب النوع ويرتبط بمجلداته الفرعية. فهو يعيد كتابة هذه الملفات مع تغير مستنداتك، ويتم استبدال أي شيء تقوم بتحريره فيها بنفسك."+ ],"CXj9C-": ["اسم خاصية جديد"],"C_Lyvh": ["فشل حفظ إعداد السمة"],"C_WGy8": [@@ -1035,6 +1070,9 @@"Cu6GXQ": ["لا يتحرك مجلد المصدر نفسه."],"CvsD6Y": ["عبر ", ["viaTags"]],"CwOXMT": ["قيمة ", ["keyName"]],+ "CxCOFx": [+ "في مشاريع Git، يضيف Open Knowledge قاعدة محددة النطاق إلى ملف .gitattributes في جذر المستودع لدمج تغييرات الفهرس المتزامنة."+ ],"CxVk-w": ["تعليق على ", ["address"]],"D-NlUC": ["النظام"],"D-Oh1s": ["كيفية إعداد ", ["0"], " (يفتح في المتصفح)"],@@ -1117,6 +1155,9 @@"DhT_PK": ["استورد OpenKnowledge مهارة"],"DiFKSL": ["يجري عد ملفات Markdown"],"DiZ3pq": ["منتقي الأيقونات"],+ "DjNcDy": [+ "أشكال title وdescription وresource وtags عند استخدامها. لا شيء مطلوب. الإعلان عن نوع واحد فقط، لذلك يتم وضع علامة على tags المكتوب كسلسلة مفصولة بفواصل."+ ],"DmkTrb": ["تعذّر إنشاء هذه السمة. حاول مرة أخرى."],"Dnn2XG": ["تلقائي"],"DpjYd6": ["الانتقال إلى النص المرتبط"],@@ -1352,6 +1393,9 @@"GNkUvW": ["في الطابور — سيُرسل عند انتهاء هذا التشغيل"],"GQ3O42": ["المهملات"],"GQDSBN": ["خيارات التخطيط"],+ "GROUfG": [+ "أي ملف .mdx. التنسيق هو .md فقط، لذا فإن القارئ الذي يبحث عن .md لا يفتحه أبدًا - وفي حالة وجود .md بنفس الاسم، يقرأه بدلاً من ذلك."+ ],"GSYWCm": ["إخفاء لوحة المستند"],"GUYwCr": ["تجاهل الإشعار"],"GUZHkL": ["ألوان لوحة الألوان مفقودة"],@@ -1541,6 +1585,7 @@"IxHMdF": ["تعذّر حذف ذلك التعليق."],"IxyZXD": ["لقطة الشاشة"],"Izh19j": ["القراءة من ", ["tail"]],+ "J0uRhj": ["مهارة التحقق"],"J1XRO3": ["ألوان السمة"],"J2Mv98": ["الاسم (مثل ", ["login"], ")"],"J2_JuX": ["لا شيء (", ["0"], " لا يمكن أن يطابق مستندًا)"],@@ -1561,6 +1606,7 @@"JHf6qZ": ["[email protected]"],"JJcBCm": [["0"], " إجمالًا"],"JK-Ave": ["إخفاء الصور المصغّرة"],+ "JKXcOi": ["بالفعل في المشروع"],"JL3si7": ["يجري التحديث"],"JLUTgi": ["لا توجد وسوم بعد — اكتب `#tagname` في أي مستند لملء الفهرس."],"JLzQi_": ["إغلاق ", ["accessibleLabel"]],@@ -1650,6 +1696,9 @@"L-rMC9": ["إعادة التعيين إلى الافتراضي"],"L1BQTH": [["0"], " غير مثبَّت بعد — يجري فتح صفحة تنزيله."],"L1ZE3M": ["إحصاءات المستند"],+ "L3BcJ4": [+ "يحتاج هذا إلى رؤية ملفاتك، وليس فقط المستند المفتوح، لذلك يظهر عند تشغيل تدقيق المشروع وليس أثناء الكتابة."+ ],"L3CEC1": ["هذا العنصر"],"L3w0_C": ["اعرض مستندًا كشرائح تقديمية في نافذة خاصة به. أضف <0>slides: true</0> إلى frontmatter المستند، ثم افتحه عبر إجراء Slidev. يتولّى العرضَ واجهةُ Slidev لسطر الأوامر، وهي غير مضمّنة في OpenKnowledge."@@ -2154,6 +2203,12 @@"R6ABfU": ["العمل مباشرة، دون خطوة تخطيط"],"R9IDFz": ["يعيد تسمية المجلد على القرص والمعرّف الذي يستخدمه الوكلاء لاستدعائها."],"R9dK63": ["صورة نموذجية"],+ "RB_g_C": [+ "في الفهرس الجذري، تتم كتابة okf_version كسلسلة مقتبسة مثل \"0.2\". بدون اقتباس، يقرأه YAML كرقم ويصبح 0.10 بصمت 0.1."+ ],+ "RD6H9q": [+ "يقوم Open Knowledge بإعادة كتابة ملفات index.md هذه مع تغير المستندات، لذلك يتم استبدال التعديلات اليدوية عليها."+ ],"RDjuBN": ["الإعداد"],"RDrXh4": ["اضبط إعدادات المستخدم والمشروع والتكاملات."],"RG3yW6": ["أدخل اسمًا لهذه السمة."],@@ -2223,6 +2278,9 @@"SF9qpO": ["شارك بريدك الإلكتروني للمتابعة"],"SFEWV6": ["تعذّر تحميل مهارات OpenKnowledge. أعد المحاولة."],"SFN6dN": ["عنوان 3"],+ "SIPelo": [+ "تم إيقاف صيانة الفهرس مؤقتًا لأن Open Knowledge لم يتمكن من تأكيد قاعدة الدمج Git المطلوبة. تحقق من Git و.gitattributes، ثم حاول مرة أخرى."+ ],"SInSnF": ["مرجع <0>", ["0"], "</0>"],"SItQRc": ["ما رأيك في OpenKnowledge؟"],"SOPwPh": ["الاستعادة إلى هذا التعديل"],@@ -2611,6 +2669,7 @@"X7u0xR": [["0"], " قالب متاح"],"X8kjQX": ["أعد المصادقة مع GitHub"],"X9VpsP": ["يجري تحميل محتويات المجلد"],+ "XAnapw": ["Git قاعدة الدمج"],"XAyxsa": ["سحب فرع بعيد"],"XBBZnv": ["هدف الرابط \"", ["shown"], "\" لا يشير إلى مستند موجود."],"XBgr2S": ["النسخ إلى هنا"],@@ -2750,6 +2809,9 @@"Y_iImT": ["تعذّر حل الملف ", ["identity"], ". انتقل إلى المرجع."],"Y_kL7X": ["خصّص مظهر المحرر وسلوكه."],"Ya3PlJ": ["الإذن مطلوب"],+ "YaVU2F": [+ "في مشاريع Git، يضيف Open Knowledge أيضًا قاعدة .gitattributes محددة النطاق بحيث يتم دمج تغييرات الفهرس المتزامنة قبل إعادة البناء التالية."+ ],"YaeyFh": ["قد تستبدل عمليات السحب تعديلات غير مودعة في ملفاتك المحلية."],"Yb82LN": ["المعرّف: ", ["0"]],"Yea-K5": ["الاستعادة إلى هذه النقطة"],@@ -2904,6 +2966,7 @@"_Bix3-": ["مواضع ظهور ", ["localizedFirstMessage"]],"_DwR-n": ["جارٍ الإنشاء…"],"_FLBbi": [["sizeText"], " · تم إخفاء الأسرار · لم يُخفَ تفريغ الأعطال"],+ "_G7A92": ["الحفاظ على index.md"],"_GRWOJ": ["هل تريد تغيير مزوّد التضمينات؟"],"_HgF9q": ["الترتيب حسب"],"_IGfXZ": ["أُغلق OpenKnowledge على نحو غير متوقع في المرة السابقة."],@@ -2988,10 +3051,12 @@"تعذّر الاتصال بخدمة الوكيل. تأكد من أن خادم OpenKnowledge يعمل ومحدَّث (أعد تشغيله إن كان يعمل بالفعل)، ثم أعد المحاولة."],"aalx4E": ["يجري تحرير مصدر MDX معطوب: ", ["reason"]],+ "aatPoi": ["الملفات التي تم إنشاؤها"],"abiHje": ["حذف العناصر المحددة"],"adsMWO": ["يجري حل الفروق"],"ah_ekO": ["«", ["name"], "» محدَّث بالفعل"],"aiArms": ["تعذّر علينا استنساخ هذا المستودع."],+ "aiOceC": ["تمكين الفهارس"],"ajHi4O": ["المزامنة التلقائية موقوفة مؤقتًا — ليس لديك إذن بالدفع إلى هذا المستودع. بدّل إلى «متابعة» لمواصلة تلقّي التحديثات."],@@ -3146,11 +3211,13 @@],"cb-0G0": ["إزالة اللون"],"ccNps_": ["المعدَّل فقط"],+ "cd3THN": ["هيكل الوثيقة"],"cd5EXh": ["الإبلاغ عن علة"],"cdm00A": ["لا روابط واردة"],"cdmk8A": ["تغييرات غير مودعة"],"cgl-gn": ["متصل بـ GitHub"],"chL5IG": ["المجتمع"],+ "ciozf1": ["المهارة موجودة بالفعل في المشروع"],"cjtjry": ["تنقّل في سجل تنقّل OpenKnowledge إلى الخلف."],"cklVjM": ["الخط الزمني"],"clJ3qM": ["تم."],@@ -3377,6 +3444,7 @@"fbdLmk": ["بدّل التنسيق العريض."],"fbsiBw": ["حدث خطأ ما أثناء بدء الطرفية."],"fcgvCA": ["Claude"],+ "fdKQAE": ["إيقاف تشغيله"],"fdeFfN": ["(ملف ثنائي، لا يمكن معاينته)"],"fevEu0": ["سحب أحدث التغييرات"],"ffH3Rt": ["إضافة تعليق (Enter)"],@@ -3452,12 +3520,16 @@"gUx34c": ["اللغة التي يتحدث بها OpenKnowledge؛ ويتبع خيار النظام لغة نظام التشغيل لديك. تبقى ملاحظاتك باللغة التي كتبتها بها."],+ "gVMkEr": [+ "في مستند السجل: تبدأ عناوين الإدخال بتاريخ ISO YYYY-MM-DD، الأحدث أولاً. إن عدد titles الذي تستخدمه، وما إذا كانت الإدخالات عبارة عن تعداد نقطي، هو أمر متروك لك."+ ],"gY7wnY": ["جارٍ تسجيل الدخول إلى ", ["agentName"], "…"],"gYz2ep": ["تنتهي الصلاحية خلال ", ["timeLabel"]],"gZElfU": ["يجري إصلاح ", ["0"], " من ", ["1"], " ملف"],"gZiT5e": ["هل تستبدل هذه الروابط الرمزية بنسخ مستقلة؟"],"gayL_Q": ["خطة الإصدار"],"gbHcbI": ["فشل حذف الخاصية"],+ "gfYI3o": ["تعطيل ", ["id"]],"gfb-CM": ["تعذّر جلب الفرع — سجّل الدخول إلى GitHub وأعد المحاولة."],"gfdqcY": ["تعذّر تطبيق التغيير: ", ["0"]],"gfohmY": ["ربط الأدوات"],@@ -3523,6 +3595,9 @@"hLKfZe": ["استخدم رمزًا بدلًا من ذلك"],"hLod4_": ["تحويل إلى قالب"],"hLy8b1": ["حُدِّث إلى الإصدار ", ["version"]],+ "hPQBsa": [+ "تتم تسمية الملفات المحجوزة index.md وlog.md بأحرف صغيرة. في نظام الملفات الحساس لحالة الأحرف، تتم قراءة Index.md كمستند عادي ويفقد معناه."+ ],"hQXiDc": ["البحث في الفروع..."],"hQjvzi": ["أرشيف بصيغة .zip أو .skill."],"hS0wC4": ["استعاد OpenKnowledge نسخة سابقة من ", ["subject"]],@@ -3661,6 +3736,9 @@"iy64Li": ["مزامنة كاملة — تُودَع تعديلاتك وتُدفع إلى مستودعك البعيد تلقائيًا."],"iycx_A": ["يجري الدفع"],"iz1LdD": ["تغيّر خارج OK منذ آخر كتابة هنا — الحالة المعروضة هي ما على القرص الآن"],+ "j-o6Z2": [+ "توقفت صيانة الفهرس بسبب تعذر حفظ إعداد المشروع. تحقق من أذونات ملف المشروع، ثم حاول مرة أخرى."+ ],"j15ZSH": ["إرسال التعليقات إلى"],"j2229h": ["تجري إزالة ملفات OpenKnowledge…"],"j2kt1j": [@@ -3740,6 +3818,7 @@"إضافات المستخدم خاصة بهذا الجهاز — شغّلها أو أوقفها هنا. يعيش الاختيار في إعداد المستخدم لديك ولا يُودَع في المشروع أبدًا. تحصل كل إضافة مفعّلة على صفحتها الخاصة تحت «الإضافات» في الشريط الجانبي للإعدادات."],"k4CuuV": ["مجلدات وقوالب جاهزة لتبدأ بسرعة. اختر حزمة لمعاينة ما سيُنشأ، ثم أضفها إلى مشروعك."],+ "k5rKNs": ["frontmatter"],"k7Hoig": ["لا تغييرات في المحتوى في هذه النسخة."],"k8xtrB": ["غير مطلوب لنقطة نهاية محلية مثل <0>",@@ -3779,7 +3858,9 @@"kV2YZv": ["لا ترى <0>المهارات</0>؟ فعّل <1>الإعدادات <2/> القدرات <3/> تنفيذ الكود وإنشاء الملفات</1> أولًا."],+ "kVS5tE": ["هل تريد الحفاظ على فهارس generated في كل مجلد؟"],"kVgQUA": ["هل تريد حذف هذه المحادثة؟"],+ "kVzuTI": ["مهارة الوكيل الموصى بها"],"kYL1lH": ["نشاط الوكيل"],"k_Dqw1": [[@@ -3875,7 +3956,9 @@"lWNpNB": ["أضف مؤشرات أو حدد التكرارات المطابقة عبر CodeMirror."],"lXKZGw": ["عنوان 1"],"lY27jj": ["قبل ", ["0"], " سنة"],+ "lY7Unt": ["تمكين إنشاء الفهرس"],"lZAiSP": ["لم تطابق استجابة الروابط الخلفية الشكل المتوقع."],+ "lZoQdy": ["مهارة مفتوحة"],"lZvQrY": ["استخدام ", ["0"], " كسمة داكنة"],"l_6JHD": ["البحث عن أيقونات..."],"l_FAT6": ["استخدم الحروف والأرقام و<0>-</0> أو <1>_</1> فقط."],@@ -3893,6 +3976,20 @@"ljHjfg": ["ذلك الفرع مفتوح بالفعل في شجرة عمل أخرى."],"lkYioO": ["إظهار لوحة المستند أو إخفاؤها"],"ll2yNl": ["مجلد المحتوى"],+ "llXHHh": [+ [+ "pluginCount",+ "plural",+ {+ "zero": ["إضافات"],+ "one": ["إضافة"],+ "two": ["إضافتان"],+ "few": ["إضافات"],+ "many": ["إضافة"],+ "other": ["إضافة"]+ }+ ]+ ],"lmBPt0": ["الروابط الخارجية وحدها هي التي تُطلق طلبًا. أما الروابط إلى مستندات أخرى في هذا المشروع فتُعاين من الفهرس المحلي ولا تغادر جهازك أبدًا."],@@ -3989,6 +4086,9 @@}]],+ "mhnCt3": [+ "تحتوي كل وثيقة مفاهيمية على نوع غير فارغ. هذا هو الحد الأدنى من التوافق الخاص بـ OKF — أي المستند الذي يحتوي على نوع واحد فقط يكون متوافقًا تمامًا."+ ],"mk2poV": ["مثال: server.ts"],"mlvM8g": ["تعذّرت إعادة وضع ذلك التعليق."],"mmpzAq": ["لُف الأسطر الطويلة في محرر مصدر Markdown."],@@ -4284,6 +4384,9 @@"qRZh7J": ["دع مفتاح Tab يخرج من محرر المصدر بدلًا من الإزاحة."],"qSKu2v": ["التنقل والتحديد في المصدر"],"qSxaOz": ["قبول حذفهم"],+ "qTT48-": [+ "روابط Wiki مثل [[Page]] — طريقة مدعومة للربط هنا، لكن القارئ الخارجي لا يحل أي شيء ويعرض الأقواس."+ ],"qTcVwj": ["استعرض أو ارفع مهارة لهذا المشروع."],"qTcZZu": ["فشل تحميل الوسوم. اضغط <0>Esc</0> وأعد الفتح للمحاولة مرة أخرى."],"qX-ABr": ["أو لاستخدام تسجيل الدخول عبر المتصفح بدلًا من ذلك:"],@@ -4343,6 +4446,7 @@"r51jLC": ["تم حفظ الملف وفتح تطبيق Claude Desktop"],"r6ncaO": ["إغلاق التبويب"],"r6y-jM": ["تحذير"],+ "r7IaYp": ["Open Knowledge Format التوجيه"],"r871ed": ["أصبحت قاعدة معرفتك على GitHub في <0>", ["ownerLogin"], "/", ["repoName"], "</0>."],"rDOuNw": ["فشل استيراد القالب"],"rENNI6": ["رابط المشاركة غير صالح."],@@ -4364,6 +4468,9 @@"rZVMkf": ["حقل استبدال المحرر المرئي مركَّز عليه"],"radOpL": ["الصورة ", ["identity"], ". انتقل إلى المرجع."],"rageVb": ["HTML مخصص مع لوحة معاينة حية (إطار معزول)."],+ "rarziH": [+ "يساعد وكلاء الترميز في اختيار أنواع المستندات OKF والحفاظ على المصدر وتجنب اختراع بيانات تعريف غير مدعومة."+ ],"rbrHTd": ["موافق عليه — ", ["optionName"]],"rcJmK8": ["تحويل المواقع إلى نسخ"],"rdU729": ["التخطيط"],@@ -4423,6 +4530,7 @@"sER-bs": ["الملفات"],"sFhaTJ": ["يميّز بين القوالب المتشابهة الأسماء في القائمة."],"sGZLfB": ["تعذر جلب المستودعات"],+ "sHDllh": ["توقف عن صيانة index.md"],"sICrVf": ["تمت الاستعادة إلى نسخة ", ["0"]],"sIGbBZ": ["تحويل التحديد إلى حاشية"],"sIxSSP": ["حل التعارض في طرفيتك"],@@ -4436,6 +4544,7 @@"sOxZaS": ["فشل تحميل الرسم البياني"],"sQoLn0": ["إنهاء"],"sR0I-f": ["طيّ كل الملفات"],+ "sSRndh": ["ابدأ في صيانة index.md"],"sW5OjU": ["مطلوب"],"sZ2IOu": ["شُورك هذا ",@@ -4450,6 +4559,9 @@"saIASg": ["العنصر الثاني"],"saYiIO": ["لا يمكن أن يحتوي المسار على بايتات صفرية"],"scu3wk": ["النموذج"],+ "scyoP9": [+ "لا تحمل مستندات الفهرس frontmatter، باستثناء تلك الموجودة في جذر قاعدة المعرفة الخاصة بك. لا تتم تغطية مستندات السجل — OKF لا يقيد frontmatter الخاصة بها."+ ],"se-tU0": ["تعذّر إصلاح ", ["0"], " من أصل ", ["total"], " ملفًا."],"seeS6l": ["هل تعدّ OpenKnowledge في هذا المجلد؟"],"sgmRY8": ["تم تخطي تنزيل ", ["0"], "."],@@ -4511,6 +4623,9 @@"tHKQ6j": ["تجري إعادة التسمية"],"tKlWWY": ["رموز تعبيرية"],"tLX6LY": ["كتب OpenKnowledge مستندًا"],+ "tM5uzl": [+ "عائلات المصدر والثقة ودورة الحياة: sources، generated، verified، status، وstale_after. كل حقل اختياري، والغياب ليس خطأ أبدًا."+ ],"tN5WTS": ["رفض المزوّد الطلب. تحقق من مفتاح API ومعرّف النموذج."],"tP5DDk": ["تطبيق الرابط"],"tUvUfp": ["استخدم مجلدًا لديك بالفعل."],@@ -4579,6 +4694,9 @@"uGaIIS": ["سحب شجرة عمل"],"uH_S-u": [["loadErrorTitle"], ": ", ["message"]],"uJfwF8": ["مثبَّت بالفعل — لا شيء جديد لاستيراده."],+ "uK2peg": [+ "يتحقق من مشروعك مقابل Open Knowledge Format. قم بإيقاف تشغيله في أي وقت في الإعدادات."+ ],"uKRYiW": ["حالة المزامنة غير متاحة — خطأ في الخادم."],"uL_Wx8": ["توقفت الطرفية على نحو غير متوقع."],"uM6jnS": ["فشلت الاستعادة"],@@ -4659,6 +4777,9 @@]],"v-h2hx": ["حذف ", ["targetGitPath"]],+ "v15iQB": [+ "عقد الحساب المصدق. ينطبق فقط على المستندات المكتوبة Attested Computation، حيث يتطلب OKF runtime؛ المفاهيم العادية لا تتأثر."+ ],"v2ZW0K": ["تفعيل الطرفية"],"v2a04T": ["قواعد markdownlint"],"v41fCm": ["الملف غير موجود"],diff --git a/packages/app/src/locales/ar/messages.po b/packages/app/src/locales/ar/messages.poindex f499be7b3..6eb961fab 100644--- a/packages/app/src/locales/ar/messages.po+++ b/packages/app/src/locales/ar/messages.po@@ -263,6 +263,11 @@ msgstr "{0, plural, zero {لا يطابق أي مستند حاليًا.} one {يmsgid "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"msgstr "{0, plural, zero {لا مشكلات في # مستند.} one {لا مشكلات في مستند واحد.} two {لا مشكلات في مستندين.} few {لا مشكلات في # مستندات.} many {لا مشكلات في # مستندًا.} other {لا مشكلات في # مستند.}}"+#. placeholder {0}: pluginRows.length+#: src/components/CreatedItemsList.tsx+msgid "{0, plural, one {Plugin} other {Plugins}}"+msgstr "{0, plural, zero {إضافات} one {إضافة} two {إضافتان} few {إضافات} many {إضافة} other {إضافة}}"+#. placeholder {0}: editorList.hiddenCount#: src/components/McpConsentDialogBody.tsxmsgid "{0, plural, one {Show # more tool} other {Show # more tools}}"@@ -629,7 +634,9 @@ msgstr "واجهة {displayName} السطرية، {hint}"msgid "{docName} is {0}. OpenKnowledge currently opens files up to {1}."msgstr "حجم {docName} هو {0}. يفتح OpenKnowledge حاليًا ملفات حتى {1}."+#. placeholder {0}: OKF_RULE_IDS.length#. placeholder {0}: entries.length+#: src/components/settings/LintingSection.tsx#: src/components/settings/markdownlint-rule-browser.tsxmsgid "{enabledCount}/{0} on"msgstr "{enabledCount}/{0} مفعَّل"@@ -792,6 +799,10 @@ msgstr "{percent}% مستخدَم ({left}% متبقٍّ)"msgid "{phase} — {pct}%"msgstr "{phase} — {pct}%"+#: src/components/CreatedItemsList.tsx+msgid "{pluginCount, plural, one {plugin} other {plugins}}"+msgstr "{pluginCount, plural, zero {إضافات} one {إضافة} two {إضافتان} few {إضافات} many {إضافة} other {إضافة}}"+#: src/components/PropertyDisclosure.tsxmsgid "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"msgstr "{problemCount, plural, zero {# خاصية لا تطابق المخطط} one {خاصية واحدة لا تطابق المخطط} two {خاصيتان لا تطابقان المخطط} few {# خصائص لا تطابق المخطط} many {# خاصيةً لا تطابق المخطط} other {# خاصية لا تطابق المخطط}}"@@ -1547,6 +1558,10 @@ msgstr "مشمول بالفعل ضمن مجلد أصل مختار"msgid "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."msgstr "هل لديك مستودع git بالفعل؟ أضفه بالأمر <0>git remote add origin <url></0> في مجلد هذا المشروع. تُحدَّث هذه الصفحة تلقائيًا بمجرد اكتشاف مستودع بعيد."+#: src/components/settings/LintingSection.tsx+msgid "Already in project"+msgstr "بالفعل في المشروع"+#: src/components/SkillPluginBundleDialog.tsxmsgid "Already installed — nothing new to import."msgstr "مثبَّت بالفعل — لا شيء جديد لاستيراده."@@ -1592,6 +1607,10 @@ msgstr "توجد عملية مزامنة أخرى قيد التنفيذ. أعدmsgid "any"msgstr "أي"+#: src/components/settings/LintingSection.tsx+msgid "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+msgstr "أي ملف .mdx. التنسيق هو .md فقط، لذا فإن القارئ الذي يبحث عن .md لا يفتحه أبدًا - وفي حالة وجود .md بنفس الاسم، يقرأه بدلاً من ذلك."+#. placeholder {0}: summary.name#: src/components/settings/LintingSection.tsxmsgid "any doc named {0}"@@ -2152,6 +2171,7 @@ msgstr "تعذّرت مشاركة هذا المسار."#: src/components/ReportBugDialogBody.tsx#: src/components/SeedDialog.tsx#: src/components/settings/LinkPreviewsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/SavedThemesTiles.tsx#: src/components/settings/SearchSection.tsx#: src/components/ShareBranchSwitchDialog.tsx@@ -2292,6 +2312,10 @@ msgstr "يجري سحب الملفات"msgid "Checking sign-in status"msgstr "يجري التحقق من حالة تسجيل الدخول"+#: src/components/settings/LintingSection.tsx+msgid "Checking skill"+msgstr "مهارة التحقق"+#: src/components/ImportSkillForm.tsxmsgid "Checking source"msgstr "يجري التحقق من المصدر"@@ -2308,6 +2332,10 @@ msgstr "يجري التحقق..."msgid "Checklist with checkboxes."msgstr "قائمة تحقق بمربعات اختيار."+#: src/components/CreatedItemsList.tsx+msgid "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+msgstr "يتحقق من مشروعك مقابل Open Knowledge Format. قم بإيقاف تشغيله في أي وقت في الإعدادات."+#: src/components/ImportSkillForm.tsxmsgid "Choose a skill archive"msgstr "اختر أرشيف مهارة"@@ -4304,6 +4332,10 @@ msgstr "تعطيل {0}"msgid "Disable {file}"msgstr "تعطيل {file}"+#: src/components/settings/LintingSection.tsx+msgid "Disable {id}"+msgstr "تعطيل {id}"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "Disable external link previews"msgstr "تعطيل معاينات الروابط الخارجية"@@ -4406,6 +4438,10 @@ msgstr "لوحات المستند"msgid "Document statistics"msgstr "إحصاءات المستند"+#: src/components/settings/LintingSection.tsx+msgid "Document structure"+msgstr "هيكل الوثيقة"+#: src/components/empty-state/use-create-suggestions.tsmsgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."msgstr "وثّق بنية هذا المستودع: أنشئ صفحة نظرة عامة ترتبط بصفحة لكل وحدة رئيسية تصف مسؤولياتها ونقاط دخولها."@@ -4797,6 +4833,10 @@ msgstr "تفعيل واجهة {displayName} السطرية"msgid "Enable {file}"msgstr "تفعيل {file}"+#: src/components/settings/LintingSection.tsx+msgid "Enable {id}"+msgstr "تمكين {id}"+#: src/components/AutoSyncOnboardingDialog.tsx#: src/components/EnableSyncConfirmDialog.tsx#: src/components/share-receive-miss-content.tsx@@ -4821,6 +4861,10 @@ msgstr "هل تفعّل المتابعة؟"msgid "Enable git auto-sync?"msgstr "هل تفعّل مزامنة git التلقائية؟"+#: src/components/settings/LintingSection.tsx+msgid "Enable indexes"+msgstr "تمكين الفهارس"+#: src/components/ProblemsPanel.tsxmsgid "Enable plugins"msgstr "تفعيل الإضافات"@@ -4849,6 +4893,10 @@ msgstr "تفعيل الطرفية لهذا المشروع"msgid "Enable Themes"msgstr "تفعيل السمات"+#: src/components/settings/LintingSection.tsx+msgid "Enabling index generation"+msgstr "تمكين إنشاء الفهرس"+#: src/components/ActivityModeContent.tsxmsgid "Ended"msgstr "انتهت"@@ -4919,6 +4967,10 @@ msgstr "خطأ:"msgid "Escape"msgstr "إفلات"+#: src/components/settings/LintingSection.tsx+msgid "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+msgstr "تحتوي كل وثيقة مفاهيمية على نوع غير فارغ. هذا هو الحد الأدنى من التوافق الخاص بـ OKF — أي المستند الذي يحتوي على نوع واحد فقط يكون متوافقًا تمامًا."+#: src/components/settings/LintingSection.tsxmsgid "every doc"msgstr "كل مستند"@@ -5694,6 +5746,10 @@ msgstr "من قالب"msgid "From the {0} plugin"msgstr "من إضافة {0}"+#: src/components/settings/LintingSection.tsx+msgid "Frontmatter"+msgstr "frontmatter"+#: src/components/TemplateForm.tsxmsgid "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."msgstr "الـ frontmatter الذي يبدأ به كل مستند يُنشأ من هذا القالب. القيم بصيغة YAML — القائمة تُكتب <0>[a, b]</0>؛ و<1>{{date}}</1> يُملأ عند الإنشاء."@@ -5736,6 +5792,10 @@ msgstr "انتهت اللعبة · اضغط مسافة للعب مرة أخرى"msgid "General"msgstr "عام"+#: src/components/settings/LintingSection.tsx+msgid "Generated files"+msgstr "الملفات التي تم إنشاؤها"+#: src/components/TerminalCliMissingBanner.tsxmsgid "Get {displayName}"msgstr "احصل على {displayName}"@@ -5769,6 +5829,10 @@ msgstr "إعداد git غير متاح"msgid "Git identity isn't set — commits use a default author. Set yours so teammates see your name."msgstr "هوية Git غير مضبوطة — تستخدم الإيداعات مؤلفًا افتراضيًا. اضبط هويتك ليرى زملاؤك اسمك."+#: src/components/settings/LintingSection.tsx+msgid "Git merge rule"+msgstr "Git قاعدة الدمج"+#: src/components/ShareBranchSwitchDialog.tsxmsgid "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."msgstr "يحتاج Git إلى {tool} لهذا المستودع، لكنه غير مثبَّت أو تعذّر العثور عليه. ثبّته، ثم أعد المحاولة."@@ -5923,7 +5987,7 @@ msgstr "heading-slug"msgid "Headings"msgstr "العناوين"-#: src/components/AutoSyncEnableWarning.tsx+#: src/components/DisclosureWarning.tsx#: src/editor/slash-command/component-items.tsxmsgid "Heads up"msgstr "تنبيه"@@ -5945,6 +6009,10 @@ msgstr "مرحبًا بالعالم!"msgid "Help"msgstr "مساعدة"+#: src/components/settings/LintingSection.tsx+msgid "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+msgstr "يساعد وكلاء الترميز في اختيار أنواع المستندات OKF والحفاظ على المصدر وتجنب اختراع بيانات تعريف غير مدعومة."+#. Subtext for the open-knowledge-discovery skill row#. Subtext for the open-knowledge-discovery skill row#: src/components/McpConsentDialogBody.tsx@@ -6277,10 +6345,18 @@ msgstr "استُورد باسم «{0}» — الاسم «{1}» كان مأخوذmsgid "Importing"msgstr "يجري الاستيراد"+#: src/components/settings/LintingSection.tsx+msgid "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+msgstr "في مستند السجل: تبدأ عناوين الإدخال بتاريخ ISO YYYY-MM-DD، الأحدث أولاً. إن عدد titles الذي تستخدمه، وما إذا كانت الإدخالات عبارة عن تعداد نقطي، هو أمر متروك لك."+#: src/components/SeedDialog.tsxmsgid "In a subfolder"msgstr "في مجلد فرعي"+#: src/components/settings/LintingSection.tsx+msgid "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+msgstr "في مستند الفهرس: توجد الإدخالات تحت عنوان القسم ويحمل كل منها رابطًا. النثر حول القوائم على ما يرام."+#: src/components/empty-state/CreatePromptComposer.tsx#: src/components/handoff/AgentSplitButton.tsx#: src/components/handoff/OpenInAgentContextSubmenu.tsx@@ -6299,6 +6375,14 @@ msgstr "داخل التطبيق"msgid "In app (beta)"msgstr "داخل التطبيق (بيتا)"+#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+msgstr "في مشاريع Git، يضيف Open Knowledge قاعدة محددة النطاق إلى ملف .gitattributes في جذر المستودع لدمج تغييرات الفهرس المتزامنة."++#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+msgstr "في مشاريع Git، يضيف Open Knowledge أيضًا قاعدة .gitattributes محددة النطاق بحيث يتم دمج تغييرات الفهرس المتزامنة قبل إعادة البناء التالية."+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "In the Claude Desktop App"msgstr "في تطبيق Claude Desktop"@@ -6323,6 +6407,26 @@ msgstr "زد أو قلّل إزاحة عنصر القائمة الحالي."msgid "Indented blockquote for citations."msgstr "اقتباس مزاح للاستشهادات."+#: src/components/settings/LintingSection.tsx+msgid "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+msgstr "لا تحمل مستندات الفهرس frontmatter، باستثناء تلك الموجودة في جذر قاعدة المعرفة الخاصة بك. لا تتم تغطية مستندات السجل — OKF لا يقيد frontmatter الخاصة بها."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+msgstr "تم إيقاف صيانة الفهرس مؤقتًا لأن سمة Git أخرى تتحكم في index.md. قم بتحديث .gitattributes بحيث تستخدم مسارات index.md المحددة النطاق merge=union، ثم حاول مرة أخرى."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+msgstr "تم إيقاف صيانة الفهرس مؤقتًا لأن Open Knowledge لم يتمكن من تأكيد قاعدة الدمج Git المطلوبة. تحقق من Git و.gitattributes، ثم حاول مرة أخرى."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+msgstr "توقفت صيانة الفهرس بسبب تعذر على Open Knowledge الوصول إلى خادم المشروع. حاول مرة أخرى عند إعادة اتصال المشروع."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+msgstr "توقفت صيانة الفهرس بسبب تعذر حفظ إعداد المشروع. تحقق من أذونات ملف المشروع، ثم حاول مرة أخرى."+#: src/components/settings/SearchSection.tsxmsgid "Indexed {embedded} of {total} pages."msgstr "تمت فهرسة {embedded} من {total} صفحة."@@ -6511,6 +6615,10 @@ msgstr "التثبيت على كل الوكلاء"msgid "Install selected"msgstr "تثبيت المحدد"+#: src/components/settings/LintingSection.tsx+msgid "Install skill"+msgstr "مهارة التثبيت"+#: src/components/SkillPluginBundleBanner.tsxmsgid "Install skills"msgstr "تثبيت المهارات"@@ -6520,6 +6628,7 @@ msgid "Install the gh CLI"msgstr "ثبّت واجهة gh السطرية"#: src/components/settings/AiToolsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ProjectAiToolsSection.tsx#: src/components/SkillEditorActions.tsxmsgid "Installed"@@ -6733,6 +6842,10 @@ msgstr "أبقِ هذا المشروع متزامنًا مع مستودعك الmsgid "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."msgstr "تتبّع الأشخاص والشركات التي تعمل معها والاجتماعات التي تعقدها معهم. مناسب لتذكّر من يكون أحدهم، وكيف تعرفه، وآخر ما تحدثتما عنه."+#: src/components/settings/LintingSection.tsx+msgid "Keeps your knowledge base aligned with the Open Knowledge Format."+msgstr "يحافظ على توافق قاعدة معارفك مع Open Knowledge Format."+#. placeholder {0}: toName.trim()#: src/components/SkillForkDialog.tsxmsgid "Kept both — \"{0}\" is its own skill now"@@ -7108,6 +7221,14 @@ msgstr "يجري البحث عن <0>{lookingForUrl}</0>."msgid "Lost connection to \"{docName}\"."msgstr "فُقد الاتصال بـ «{docName}»."+#: src/components/settings/LintingSection.tsx+msgid "Maintain generated indexes in every folder?"+msgstr "هل تريد الحفاظ على فهارس generated في كل مجلد؟"++#: src/components/settings/LintingSection.tsx+msgid "Maintain index.md"+msgstr "الحفاظ على index.md"+#: src/components/SkillInstallMenu.tsxmsgid "make source"msgstr "جعله المصدر"@@ -8252,6 +8373,10 @@ msgstr "OK Desktop"msgid "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."msgstr "ضبط OK هذا المجلد آخر مرة على {0} — وقد غيّره شيء خارج OK منذ ذلك الحين. الحالة المعروضة هي ما على القرص الآن؛ وعملية الربط أو فك الربط التالية لديك هي التي تسود."+#: src/components/settings/LintingSection.tsx+msgid "OKF agent skill installed"+msgstr "OKF تم تثبيت مهارة الوكيل"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "On — hovering an external link sends its URL to the destination site to fetch a preview."msgstr "مفعّل — تمرير المؤشر فوق رابط خارجي يرسل رابطه إلى الموقع الوجهة لجلب معاينة."@@ -8268,6 +8393,10 @@ msgstr "على <0>{address}</0>"msgid "On selected text in <0>{address}</0>"msgstr "على النص المحدد في <0>{address}</0>"+#: src/components/settings/LintingSection.tsx+msgid "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+msgstr "في الفهرس الجذري، تتم كتابة okf_version كسلسلة مقتبسة مثل \"0.2\". بدون اقتباس، يقرأه YAML كرقم ويصبح 0.10 بصمت 0.1."+#. Next step for a Cursor project MCP row — Cursor leaves project servers disabled#: src/components/settings/ProjectAiToolsSection.tsxmsgid "One more step: enable it in Cursor → Settings → Tools & MCP (Cursor leaves project servers off until you turn them on)."@@ -8490,6 +8619,22 @@ msgstr "الفتح في شجرة عمل"msgid "Open it there"msgstr "افتحه هناك"+#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+msgstr "يقوم Open Knowledge بإنشاء ملف تنقل يسمى index.md والحفاظ عليه في كل مجلد يحتوي على Markdown."++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge Format guidance"+msgstr "Open Knowledge Format التوجيه"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+msgstr "يحتفظ Open Knowledge بملف تنقل يسمى index.md في كل مجلد يحتوي على Markdown، حيث يسرد كل منها مستندات هذا المجلد حسب النوع ويرتبط بمجلداته الفرعية. فهو يعيد كتابة هذه الملفات مع تغير مستنداتك، ويتم استبدال أي شيء تقوم بتحريره فيها بنفسك."++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+msgstr "يقوم Open Knowledge بإعادة كتابة ملفات index.md هذه مع تغير المستندات، لذلك يتم استبدال التعديلات اليدوية عليها."+#. placeholder {0}: item.displayName#. placeholder {1}: item.displayName#. placeholder {2}: item.version@@ -8536,6 +8681,10 @@ msgstr "فتح الإعدادات"msgid "Open shared {targetNoun}"msgstr "فتح {targetNoun} المشترك"+#: src/components/settings/LintingSection.tsx+msgid "Open skill"+msgstr "مهارة مفتوحة"+#: src/editor/extensions/JsxComponentView.tsxmsgid "Open source doc: {mirrorSrc}"msgstr "فتح مستند المصدر: {mirrorSrc}"@@ -9372,6 +9521,7 @@ msgid "project"msgstr "مشروع"#: src/components/CommandPalette.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ScopeBadge.tsx#: src/lib/skill-scope.tsmsgid "Project"@@ -9643,6 +9793,10 @@ msgstr "مشروع حديث"msgid "Recently opened"msgstr "فُتح مؤخرًا"+#: src/components/settings/LintingSection.tsx+msgid "Recommended agent skill"+msgstr "مهارة الوكيل الموصى بها"+#: src/components/SyncStatusBadge.tsxmsgid "Reconnect required"msgstr "إعادة الاتصال مطلوبة"@@ -10080,6 +10234,10 @@ msgstr "ابحث في انقراض الطيور غير القادرة على اmsgid "research-note"msgstr "research-note"+#: src/components/settings/LintingSection.tsx+msgid "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+msgstr "تتم تسمية الملفات المحجوزة index.md وlog.md بأحرف صغيرة. في نظام الملفات الحساس لحالة الأحرف، تتم قراءة Index.md كمستند عادي ويفقد معناه."+#: src/components/settings/CustomThemeEditor.tsxmsgid "Reset"msgstr "إعادة تعيين"@@ -10322,6 +10480,7 @@ msgid "Rule editing is available for the project's root markdownlint config"msgstr "تحرير القواعد متاح لإعداد markdownlint في جذر المشروع"#: src/components/LintConfigEditor.tsx+#: src/components/settings/LintingSection.tsxmsgid "Rules"msgstr "القواعد"@@ -11264,6 +11423,10 @@ msgstr "لم يتم تثبيت المهارة «{conflictName}» على {conflicmsgid "Skill \"{name}\" created"msgstr "أُنشئت المهارة «{name}»"+#: src/components/settings/LintingSection.tsx+msgid "Skill already in project"+msgstr "المهارة موجودة بالفعل في المشروع"+#: src/components/ExploreSkills.tsxmsgid "Skill discovery powered by <0>skills.sh</0>"msgstr "اكتشاف المهارات مدعوم بـ <0>skills.sh</0>"@@ -11523,6 +11686,10 @@ msgstr "البدء من"msgid "Start here: what this is and how it's organized."msgstr "ابدأ من هنا: ما هذا وكيف نُظِّم."+#: src/components/settings/LintingSection.tsx+msgid "Start maintaining index.md"+msgstr "ابدأ في صيانة index.md"+#: src/lib/keyboard-shortcuts.tsmsgid "Start source completion"msgstr "بدء إكمال المصدر"@@ -11618,6 +11785,10 @@ msgstr "إيقاف إصلاح الملفات"msgid "Stop fixing. Files already fixed stay fixed."msgstr "أوقف الإصلاح. تبقى الملفات المُصلَحة بالفعل كما هي."+#: src/components/settings/LintingSection.tsx+msgid "Stop maintaining index.md"+msgstr "توقف عن صيانة index.md"+#: src/lib/project-fix-sweep-store.tsmsgid "Stopped fixing. Files already fixed stay fixed."msgstr "توقف الإصلاح. تبقى الملفات المُصلَحة بالفعل كما هي."@@ -12121,6 +12292,10 @@ msgstr "الوكيل لا يتوقف. الإيقاف القسري يغلق هذmsgid "The agent's persona, values, and voice."msgstr "شخصية الوكيل وقيمه ونبرته."+#: src/components/settings/LintingSection.tsx+msgid "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+msgstr "عقد الحساب المصدق. ينطبق فقط على المستندات المكتوبة Attested Computation، حيث يتطلب OKF runtime؛ المفاهيم العادية لا تتأثر."+#: src/components/ProblemsPanel.tsxmsgid "The audit could not be completed. Try again."msgstr "تعذّر إتمام المراجعة. أعد المحاولة."@@ -12179,6 +12354,10 @@ msgstr "تُعرض الصيغة <0>c = √(a² + b²)</0> مضمَّنة."msgid "the git exclude file isn't writable"msgstr "ملف استثناءات git غير قابل للكتابة"+#: src/components/settings/LintingSection.tsx+msgid "The index files stay in place. Open Knowledge removes only the Git rule it added."+msgstr "تظل ملفات الفهرس في مكانها. Open Knowledge يزيل فقط القاعدة Git التي أضافها."+#: src/lib/locale-load-failure-notice.tsmsgid "The interface is still in the language you were reading. Check your connection, then reload to try again."msgstr "لا تزال الواجهة باللغة التي كنت تقرأ بها. تحقّق من اتصالك، ثم أعد التحميل للمحاولة مرة أخرى."@@ -12215,6 +12394,10 @@ msgstr "كتلة الخصائص أعلى هذا المستند بها خطأ تmsgid "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."msgstr "تغيّرت الخصائص، لكن تعذّرت المقارنة — لم يُحلَّل YAML. تُعرض النسختان كما كُتبتا."+#: src/components/settings/LintingSection.tsx+msgid "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+msgstr "عائلات المصدر والثقة ودورة الحياة: sources، generated، verified، status، وstale_after. كل حقل اختياري، والغياب ليس خطأ أبدًا."+#: src/components/settings/SearchSection.tsxmsgid "The provider is rate-limiting this key. Try again in a moment."msgstr "المزوّد يحدّ من معدل استخدام هذا المفتاح. أعد المحاولة بعد قليل."@@ -12252,6 +12435,10 @@ msgstr "ملف المخطط غير موجود أو فشل تحميله — إضmsgid "the server responded but server.lock has no port yet"msgstr "استجاب الخادم لكن server.lock لا يحتوي على منفذ بعد"+#: src/components/settings/LintingSection.tsx+msgid "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+msgstr "أشكال title وdescription وresource وtags عند استخدامها. لا شيء مطلوب. الإعلان عن نوع واحد فقط، لذلك يتم وضع علامة على tags المكتوب كسلسلة مفصولة بفواصل."+#: src/components/SkillInstallMenu.tsxmsgid "The skill's own folder — the source other locations copy or link from"msgstr "مجلد المهارة نفسه — المصدر الذي تنسخ منه المواقع الأخرى أو ترتبط به"@@ -12565,6 +12752,10 @@ msgstr "قد يستغرق هذا لحظة. يُحتفظ بمحتوى Markdown لmsgid "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."msgstr "ينقل هذا <0>{name}</0> من {0} إلى {1}، فيغيّر موقع ملفاتها على القرص ويعيد تثبيتها في محرراتك عند المستوى {2}."+#: src/components/settings/LintingSection.tsx+msgid "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+msgstr "يحتاج هذا إلى رؤية ملفاتك، وليس فقط المستند المفتوح، لذلك يظهر عند تشغيل تدقيق المشروع وليس أثناء الكتابة."+#: src/components/SeedDialog.tsxmsgid "This pack is already set up here."msgstr "هذه الحزمة مُعدّة هنا بالفعل."@@ -12928,6 +13119,10 @@ msgstr "أعِد {0} إلى مجلد حقيقي يحوي رابطًا رمزيًmsgid "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."msgstr "أعِد {display} إلى مجلد حقيقي يحوي رابطًا رمزيًا لكل مهارة يراها حاليًا — لا شيء يتوقف عن العمل، وتتولى قائمة كل مهارة إدارتها من هناك."+#: src/components/CreatedItemsList.tsx+msgid "Turn it off any time in Settings."+msgstr "قم بإيقاف تشغيله في أي وقت في الإعدادات."+#: src/components/NotInSidebarIndicator.tsxmsgid "Turn off Only markdown files"msgstr "إيقاف «ملفات Markdown فقط»"@@ -12953,6 +13148,10 @@ msgstr "هل تشغّل البحث الدلالي؟"msgid "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."msgstr "حوّل ما تقرأه إلى مقالات واضحة موثوقة. احفظ مصدرًا، واستخلص معناه، ثم أبقِ النسخة النهائية لتعتمد عليها لاحقًا."+#: src/components/settings/LintingSection.tsx+msgid "Turning it off"+msgstr "إيقاف تشغيله"+#: src/components/acp/working-status.tsmsgid "Turning it over…"msgstr "يجري تقليب الفكرة…"@@ -13643,6 +13842,10 @@ msgstr "رابط ويكي"msgid "Wiki link suggestions"msgstr "اقتراحات روابط الويكي"+#: src/components/settings/LintingSection.tsx+msgid "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+msgstr "روابط Wiki مثل [[Page]] — طريقة مدعومة للربط هنا، لكن القارئ الخارجي لا يحل أي شيء ويعرض الأقواس."+#: src/components/PublishToGitHubDialog.tsxmsgid "Will be created as <0>{sanitizedName}</0>"msgstr "سيُنشأ باسم <0>{sanitizedName}</0>"diff --git a/packages/app/src/locales/bn/messages.json b/packages/app/src/locales/bn/messages.jsonindex 14c443329..797f8a512 100644--- a/packages/app/src/locales/bn/messages.json+++ b/packages/app/src/locales/bn/messages.json@@ -117,6 +117,9 @@"0ySP5u": ["পরিবর্তনগুলি এই থিমে স্বয়ংক্রিয়ভাবে সংরক্ষিত হয়।"],"0zAhu6": ["প্রতিটি নথি"],"10g8I_": ["কেবল markdown ফাইল বন্ধ করুন"],+ "110eEb": [+ "Open Knowledge Markdown ধারণকারী প্রতিটি ফোল্ডারে index.md নামের একটি নেভিগেশন ফাইল তৈরি ও রক্ষণাবেক্ষণ করে।"+ ],"11ukmX": ["নাম বদলানো ব্যর্থ: ", ["0"]],"12F9WL": ["(কোনো id নেই)"],"151wvk": ["সাইডবার দেখান"],@@ -134,6 +137,9 @@"1GhYxC": [["totalPages"], "-এর মধ্যে"],"1HBhDS": ["ফাইল চেক আউট করা হচ্ছে"],"1J0c0X": [["displayName"], "-এ এখনও পৌঁছানো যায়নি। আর একবার চেষ্টা করবেন?"],+ "1JpLgH": [+ "একটি সূচক নথিতে: এন্ট্রিগুলি একটি বিভাগের শিরোনামের নীচে বসে এবং প্রতিটি একটি লিঙ্ক বহন করে। তালিকার চারপাশে গদ্য ঠিক আছে।"+ ],"1LtA5r": ["স্কিলটি ", ["path"], "-এ সিমলিংক করে"],"1MGRQl": ["টার্মিনাল সেশন"],"1NgrlY": ["ইনস্টল করার অন্যান্য উপায়"],@@ -147,6 +153,7 @@"1XSMhZ": ["<0>শুধু-স্থানীয়</0>-তে যাওয়া তখন পর্যন্ত প্রত্যাখ্যাত হবে যতক্ষণ না সেগুলো<1> git rm --cached</1> দিয়ে হিসাবের বাইরে নেওয়া হয়।"],+ "1ZXkqM": ["সেটিংস থেকে যেকোনো সময় এটি বন্ধ করুন।"],"1ZpfyB": ["AI ", ["displayName"], " দিয়ে খুলুন, ", ["hint"]],"1a6ICf": ["এজেন্টের সম্পাদনা অনুসরণ করা হচ্ছে"],"1bDVu5": ["ওয়ার্কস্পেস কমান্ড প্যালেট"],@@ -285,6 +292,8 @@"3o3tur": ["শুরুর বিষয়বস্তু"],"3oh0nQ": [["path"], "-এ নেস্টেড .okignore ত্রুটি"],"3pU8e-": ["ট্যাব পিন করুন"],+ "3qDsdf": ["দক্ষতা ইনস্টল করুন"],+ "3ri_4O": ["আপনার জ্ঞানভান্ডারকে Open Knowledge Format-এর সঙ্গে সামঞ্জস্যপূর্ণ রাখে।"],"3s-k7L": [["0", "plural", { "one": ["আরও ", "#", " টুল দেখান"], "other": ["আরও ", "#", " টুল দেখান"] }]],@@ -420,6 +429,9 @@],"5tcmwY": ["মান যোগ করুন"],"5vAI6Z": ["এটি আমার কর্মপ্রবাহে খাপ খায়নি"],+ "5w38tn": [+ "সূচী রক্ষণাবেক্ষণ বন্ধ ছিল কারণ Open Knowledge প্রকল্প সার্ভারে পৌঁছাতে পারেনি। প্রজেক্ট পুনরায় সংযোগ করলে আবার চেষ্টা করুন।"+ ],"5wV2qQ": ["এবং আরও"],"5y_9lO": ["অনুমোদনের অপেক্ষা"],"6-wLTJ": ["origin থেকে ", ["behind"], " পিছিয়ে"],@@ -550,6 +562,7 @@"7d1a0d": ["সর্বজনীন"],"7dZnmw": ["প্রাসঙ্গিকতা"],"7hctf2": ["আপনি যে প্রকল্পটি তৈরি করতে চান তার বর্ণনা দিন"],+ "7idx48": ["OKF এজেন্ট দক্ষতা ইনস্টল করা হয়েছে"],"7jIIFX": ["আপনার সব প্রস্তুত!"],"7kb4LU": ["অনুমোদিত"],"7l15X4": ["ব্যর্থ"],@@ -557,6 +570,7 @@"7m3Ade": ["ইনস্টল:"],"7qRHf0": ["Claude Chat ও Cowork-এর জন্য ইনস্টল করুন"],"7uBlRT": ["ফোকাস করা ফাইল-ট্রি আইটেমটি কপি করুন যাতে Paste সেটির প্রতিলিপি বানাতে পারে।"],+ "7wogIQ": [["0", "plural", { "one": ["প্লাগইন"], "other": ["প্লাগইন"] }]],"80c4-P": ["কোড ক্লিপবোর্ডে কপি হয়েছে"],"81H_23": ["প্রপার্টি যোগ করুন"],"851WA-": ["এটি Settings > AI tools & CLI-তে কনফিগার করা যায়"],@@ -610,6 +624,7 @@"8nWu1k": ["খালি চিত্র"],"8oWgty": ["পাঠানোর জন্য সব মন্তব্য চিহ্নিত করুন"],"8qgfac": ["MCP সার্ভার"],+ "8rZ1pk": [["id"], " সক্ষম করুন"],"8ruqQi": ["ভাঙা অভ্যন্তরীণ লিংক"],"8sMErm": ["Follow চালু করবেন?"],"8t9CRE": [["agentName"], " শুরু করা হচ্ছে…"],@@ -782,6 +797,9 @@"BQKHuL": ["টার্মিনাল পুনরায় চালু করুন"],"BQu9Pg": ["সিমলিংক"],"BUyQnq": ["সার্ভার পুনরায় চালু করা যায়নি। এই ফোল্ডারে `ok start` চেষ্টা করুন।"],+ "BVkqD9": [+ "সূচী রক্ষণাবেক্ষণ বিরাম দেওয়া হয়েছে কারণ অন্য Git বৈশিষ্ট্য নিয়ন্ত্রণ করে index.md। .gitattributes আপডেট করুন যাতে স্কোপযুক্ত index.md পাথগুলি merge=union ব্যবহার করে, তারপর আবার চেষ্টা করুন।"+ ],"BY-g4_": ["প্যাটার্ন যোগ করুন"],"Ba4D2x": ["টেমপ্লেট আমদানি করা হয়েছে"],"Bdha5y": ["প্রকাশ করা হচ্ছে…"],@@ -800,6 +818,7 @@"Bv5a9_": ["নির্বাচনের পরিসংখ্যান"],"Bx4EXG": [["label"], "-এর জন্য ক্রিয়া"],"By-7Pn": ["বুলেট তালিকা চালু বা বন্ধ করুন।"],+ "ByIOcK": ["ইনডেক্স ফাইলগুলি জায়গায় থাকে। Open Knowledge শুধুমাত্র এটি যোগ করা Git নিয়মটিকে সরিয়ে দেয়।"],"BymzO4": ["নথির রূপরেখা"],"C-mmmK": ["আপনার এন্ডপয়েন্ট যে মডেল id দেয়। এর ভেক্টরের আকার নিজে থেকেই শনাক্ত হয় — ",@@ -841,6 +860,9 @@"<0>~/.ok/bin</0> ও <1>~/.ok/env.sh</1> দুই ক্ষেত্রেই থেকে যায় — অ্যাপ সবসময় সেগুলো রক্ষণাবেক্ষণ করে।"],"CXTwen": ["এই প্রকল্পের কনফিগ নিরাপদে সম্পাদনা করা যাচ্ছে না"],+ "CXcveY": [+ "Open Knowledge Markdown ধারণকারী প্রতিটি ফোল্ডারে index.md নামের একটি নেভিগেশন ফাইল রক্ষণাবেক্ষণ করে, প্রতিটি ফোল্ডারের নথিগুলিকে টাইপ এবং তার সাবফোল্ডারের সাথে লিঙ্ক করে তালিকাভুক্ত করে। আপনার নথি পরিবর্তনের সাথে সাথে এটি এই ফাইলগুলিকে পুনরায় লিখবে, এবং আপনি নিজে এগুলিতে সম্পাদনা করা সমস্ত কিছু প্রতিস্থাপিত হবে৷"+ ],"CXj9C-": ["নতুন প্রপার্টির নাম"],"C_Lyvh": ["থিমের সেটিং সংরক্ষণ করতে ব্যর্থ"],"C_WGy8": [@@ -864,6 +886,9 @@"Cu6GXQ": ["উৎস ফোল্ডারটি নিজে সরে না।"],"CvsD6Y": [["viaTags"], "-এর মাধ্যমে"],"CwOXMT": [["keyName"], "-এর মান"],+ "CxCOFx": [+ "Git প্রকল্পে, Open Knowledge রিপোজিটরির রুটের .gitattributes ফাইলে একটি সীমিত নিয়ম যোগ করে, যাতে একই সময়ে হওয়া ইনডেক্স পরিবর্তনগুলো একত্রিত হয়।"+ ],"CxVk-w": [["address"], "-এ মন্তব্য"],"D-NlUC": ["সিস্টেম"],"D-Oh1s": [["0"], " কীভাবে সেট আপ করবেন (ব্রাউজারে খোলে)"],@@ -922,6 +947,9 @@"DhT_PK": ["OpenKnowledge একটি স্কিল আমদানি করেছে"],"DiFKSL": ["markdown ফাইল গণনা করা হচ্ছে"],"DiZ3pq": ["আইকন নির্বাচক"],+ "DjNcDy": [+ "title, description, resource, এবং tags এর আকার আপনি যখন ব্যবহার করেন। কোনটির প্রয়োজন নেই; একটি ঘোষণা করলে শুধুমাত্র তার টাইপ পিন হয়, তাই tags একটি কমা-বিচ্ছিন্ন স্ট্রিং হিসাবে ফ্ল্যাগ করা হয়।"+ ],"DmkTrb": ["এই থিম তৈরি করা যায়নি। আবার চেষ্টা করুন।"],"Dnn2XG": ["স্বয়ংক্রিয়"],"DpjYd6": ["অ্যাংকর করা লেখায় যান"],@@ -1133,6 +1161,9 @@"GNkUvW": ["সারিতে — এই কাজ শেষ হলে পাঠানো হবে"],"GQ3O42": ["ট্র্যাশ"],"GQDSBN": ["বিন্যাসের বিকল্প"],+ "GROUfG": [+ "যেকোনো .mdx ফাইল। বিন্যাসটি হল .md-শুধু, তাই .md-এর জন্য স্ক্যান করা পাঠক কখনই এটি খোলে না — এবং যদি একই নামের একটি .md বিদ্যমান থাকে, তাহলে সেটিকে পড়ে।"+ ],"GSYWCm": ["নথি প্যানেল লুকান"],"GUYwCr": ["বিজ্ঞপ্তি সরিয়ে দিন"],"GUZHkL": ["প্যালেটের রং অনুপস্থিত"],@@ -1283,6 +1314,7 @@"IxHMdF": ["ওই মন্তব্যটি মুছে ফেলা যায়নি।"],"IxyZXD": ["স্ক্রিনশট"],"Izh19j": [["tail"], " থেকে পড়া হচ্ছে"],+ "J0uRhj": ["দক্ষতা পরীক্ষা করা"],"J1XRO3": ["থিমের রং"],"J2Mv98": ["নাম (যেমন ", ["login"], ")"],"J2_JuX": ["কিছুই নয় (", ["0"], " কোনো নথির সঙ্গে মিলতে পারে না)"],@@ -1303,6 +1335,7 @@"JHf6qZ": ["[email protected]"],"JJcBCm": ["মোট ", ["0"]],"JK-Ave": ["থাম্বনেইল লুকান"],+ "JKXcOi": ["ইতিমধ্যে প্রকল্পে"],"JL3si7": ["হালনাগাদ করা হচ্ছে"],"JLUTgi": ["এখনও কোনো ট্যাগ নেই — সূচি ভরাতে যেকোনো নথিতে `#tagname` লিখুন।"],"JLzQi_": [["accessibleLabel"], " বন্ধ করুন"],@@ -1392,6 +1425,9 @@"L-rMC9": ["ডিফল্টে রিসেট করুন"],"L1BQTH": [["0"], " এখনও ইনস্টল করা নেই — এর ডাউনলোড পাতা খোলা হচ্ছে।"],"L1ZE3M": ["নথির পরিসংখ্যান"],+ "L3BcJ4": [+ "এটির জন্য আপনার ফাইলগুলি দেখতে হবে, শুধু খোলা নথি নয়, তাই এটি প্রদর্শিত হয় যখন আপনি টাইপ করার পরিবর্তে একটি প্রকল্প অডিট চালান।"+ ],"L3CEC1": ["এই আইটেমটি"],"L3w0_C": ["একটি নথিকে আলাদা উইন্ডোতে স্লাইড ডেক হিসেবে উপস্থাপন করুন। নথির frontmatter-এ <0>slides: true</0> যোগ করুন, তারপর Slidev অ্যাকশন দিয়ে খুলুন। রেন্ডারিং করে Slidev CLI, যা OpenKnowledge সরবরাহ করে না।"@@ -1849,6 +1885,12 @@"R6ABfU": ["সরাসরি কাজ করুন, কোনো পরিকল্পনা ধাপ নেই"],"R9IDFz": ["ডিস্কে ফোল্ডারের নাম এবং এজেন্টরা এটি ডাকতে যে id ব্যবহার করে দুটোই বদলে দেয়।"],"R9dK63": ["নমুনা ছবি"],+ "RB_g_C": [+ "রুট ইনডেক্সে, okf_version একটি উদ্ধৃত স্ট্রিং হিসাবে লেখা হয় যেমন \"0.2\"। উদ্ধৃতিহীন, YAML এটিকে একটি সংখ্যা হিসাবে পড়ে এবং 0.10 নিঃশব্দে 0.1 হয়ে যায়।"+ ],+ "RD6H9q": [+ "Open Knowledge এই index.md ফাইলগুলিকে দস্তাবেজগুলি পরিবর্তন করার সাথে সাথে পুনঃলিখন করে, তাই তাদের ম্যানুয়াল সম্পাদনাগুলি প্রতিস্থাপিত হয়৷"+ ],"RDjuBN": ["সেটআপ"],"RDrXh4": ["ব্যবহারকারী, প্রকল্প ও সংযুক্তির সেটিং কনফিগার করুন।"],"RG3yW6": ["এই থিমের জন্য একটি নাম লিখুন।"],@@ -1918,6 +1960,9 @@"SF9qpO": ["পরবর্তী যোগাযোগের জন্য আপনার ইমেইল দিন"],"SFEWV6": ["OpenKnowledge স্কিল লোড করা যায়নি। আবার চেষ্টা করুন।"],"SFN6dN": ["শিরোনাম ৩"],+ "SIPelo": [+ "সূচী রক্ষণাবেক্ষণ বিরাম দেওয়া হয়েছে কারণ Open Knowledge প্রয়োজনীয় Git মার্জ নিয়ম নিশ্চিত করতে পারেনি। Git এবং .gitattributes চেক করুন, তারপর আবার চেষ্টা করুন।"+ ],"SInSnF": ["রেফারেন্স <0>", ["0"], "</0>"],"SItQRc": ["OpenKnowledge আপনার কেমন লাগছে?"],"SOPwPh": ["এই সম্পাদনায় ফিরিয়ে আনুন"],@@ -2225,6 +2270,7 @@"X7u0xR": [["0"], "টি টেমপ্লেট আছে"],"X8kjQX": ["GitHub-এর সঙ্গে আবার প্রমাণীকরণ করুন"],"X9VpsP": ["ফোল্ডারের বিষয়বস্তু লোড হচ্ছে"],+ "XAnapw": ["Git মার্জ নিয়ম"],"XAyxsa": ["রিমোট ব্রাঞ্চ চেক আউট করুন"],"XBBZnv": ["লিংকের লক্ষ্য \"", ["shown"], "\" কোনো বিদ্যমান নথিকে নির্দেশ করে না।"],"XBgr2S": ["এখানে কপি করুন"],@@ -2346,6 +2392,9 @@"Y_iImT": ["সমাধান করা যায় না এমন ফাইল ", ["identity"], "। রেফারেন্সে যান।"],"Y_kL7X": ["সম্পাদক কেমন দেখাবে ও কেমন আচরণ করবে তা নিজের মতো সাজান।"],"Ya3PlJ": ["অনুমতি প্রয়োজন"],+ "YaVU2F": [+ "Git প্রকল্পে, Open Knowledge একটি স্কোপড .gitattributes নিয়ম যোগ করে যাতে পরবর্তী পুনর্নির্মাণের আগে সমবর্তী সূচক পরিবর্তনগুলি একত্রিত হয়।"+ ],"YaeyFh": ["টানলে আপনার স্থানীয় ফাইলের কমিট না করা সম্পাদনা মুছে যেতে পারে।"],"Yb82LN": ["আইডি: ", ["0"]],"Yea-K5": ["এই বিন্দুতে ফিরিয়ে আনুন"],@@ -2471,6 +2520,7 @@"_Bix3-": [["localizedFirstMessage"], "-এর উপস্থিতিগুলি"],"_DwR-n": ["তৈরি হচ্ছে…"],"_FLBbi": [["sizeText"], " · গোপন তথ্য সরানো হয়েছে · ক্র্যাশ ডাম্প থেকে সরানো হয়নি"],+ "_G7A92": ["index.md বজায় রাখুন"],"_GRWOJ": ["এমবেডিং সরবরাহকারী বদলাবেন?"],"_HgF9q": ["এই অনুযায়ী সাজান"],"_IGfXZ": ["গতবার OpenKnowledge অপ্রত্যাশিতভাবে বন্ধ হয়ে গিয়েছিল।"],@@ -2555,10 +2605,12 @@"এজেন্ট সেবার সঙ্গে যুক্ত হওয়া যায়নি। নিশ্চিত করুন OpenKnowledge সার্ভার চলছে ও হালনাগাদ আছে (আগে থেকে চললে সেটি পুনরায় চালু করুন), তারপর আবার চেষ্টা করুন।"],"aalx4E": ["ভাঙা MDX সোর্স সম্পাদনা করা হচ্ছে: ", ["reason"]],+ "aatPoi": ["জেনারেটেড ফাইল"],"abiHje": ["নির্বাচিত আইটেম মুছুন"],"adsMWO": ["ডেল্টা মীমাংসা করা হচ্ছে"],"ah_ekO": ["\"", ["name"], "\" ইতিমধ্যেই হালনাগাদ"],"aiArms": ["আমরা এই রিপোজিটরিটি ক্লোন করতে পারিনি।"],+ "aiOceC": ["সূচী সক্রিয় করুন"],"ajHi4O": ["স্বয়ংক্রিয় সিঙ্ক থেমে আছে — এই রিপোজিটরিতে পুশ করার অনুমতি আপনার নেই। হালনাগাদ পেতে থাকতে Follow-এ যান।"],@@ -2681,11 +2733,13 @@],"cb-0G0": ["রং সরান"],"ccNps_": ["কেবল পরিবর্তিত"],+ "cd3THN": ["নথি কাঠামো"],"cd5EXh": ["একটি বাগ জানান"],"cdm00A": ["কোনো আগত নেই"],"cdmk8A": ["কমিট না করা পরিবর্তন"],"cgl-gn": ["GitHub-এর সঙ্গে যুক্ত হয়েছে"],"chL5IG": ["সম্প্রদায়"],+ "ciozf1": ["ইতিমধ্যে প্রকল্পে দক্ষতা"],"cjtjry": ["OpenKnowledge-এর নেভিগেশন ইতিহাসে পিছনে যান।"],"cklVjM": ["কালানুক্রম"],"clJ3qM": ["সম্পন্ন।"],@@ -2855,6 +2909,7 @@"fbdLmk": ["গাঢ় বিন্যাস চালু বা বন্ধ করুন।"],"fbsiBw": ["টার্মিনাল চালু করার সময় কিছু একটা ভুল হয়েছে।"],"fcgvCA": ["Claude"],+ "fdKQAE": ["এটা বন্ধ করা"],"fdeFfN": ["(বাইনারি ফাইল, প্রাকদর্শন করা যায় না)"],"fevEu0": ["সর্বশেষ পরিবর্তন টানুন"],"ffH3Rt": ["মন্তব্য যোগ করুন (Enter)"],@@ -2923,12 +2978,16 @@"gUx34c": ["OpenKnowledge যে ভাষায় কথা বলে; সিস্টেম আপনার অপারেটিং সিস্টেমকে অনুসরণ করে। আপনার নিজের নোট যে ভাষায় লিখেছেন সেই ভাষাতেই থাকবে।"],+ "gVMkEr": [+ "একটি লগ নথিতে: এন্ট্রি শিরোনাম একটি ISO YYYY-MM-DD তারিখ সহ, নতুন প্রথম। আপনি কতগুলি title ব্যবহার করবেন এবং এন্ট্রিগুলি বুলেট কিনা তা আপনার উপর নির্ভর করে।"+ ],"gY7wnY": [["agentName"], "-এ সাইন ইন করা হচ্ছে…"],"gYz2ep": [["timeLabel"], "-এ মেয়াদ শেষ"],"gZElfU": [["1"], "টির মধ্যে ", ["0"], "টি ফাইল ঠিক করা হচ্ছে"],"gZiT5e": ["এই সিমলিংকগুলো স্বতন্ত্র অনুলিপি দিয়ে বদলাবেন?"],"gayL_Q": ["প্রকাশের পরিকল্পনা"],"gbHcbI": ["প্রপার্টি মুছতে ব্যর্থ"],+ "gfYI3o": ["নিষ্ক্রিয় করুন ", ["id"]],"gfb-CM": ["ব্রাঞ্চ আনা যায়নি — GitHub-এ সাইন ইন করে আবার চেষ্টা করুন।"],"gfdqcY": ["পরিবর্তনটি প্রয়োগ করা যায়নি: ", ["0"]],"gfohmY": ["টুল যুক্ত করুন"],@@ -2981,6 +3040,9 @@"hLKfZe": ["বদলে একটি টোকেন ব্যবহার করুন"],"hLod4_": ["টেমপ্লেটে রূপান্তর করুন"],"hLy8b1": ["সংস্করণ ", ["version"], "-এ হালনাগাদ হয়েছে"],+ "hPQBsa": [+ "সংরক্ষিত ফাইলের নাম index.md এবং log.md ছোট হাতের অক্ষরে। একটি কেস-সংবেদনশীল ফাইল সিস্টেমে, Index.md একটি সাধারণ নথি হিসাবে পড়া হয় এবং এর অর্থ হারায়।"+ ],"hQXiDc": ["ব্রাঞ্চ খুঁজুন…"],"hQjvzi": ["একটি .zip বা .skill আর্কাইভ।"],"hS0wC4": ["OpenKnowledge ", ["subject"], " এর একটি পূর্ববর্তী সংস্করণ পুনরুদ্ধার করেছে"],@@ -3116,6 +3178,9 @@"iy64Li": ["পূর্ণ সিঙ্ক — আপনার সম্পাদনা নিজে থেকেই কমিট হয়ে আপনার রিমোটে পাঠানো হয়।"],"iycx_A": ["পাঠানো হচ্ছে"],"iz1LdD": ["OK শেষবার এখানে লেখার পর বাইরে থেকে বদলানো হয়েছে — দেখানো অবস্থাটি এখন ডিস্কে যা আছে তাই"],+ "j-o6Z2": [+ "সূচী রক্ষণাবেক্ষণ বন্ধ ছিল কারণ প্রকল্প সেটিং সংরক্ষণ করা যায়নি। প্রকল্প ফাইল অনুমতি পরীক্ষা করুন, তারপর আবার চেষ্টা করুন."+ ],"j15ZSH": ["মন্তব্য পাঠান"],"j2229h": ["OpenKnowledge-এর ফাইল সরানো হচ্ছে…"],"j2kt1j": [@@ -3199,6 +3264,7 @@"k4CuuV": ["দ্রুত শুরু করার জন্য তৈরি ফোল্ডার ও টেমপ্লেট। কী তৈরি হবে তার প্রাকদর্শন দেখতে একটি প্যাক নির্বাচন করুন, তারপর সেটি আপনার প্রকল্পে যোগ করুন।"],+ "k5rKNs": ["frontmatter"],"k7Hoig": ["এই সংস্করণে বিষয়বস্তুর কোনো পরিবর্তন নেই।"],"k8xtrB": ["<0>",@@ -3238,7 +3304,9 @@"kV2YZv": ["<0>Skills</0> দেখতে পাচ্ছেন না? আগে <1>Settings <2/> Capabilities <3/> Code execution and file creation</1> চালু করুন।"],+ "kVS5tE": ["প্রতি ফোল্ডারে generated সূচী বজায় রাখুন?"],"kVgQUA": ["এই চ্যাট মুছবেন?"],+ "kVzuTI": ["প্রস্তাবিত এজেন্ট দক্ষতা"],"kYL1lH": ["এজেন্ট কার্যকলাপ"],"k_Dqw1": [[@@ -3327,7 +3395,9 @@"lWNpNB": ["CodeMirror-এর মাধ্যমে কার্সর যোগ করুন বা মিলে যাওয়া উপস্থিতিগুলো নির্বাচন করুন।"],"lXKZGw": ["শিরোনাম ১"],"lY27jj": [["0"], " বছর আগে"],+ "lY7Unt": ["সূচক তৈরি সক্ষম করা হচ্ছে"],"lZAiSP": ["ব্যাকলিংকের সাড়া প্রত্যাশিত আকারের সঙ্গে মেলেনি।"],+ "lZoQdy": ["খোলা দক্ষতা"],"lZvQrY": [["0"], "-কে গাঢ় থিম হিসেবে ব্যবহার করুন"],"l_6JHD": ["আইকন খুঁজুন..."],"l_FAT6": ["কেবল অক্ষর, অঙ্ক, <0>-</0> বা <1>_</1> ব্যবহার করুন।"],@@ -3345,6 +3415,7 @@"ljHjfg": ["ওই ব্রাঞ্চটি আগে থেকেই অন্য একটি ওয়ার্কট্রিতে খোলা।"],"lkYioO": ["নথি প্যানেল দেখান বা লুকান"],"ll2yNl": ["বিষয়বস্তুর ডিরেক্টরি"],+ "llXHHh": [["pluginCount", "plural", { "one": ["প্লাগইন"], "other": ["প্লাগইন"] }]],"lmBPt0": ["কেবল বাইরের লিংকই একটি অনুরোধ পাঠায়। এই প্রকল্পের অন্য নথির লিংকগুলো স্থানীয় সূচি থেকে প্রাকদর্শন করে এবং কখনও আপনার কম্পিউটার ছেড়ে যায় না।"],@@ -3407,6 +3478,9 @@}]],+ "mhnCt3": [+ "প্রতিটি ধারণা নথি একটি অ-খালি টাইপ বহন করে। এটি OKF এর কনফরমেন্স ফ্লোরের পুরোটাই — শুধুমাত্র একটি টাইপ সহ একটি নথি সম্পূর্ণরূপে সঙ্গতিপূর্ণ।"+ ],"mk2poV": ["যেমন server.ts"],"mlvM8g": ["ওই মন্তব্যটি আবার বসানো যায়নি।"],"mmpzAq": ["markdown সোর্স সম্পাদকে লম্বা লাইন মুড়ে দিন।"],@@ -3662,6 +3736,9 @@"qRZh7J": ["Tab যেন ভেতরে না নিয়ে সোর্স সম্পাদক থেকে বেরিয়ে যায়।"],"qSKu2v": ["সোর্স নেভিগেশন ও নির্বাচন"],"qSxaOz": ["তাদের মুছে ফেলা গ্রহণ করুন"],+ "qTT48-": [+ "উইকি-লিঙ্ক যেমন [[Page]] — এখানে লিঙ্ক করার একটি সমর্থিত উপায়, কিন্তু একজন বহিরাগত পাঠক কিছুই সমাধান করে না এবং বন্ধনী দেখায়।"+ ],"qTcVwj": ["এই প্রকল্পের জন্য কোনো স্কিল ব্রাউজ বা আপলোড করুন।"],"qTcZZu": ["ট্যাগ লোড করতে ব্যর্থ। <0>Esc</0> চেপে আবার খুলে চেষ্টা করুন।"],"qX-ABr": ["নয়তো বদলে ব্রাউজার সাইন-ইন ব্যবহার করতে:"],@@ -3704,6 +3781,7 @@"r51jLC": ["ফাইল সংরক্ষিত হয়েছে ও Claude Desktop App খুলেছে"],"r6ncaO": ["ট্যাব বন্ধ করুন"],"r6y-jM": ["সতর্কতা"],+ "r7IaYp": ["Open Knowledge Format নির্দেশিকা"],"r871ed": ["আপনার জ্ঞানভাণ্ডার এখন GitHub-এ <0>", ["ownerLogin"], "/", ["repoName"], "</0>-এ আছে।"],"rDOuNw": ["টেমপ্লেট আমদানি করতে ব্যর্থ"],"rENNI6": ["শেয়ার URL সঠিক নয়।"],@@ -3725,6 +3803,9 @@"rZVMkf": ["দৃশ্য সম্পাদকের বদলানোর ইনপুট ফোকাসে"],"radOpL": ["ছবি ", ["identity"], "। রেফারেন্সে যান।"],"rageVb": ["সরাসরি প্রাকদর্শন প্যানেলসহ কাস্টম HTML (স্যান্ডবক্স করা iframe)।"],+ "rarziH": [+ "কোডিং এজেন্টদের OKF নথির ধরন বেছে নিতে, মূল স্থান সংরক্ষণ করতে এবং অসমর্থিত মেটাডেটা উদ্ভাবন এড়াতে সাহায্য করে।"+ ],"rbrHTd": ["অনুমোদিত — ", ["optionName"]],"rcJmK8": ["জায়গাগুলোকে অনুলিপিতে রূপান্তর করুন"],"rdU729": ["বিন্যাস"],@@ -3775,6 +3856,7 @@"sER-bs": ["ফাইল"],"sFhaTJ": ["মেনুতে একই রকম নামের টেমপ্লেটগুলোর পার্থক্য স্পষ্ট করে।"],"sGZLfB": ["রিপোজিটরি আনা যায়নি"],+ "sHDllh": ["index.md বজায় রাখা বন্ধ করুন"],"sICrVf": [["0"], "-এর সংস্করণে ফিরিয়ে আনা হয়েছে"],"sIGbBZ": ["নির্বাচনকে পাদটীকায় রূপান্তর করুন"],"sIxSSP": ["আপনার টার্মিনালে দ্বন্দ্ব মীমাংসা করুন"],@@ -3788,6 +3870,7 @@"sOxZaS": ["গ্রাফ লোড করতে ব্যর্থ"],"sQoLn0": ["প্রস্থান"],"sR0I-f": ["সব ফাইল গুটিয়ে নিন"],+ "sSRndh": ["index.md বজায় রাখা শুরু করুন"],"sW5OjU": ["আবশ্যক"],"sZ2IOu": ["এই ",@@ -3802,6 +3885,9 @@"saIASg": ["দ্বিতীয় আইটেম"],"saYiIO": ["পথে null বাইট থাকতে পারে না"],"scu3wk": ["মডেল"],+ "scyoP9": [+ "ইনডেক্স ডকুমেন্টে frontmatter নেই, আপনার জ্ঞানের মূলে থাকা একটি ছাড়া। লগ ডকুমেন্ট কভার করা হয় না — OKF তাদের frontmatter সীমাবদ্ধ করে না।"+ ],"se-tU0": [["total"], "টির মধ্যে ", ["0"], "টি ফাইল ঠিক করা যায়নি।"],"seeS6l": ["এই ফোল্ডারে OpenKnowledge সেট আপ করবেন?"],"sgmRY8": [["0"], " ডাউনলোড এড়িয়ে যাওয়া হয়েছে।"],@@ -3852,6 +3938,9 @@"tHKQ6j": ["নাম বদলানো হচ্ছে"],"tKlWWY": ["ইমোজি"],"tLX6LY": ["OpenKnowledge একটি নথি লিখেছে"],+ "tM5uzl": [+ "মূল, বিশ্বাস, এবং জীবনচক্র পরিবারগুলি: sources, generated, verified, status, এবং stale_after। প্রতিটি ক্ষেত্র ঐচ্ছিক, এবং অনুপস্থিতি কখনও একটি ত্রুটি নয়।"+ ],"tN5WTS": ["সরবরাহকারী অনুরোধটি প্রত্যাখ্যান করেছে। API কী ও মডেল id দেখুন।"],"tP5DDk": ["লিংক প্রয়োগ করুন"],"tUvUfp": ["আপনার কাছে আগে থেকেই আছে এমন একটি ফোল্ডার ব্যবহার করুন।"],@@ -3907,6 +3996,9 @@"uGaIIS": ["ওয়ার্কট্রি চেক আউট করুন"],"uH_S-u": [["loadErrorTitle"], ": ", ["message"]],"uJfwF8": ["আগে থেকেই ইনস্টল করা — আমদানি করার নতুন কিছু নেই।"],+ "uK2peg": [+ "Open Knowledge Format এর বিরুদ্ধে আপনার প্রকল্প পরীক্ষা করে। সেটিংস থেকে যেকোনো সময় এটি বন্ধ করুন।"+ ],"uKRYiW": ["সিঙ্কের অবস্থা পাওয়া যাচ্ছে না — সার্ভার ত্রুটি।"],"uL_Wx8": ["টার্মিনাল অপ্রত্যাশিতভাবে থেমে গেছে।"],"uM6jnS": ["ফিরিয়ে আনা ব্যর্থ"],@@ -3961,6 +4053,9 @@"uyOQ4e": ["থিমটি base16 YAML হিসেবে কপি করা হয়েছে"],"uynXup": [["tokens", "plural", { "one": ["টোকেন"], "other": ["টোকেন"] }]],"v-h2hx": [["targetGitPath"], " মুছুন"],+ "v15iQB": [+ "প্রত্যয়িত-গণনা চুক্তি। শুধুমাত্র Attested Computation টাইপ করা নথিতে প্রযোজ্য, যেখানে OKF একটি runtime প্রয়োজন; সাধারণ ধারণাগুলি প্রভাবিত হয় না।"+ ],"v2ZW0K": ["টার্মিনাল চালু করুন"],"v2a04T": ["markdownlint নিয়ম"],"v41fCm": ["ফাইল পাওয়া যায়নি"],diff --git a/packages/app/src/locales/bn/messages.po b/packages/app/src/locales/bn/messages.poindex a4d43c30a..1e6a5c47f 100644--- a/packages/app/src/locales/bn/messages.po+++ b/packages/app/src/locales/bn/messages.po@@ -263,6 +263,11 @@ msgstr "{0, plural, one {এখন {2} টির মধ্যে {1} টি নmsgid "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"msgstr "{0, plural, one {# নথিতে কোনো সমস্যা নেই।} other {# নথিতে কোনো সমস্যা নেই।}}"+#. placeholder {0}: pluginRows.length+#: src/components/CreatedItemsList.tsx+msgid "{0, plural, one {Plugin} other {Plugins}}"+msgstr "{0, plural, one {প্লাগইন} other {প্লাগইন}}"+#. placeholder {0}: editorList.hiddenCount#: src/components/McpConsentDialogBody.tsxmsgid "{0, plural, one {Show # more tool} other {Show # more tools}}"@@ -629,7 +634,9 @@ msgstr "{displayName} CLI, {hint}"msgid "{docName} is {0}. OpenKnowledge currently opens files up to {1}."msgstr "{docName} {0}। OpenKnowledge এখন {1} পর্যন্ত ফাইল খোলে।"+#. placeholder {0}: OKF_RULE_IDS.length#. placeholder {0}: entries.length+#: src/components/settings/LintingSection.tsx#: src/components/settings/markdownlint-rule-browser.tsxmsgid "{enabledCount}/{0} on"msgstr "{0}টির মধ্যে {enabledCount}টি চালু"@@ -792,6 +799,10 @@ msgstr "{percent}% ব্যবহৃত ({left}% বাকি)"msgid "{phase} — {pct}%"msgstr "{phase} — {pct}%"+#: src/components/CreatedItemsList.tsx+msgid "{pluginCount, plural, one {plugin} other {plugins}}"+msgstr "{pluginCount, plural, one {প্লাগইন} other {প্লাগইন}}"+#: src/components/PropertyDisclosure.tsxmsgid "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"msgstr "{problemCount, plural, one {# প্রপার্টি স্কিমার সঙ্গে মেলে না} other {# প্রপার্টি স্কিমার সঙ্গে মেলে না}}"@@ -1543,6 +1554,10 @@ msgstr "নির্বাচিত মূল ফোল্ডারে আগেmsgid "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."msgstr "আগে থেকেই একটি git রিপোজিটরি আছে? এই প্রকল্পের ফোল্ডারে <0>git remote add origin <url></0> দিয়ে সেটি যোগ করুন। রিমোট শনাক্ত হলেই এই পাতা নিজে থেকে হালনাগাদ হয়।"+#: src/components/settings/LintingSection.tsx+msgid "Already in project"+msgstr "ইতিমধ্যে প্রকল্পে"+#: src/components/SkillPluginBundleDialog.tsxmsgid "Already installed — nothing new to import."msgstr "আগে থেকেই ইনস্টল করা — আমদানি করার নতুন কিছু নেই।"@@ -1588,6 +1603,10 @@ msgstr "আরেকটি সিঙ্ক কাজ চলছে। একটmsgid "any"msgstr "যেকোনো"+#: src/components/settings/LintingSection.tsx+msgid "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+msgstr "যেকোনো .mdx ফাইল। বিন্যাসটি হল .md-শুধু, তাই .md-এর জন্য স্ক্যান করা পাঠক কখনই এটি খোলে না — এবং যদি একই নামের একটি .md বিদ্যমান থাকে, তাহলে সেটিকে পড়ে।"+#. placeholder {0}: summary.name#: src/components/settings/LintingSection.tsxmsgid "any doc named {0}"@@ -2148,6 +2167,7 @@ msgstr "এই পাথ শেয়ার করা যাচ্ছে না#: src/components/ReportBugDialogBody.tsx#: src/components/SeedDialog.tsx#: src/components/settings/LinkPreviewsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/SavedThemesTiles.tsx#: src/components/settings/SearchSection.tsx#: src/components/ShareBranchSwitchDialog.tsx@@ -2288,6 +2308,10 @@ msgstr "ফাইল চেক আউট করা হচ্ছে"msgid "Checking sign-in status"msgstr "সাইন-ইন অবস্থা পরীক্ষা করা হচ্ছে"+#: src/components/settings/LintingSection.tsx+msgid "Checking skill"+msgstr "দক্ষতা পরীক্ষা করা"+#: src/components/ImportSkillForm.tsxmsgid "Checking source"msgstr "উৎস পরীক্ষা করা হচ্ছে"@@ -2304,6 +2328,10 @@ msgstr "পরীক্ষা করা হচ্ছে…"msgid "Checklist with checkboxes."msgstr "চেকবক্সসহ চেকলিস্ট।"+#: src/components/CreatedItemsList.tsx+msgid "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+msgstr "Open Knowledge Format এর বিরুদ্ধে আপনার প্রকল্প পরীক্ষা করে। সেটিংস থেকে যেকোনো সময় এটি বন্ধ করুন।"+#: src/components/ImportSkillForm.tsxmsgid "Choose a skill archive"msgstr "একটি স্কিল আর্কাইভ বাছুন"@@ -4300,6 +4328,10 @@ msgstr "{0} নিষ্ক্রিয় করুন"msgid "Disable {file}"msgstr "{file} নিষ্ক্রিয় করুন"+#: src/components/settings/LintingSection.tsx+msgid "Disable {id}"+msgstr "নিষ্ক্রিয় করুন {id}"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "Disable external link previews"msgstr "বাইরের লিংকের প্রাকদর্শন নিষ্ক্রিয় করুন"@@ -4402,6 +4434,10 @@ msgstr "নথি প্যানেল"msgid "Document statistics"msgstr "নথির পরিসংখ্যান"+#: src/components/settings/LintingSection.tsx+msgid "Document structure"+msgstr "নথি কাঠামো"+#: src/components/empty-state/use-create-suggestions.tsmsgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."msgstr "এই রিপোজিটরির স্থাপত্য নথিভুক্ত করুন: একটি সংক্ষিপ্তসার পাতা তৈরি করুন যা প্রতিটি প্রধান মডিউলের পাতার সঙ্গে যুক্ত থাকে এবং তার দায়িত্ব ও প্রবেশবিন্দু বর্ণনা করে।"@@ -4793,6 +4829,10 @@ msgstr "{displayName} CLI চালু করুন"msgid "Enable {file}"msgstr "{file} চালু করুন"+#: src/components/settings/LintingSection.tsx+msgid "Enable {id}"+msgstr "{id} সক্ষম করুন"+#: src/components/AutoSyncOnboardingDialog.tsx#: src/components/EnableSyncConfirmDialog.tsx#: src/components/share-receive-miss-content.tsx@@ -4817,6 +4857,10 @@ msgstr "Follow চালু করবেন?"msgid "Enable git auto-sync?"msgstr "git স্বয়ংক্রিয় সিঙ্ক চালু করবেন?"+#: src/components/settings/LintingSection.tsx+msgid "Enable indexes"+msgstr "সূচী সক্রিয় করুন"+#: src/components/ProblemsPanel.tsxmsgid "Enable plugins"msgstr "প্লাগইন চালু করুন"@@ -4845,6 +4889,10 @@ msgstr "এই প্রকল্পের জন্য টার্মিনাmsgid "Enable Themes"msgstr "থিম চালু করুন"+#: src/components/settings/LintingSection.tsx+msgid "Enabling index generation"+msgstr "সূচক তৈরি সক্ষম করা হচ্ছে"+#: src/components/ActivityModeContent.tsxmsgid "Ended"msgstr "শেষ হয়েছে"@@ -4915,6 +4963,10 @@ msgstr "ত্রুটি:"msgid "Escape"msgstr "Escape"+#: src/components/settings/LintingSection.tsx+msgid "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+msgstr "প্রতিটি ধারণা নথি একটি অ-খালি টাইপ বহন করে। এটি OKF এর কনফরমেন্স ফ্লোরের পুরোটাই — শুধুমাত্র একটি টাইপ সহ একটি নথি সম্পূর্ণরূপে সঙ্গতিপূর্ণ।"+#: src/components/settings/LintingSection.tsxmsgid "every doc"msgstr "প্রতিটি নথি"@@ -5690,6 +5742,10 @@ msgstr "টেমপ্লেট থেকে"msgid "From the {0} plugin"msgstr "{0} প্লাগইন থেকে"+#: src/components/settings/LintingSection.tsx+msgid "Frontmatter"+msgstr "frontmatter"+#: src/components/TemplateForm.tsxmsgid "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."msgstr "এই টেমপ্লেট থেকে তৈরি প্রতিটি নথি যে frontmatter দিয়ে শুরু হয়। মানগুলো YAML — তালিকা হলো <0>[a, b]</0>; <1>{{date}}</1> তৈরির সময় বসে যায়।"@@ -5732,6 +5788,10 @@ msgstr "খেলা শেষ · আবার খেলতে স্পেসmsgid "General"msgstr "সাধারণ"+#: src/components/settings/LintingSection.tsx+msgid "Generated files"+msgstr "জেনারেটেড ফাইল"+#: src/components/TerminalCliMissingBanner.tsxmsgid "Get {displayName}"msgstr "{displayName} নিন"@@ -5765,6 +5825,10 @@ msgstr "git কনফিগারেশন পাওয়া যাচ্ছেmsgid "Git identity isn't set — commits use a default author. Set yours so teammates see your name."msgstr "Git পরিচয় নির্ধারিত নেই — কমিটগুলো একটি ডিফল্ট লেখক ব্যবহার করে। আপনারটি নির্ধারণ করুন যাতে সহকর্মীরা আপনার নাম দেখতে পান।"+#: src/components/settings/LintingSection.tsx+msgid "Git merge rule"+msgstr "Git মার্জ নিয়ম"+#: src/components/ShareBranchSwitchDialog.tsxmsgid "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."msgstr "এই রিপোজিটরির জন্য Git-এর {tool} দরকার, কিন্তু সেটি ইনস্টল করা নেই বা পাওয়া যায়নি। সেটি ইনস্টল করে আবার চেষ্টা করুন।"@@ -5919,7 +5983,7 @@ msgstr "heading-slug"msgid "Headings"msgstr "শিরোনাম"-#: src/components/AutoSyncEnableWarning.tsx+#: src/components/DisclosureWarning.tsx#: src/editor/slash-command/component-items.tsxmsgid "Heads up"msgstr "খেয়াল রাখুন"@@ -5941,6 +6005,10 @@ msgstr "ওহে, বিশ্ব!"msgid "Help"msgstr "সহায়তা"+#: src/components/settings/LintingSection.tsx+msgid "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+msgstr "কোডিং এজেন্টদের OKF নথির ধরন বেছে নিতে, মূল স্থান সংরক্ষণ করতে এবং অসমর্থিত মেটাডেটা উদ্ভাবন এড়াতে সাহায্য করে।"+#. Subtext for the open-knowledge-discovery skill row#. Subtext for the open-knowledge-discovery skill row#: src/components/McpConsentDialogBody.tsx@@ -6273,10 +6341,18 @@ msgstr "\"{0}\" হিসেবে আমদানি করা হয়েছmsgid "Importing"msgstr "আমদানি করা হচ্ছে"+#: src/components/settings/LintingSection.tsx+msgid "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+msgstr "একটি লগ নথিতে: এন্ট্রি শিরোনাম একটি ISO YYYY-MM-DD তারিখ সহ, নতুন প্রথম। আপনি কতগুলি title ব্যবহার করবেন এবং এন্ট্রিগুলি বুলেট কিনা তা আপনার উপর নির্ভর করে।"+#: src/components/SeedDialog.tsxmsgid "In a subfolder"msgstr "একটি উপ-ফোল্ডারে"+#: src/components/settings/LintingSection.tsx+msgid "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+msgstr "একটি সূচক নথিতে: এন্ট্রিগুলি একটি বিভাগের শিরোনামের নীচে বসে এবং প্রতিটি একটি লিঙ্ক বহন করে। তালিকার চারপাশে গদ্য ঠিক আছে।"+#: src/components/empty-state/CreatePromptComposer.tsx#: src/components/handoff/AgentSplitButton.tsx#: src/components/handoff/OpenInAgentContextSubmenu.tsx@@ -6295,6 +6371,14 @@ msgstr "অ্যাপে"msgid "In app (beta)"msgstr "অ্যাপে (বিটা)"+#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+msgstr "Git প্রকল্পে, Open Knowledge রিপোজিটরির রুটের .gitattributes ফাইলে একটি সীমিত নিয়ম যোগ করে, যাতে একই সময়ে হওয়া ইনডেক্স পরিবর্তনগুলো একত্রিত হয়।"++#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+msgstr "Git প্রকল্পে, Open Knowledge একটি স্কোপড .gitattributes নিয়ম যোগ করে যাতে পরবর্তী পুনর্নির্মাণের আগে সমবর্তী সূচক পরিবর্তনগুলি একত্রিত হয়।"+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "In the Claude Desktop App"msgstr "Claude Desktop App-এ"@@ -6319,6 +6403,26 @@ msgstr "বর্তমান তালিকা আইটেমটি ভেতmsgid "Indented blockquote for citations."msgstr "উদ্ধৃতির জন্য ভেতরের দিকে সরানো ব্লককোট।"+#: src/components/settings/LintingSection.tsx+msgid "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+msgstr "ইনডেক্স ডকুমেন্টে frontmatter নেই, আপনার জ্ঞানের মূলে থাকা একটি ছাড়া। লগ ডকুমেন্ট কভার করা হয় না — OKF তাদের frontmatter সীমাবদ্ধ করে না।"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+msgstr "সূচী রক্ষণাবেক্ষণ বিরাম দেওয়া হয়েছে কারণ অন্য Git বৈশিষ্ট্য নিয়ন্ত্রণ করে index.md। .gitattributes আপডেট করুন যাতে স্কোপযুক্ত index.md পাথগুলি merge=union ব্যবহার করে, তারপর আবার চেষ্টা করুন।"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+msgstr "সূচী রক্ষণাবেক্ষণ বিরাম দেওয়া হয়েছে কারণ Open Knowledge প্রয়োজনীয় Git মার্জ নিয়ম নিশ্চিত করতে পারেনি। Git এবং .gitattributes চেক করুন, তারপর আবার চেষ্টা করুন।"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+msgstr "সূচী রক্ষণাবেক্ষণ বন্ধ ছিল কারণ Open Knowledge প্রকল্প সার্ভারে পৌঁছাতে পারেনি। প্রজেক্ট পুনরায় সংযোগ করলে আবার চেষ্টা করুন।"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+msgstr "সূচী রক্ষণাবেক্ষণ বন্ধ ছিল কারণ প্রকল্প সেটিং সংরক্ষণ করা যায়নি। প্রকল্প ফাইল অনুমতি পরীক্ষা করুন, তারপর আবার চেষ্টা করুন."+#: src/components/settings/SearchSection.tsxmsgid "Indexed {embedded} of {total} pages."msgstr "{total}টির মধ্যে {embedded}টি পাতা সূচিভুক্ত।"@@ -6507,6 +6611,10 @@ msgstr "সব এজেন্টে ইনস্টল করুন"msgid "Install selected"msgstr "নির্বাচিতগুলো ইনস্টল করুন"+#: src/components/settings/LintingSection.tsx+msgid "Install skill"+msgstr "দক্ষতা ইনস্টল করুন"+#: src/components/SkillPluginBundleBanner.tsxmsgid "Install skills"msgstr "স্কিল ইনস্টল করুন"@@ -6516,6 +6624,7 @@ msgid "Install the gh CLI"msgstr "gh CLI ইনস্টল করুন"#: src/components/settings/AiToolsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ProjectAiToolsSection.tsx#: src/components/SkillEditorActions.tsxmsgid "Installed"@@ -6729,6 +6838,10 @@ msgstr "এই প্রকল্পটি আপনার git রিমোটmsgid "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."msgstr "আপনি যাদের ও যে কোম্পানিগুলোর সঙ্গে কাজ করেন এবং তাদের সঙ্গে আপনার বৈঠকগুলোর হিসাব রাখুন। কেউ কে, আপনি তাকে কীভাবে চেনেন, এবং শেষবার কী নিয়ে কথা হয়েছিল তা মনে রাখার জন্য ভালো।"+#: src/components/settings/LintingSection.tsx+msgid "Keeps your knowledge base aligned with the Open Knowledge Format."+msgstr "আপনার জ্ঞানভান্ডারকে Open Knowledge Format-এর সঙ্গে সামঞ্জস্যপূর্ণ রাখে।"+#. placeholder {0}: toName.trim()#: src/components/SkillForkDialog.tsxmsgid "Kept both — \"{0}\" is its own skill now"@@ -7104,6 +7217,14 @@ msgstr "<0>{lookingForUrl}</0> খোঁজা হচ্ছে।"msgid "Lost connection to \"{docName}\"."msgstr "\"{docName}\"-এর সঙ্গে সংযোগ হারিয়েছে।"+#: src/components/settings/LintingSection.tsx+msgid "Maintain generated indexes in every folder?"+msgstr "প্রতি ফোল্ডারে generated সূচী বজায় রাখুন?"++#: src/components/settings/LintingSection.tsx+msgid "Maintain index.md"+msgstr "index.md বজায় রাখুন"+#: src/components/SkillInstallMenu.tsxmsgid "make source"msgstr "উৎস বানান"@@ -8248,6 +8369,10 @@ msgstr "OK Desktop"msgid "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."msgstr "OK শেষবার এই ফোল্ডারটি {0}-এ নির্ধারণ করেছিল — এরপর OK-এর বাইরের কিছু সেটি বদলে দিয়েছে। দেখানো অবস্থাটি এখন ডিস্কে যা আছে তাই; আপনার পরবর্তী Symlink/Unlink কার্যকর হবে।"+#: src/components/settings/LintingSection.tsx+msgid "OKF agent skill installed"+msgstr "OKF এজেন্ট দক্ষতা ইনস্টল করা হয়েছে"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "On — hovering an external link sends its URL to the destination site to fetch a preview."msgstr "চালু — কোনো বাইরের লিংকের উপর মাউস নিলে প্রাকদর্শন আনতে তার URL গন্তব্য সাইটে পাঠানো হয়।"@@ -8264,6 +8389,10 @@ msgstr "<0>{address}</0>-এ"msgid "On selected text in <0>{address}</0>"msgstr "<0>{address}</0>-এ নির্বাচিত লেখার উপর"+#: src/components/settings/LintingSection.tsx+msgid "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+msgstr "রুট ইনডেক্সে, okf_version একটি উদ্ধৃত স্ট্রিং হিসাবে লেখা হয় যেমন \"0.2\"। উদ্ধৃতিহীন, YAML এটিকে একটি সংখ্যা হিসাবে পড়ে এবং 0.10 নিঃশব্দে 0.1 হয়ে যায়।"+#. Next step for a Cursor project MCP row — Cursor leaves project servers disabled#: src/components/settings/ProjectAiToolsSection.tsxmsgid "One more step: enable it in Cursor → Settings → Tools & MCP (Cursor leaves project servers off until you turn them on)."@@ -8486,6 +8615,22 @@ msgstr "ওয়ার্কট্রিতে খুলুন"msgid "Open it there"msgstr "সেটি সেখানেই খুলুন"+#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+msgstr "Open Knowledge Markdown ধারণকারী প্রতিটি ফোল্ডারে index.md নামের একটি নেভিগেশন ফাইল তৈরি ও রক্ষণাবেক্ষণ করে।"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge Format guidance"+msgstr "Open Knowledge Format নির্দেশিকা"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+msgstr "Open Knowledge Markdown ধারণকারী প্রতিটি ফোল্ডারে index.md নামের একটি নেভিগেশন ফাইল রক্ষণাবেক্ষণ করে, প্রতিটি ফোল্ডারের নথিগুলিকে টাইপ এবং তার সাবফোল্ডারের সাথে লিঙ্ক করে তালিকাভুক্ত করে। আপনার নথি পরিবর্তনের সাথে সাথে এটি এই ফাইলগুলিকে পুনরায় লিখবে, এবং আপনি নিজে এগুলিতে সম্পাদনা করা সমস্ত কিছু প্রতিস্থাপিত হবে৷"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+msgstr "Open Knowledge এই index.md ফাইলগুলিকে দস্তাবেজগুলি পরিবর্তন করার সাথে সাথে পুনঃলিখন করে, তাই তাদের ম্যানুয়াল সম্পাদনাগুলি প্রতিস্থাপিত হয়৷"+#. placeholder {0}: item.displayName#. placeholder {1}: item.displayName#. placeholder {2}: item.version@@ -8532,6 +8677,10 @@ msgstr "সেটিং খুলুন"msgid "Open shared {targetNoun}"msgstr "ভাগ করা {targetNoun} খুলুন"+#: src/components/settings/LintingSection.tsx+msgid "Open skill"+msgstr "খোলা দক্ষতা"+#: src/editor/extensions/JsxComponentView.tsxmsgid "Open source doc: {mirrorSrc}"msgstr "উৎস নথি খুলুন: {mirrorSrc}"@@ -9368,6 +9517,7 @@ msgid "project"msgstr "প্রকল্প"#: src/components/CommandPalette.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ScopeBadge.tsx#: src/lib/skill-scope.tsmsgid "Project"@@ -9639,6 +9789,10 @@ msgstr "সাম্প্রতিক প্রকল্প"msgid "Recently opened"msgstr "সম্প্রতি খোলা"+#: src/components/settings/LintingSection.tsx+msgid "Recommended agent skill"+msgstr "প্রস্তাবিত এজেন্ট দক্ষতা"+#: src/components/SyncStatusBadge.tsxmsgid "Reconnect required"msgstr "পুনরায় যুক্ত হওয়া দরকার"@@ -10076,6 +10230,10 @@ msgstr "উড়তে না পারা পাখিদের বিলুmsgid "research-note"msgstr "research-note"+#: src/components/settings/LintingSection.tsx+msgid "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+msgstr "সংরক্ষিত ফাইলের নাম index.md এবং log.md ছোট হাতের অক্ষরে। একটি কেস-সংবেদনশীল ফাইল সিস্টেমে, Index.md একটি সাধারণ নথি হিসাবে পড়া হয় এবং এর অর্থ হারায়।"+#: src/components/settings/CustomThemeEditor.tsxmsgid "Reset"msgstr "রিসেট করুন"@@ -10318,6 +10476,7 @@ msgid "Rule editing is available for the project's root markdownlint config"msgstr "নিয়ম সম্পাদনা প্রকল্পের রুট markdownlint কনফিগের জন্য পাওয়া যায়"#: src/components/LintConfigEditor.tsx+#: src/components/settings/LintingSection.tsxmsgid "Rules"msgstr "নিয়ম"@@ -11260,6 +11419,10 @@ msgstr "{conflictHosts}-এর জন্য “{conflictName}” স্কিলmsgid "Skill \"{name}\" created"msgstr "স্কিল \"{name}\" তৈরি হয়েছে"+#: src/components/settings/LintingSection.tsx+msgid "Skill already in project"+msgstr "ইতিমধ্যে প্রকল্পে দক্ষতা"+#: src/components/ExploreSkills.tsxmsgid "Skill discovery powered by <0>skills.sh</0>"msgstr "স্কিল খোঁজা <0>skills.sh</0> দ্বারা চালিত"@@ -11519,6 +11682,10 @@ msgstr "এখান থেকে শুরু"msgid "Start here: what this is and how it's organized."msgstr "এখান থেকে শুরু করুন: এটি কী এবং কীভাবে সাজানো।"+#: src/components/settings/LintingSection.tsx+msgid "Start maintaining index.md"+msgstr "index.md বজায় রাখা শুরু করুন"+#: src/lib/keyboard-shortcuts.tsmsgid "Start source completion"msgstr "সোর্স সম্পূর্ণকরণ শুরু করুন"@@ -11614,6 +11781,10 @@ msgstr "ফাইল ঠিক করা থামান"msgid "Stop fixing. Files already fixed stay fixed."msgstr "ঠিক করা থামান। যেসব ফাইল আগেই ঠিক হয়েছে সেগুলো ঠিকই থাকে।"+#: src/components/settings/LintingSection.tsx+msgid "Stop maintaining index.md"+msgstr "index.md বজায় রাখা বন্ধ করুন"+#: src/lib/project-fix-sweep-store.tsmsgid "Stopped fixing. Files already fixed stay fixed."msgstr "ঠিক করা থামানো হয়েছে। যেসব ফাইল আগেই ঠিক হয়েছে সেগুলো ঠিকই থাকে।"@@ -12117,6 +12288,10 @@ msgstr "এজেন্ট থামছে না। ফোর্স স্টmsgid "The agent's persona, values, and voice."msgstr "এজেন্টের ব্যক্তিত্ব, মূল্যবোধ ও স্বর।"+#: src/components/settings/LintingSection.tsx+msgid "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+msgstr "প্রত্যয়িত-গণনা চুক্তি। শুধুমাত্র Attested Computation টাইপ করা নথিতে প্রযোজ্য, যেখানে OKF একটি runtime প্রয়োজন; সাধারণ ধারণাগুলি প্রভাবিত হয় না।"+#: src/components/ProblemsPanel.tsxmsgid "The audit could not be completed. Try again."msgstr "নিরীক্ষা সম্পূর্ণ করা যায়নি। আবার চেষ্টা করুন।"@@ -12175,6 +12350,10 @@ msgstr "সূত্র <0>c = √(a² + b²)</0> ইনলাইনে রেmsgid "the git exclude file isn't writable"msgstr "git exclude ফাইলটি লেখার যোগ্য নয়"+#: src/components/settings/LintingSection.tsx+msgid "The index files stay in place. Open Knowledge removes only the Git rule it added."+msgstr "ইনডেক্স ফাইলগুলি জায়গায় থাকে। Open Knowledge শুধুমাত্র এটি যোগ করা Git নিয়মটিকে সরিয়ে দেয়।"+#: src/lib/locale-load-failure-notice.tsmsgid "The interface is still in the language you were reading. Check your connection, then reload to try again."msgstr "ইন্টারফেসটি এখনও সেই ভাষাতেই আছে যেটি আপনি পড়ছিলেন। আপনার সংযোগ দেখে নিন, তারপর আবার চেষ্টা করতে রিলোড করুন।"@@ -12211,6 +12390,10 @@ msgstr "এই নথির উপরের প্রপার্টি ব্msgid "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."msgstr "প্রপার্টি বদলেছে, কিন্তু তুলনা করা যায়নি — YAML পার্স হয়নি। দুটি সংস্করণই যেমন লেখা ছিল তেমনই দেখানো হচ্ছে।"+#: src/components/settings/LintingSection.tsx+msgid "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+msgstr "মূল, বিশ্বাস, এবং জীবনচক্র পরিবারগুলি: sources, generated, verified, status, এবং stale_after। প্রতিটি ক্ষেত্র ঐচ্ছিক, এবং অনুপস্থিতি কখনও একটি ত্রুটি নয়।"+#: src/components/settings/SearchSection.tsxmsgid "The provider is rate-limiting this key. Try again in a moment."msgstr "সরবরাহকারী এই কী-টির হার সীমিত করছে। একটু পরে আবার চেষ্টা করুন।"@@ -12248,6 +12431,10 @@ msgstr "স্কিমা ফাইলটি নেই বা লোড করmsgid "the server responded but server.lock has no port yet"msgstr "সার্ভার সাড়া দিয়েছে কিন্তু server.lock-এ এখনো কোনো পোর্ট নেই"+#: src/components/settings/LintingSection.tsx+msgid "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+msgstr "title, description, resource, এবং tags এর আকার আপনি যখন ব্যবহার করেন। কোনটির প্রয়োজন নেই; একটি ঘোষণা করলে শুধুমাত্র তার টাইপ পিন হয়, তাই tags একটি কমা-বিচ্ছিন্ন স্ট্রিং হিসাবে ফ্ল্যাগ করা হয়।"+#: src/components/SkillInstallMenu.tsxmsgid "The skill's own folder — the source other locations copy or link from"msgstr "স্কিলের নিজের ফোল্ডার — যে উৎস থেকে অন্য জায়গাগুলো অনুলিপি করে বা লিংক করে"@@ -12561,6 +12748,10 @@ msgstr "এতে একটু সময় লাগতে পারে। আmsgid "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."msgstr "এটি <0>{name}</0>-কে {0} থেকে {1}-এ সরায়, ডিস্কে এর ফাইলগুলো অন্যত্র রাখে এবং আপনার সম্পাদকগুলোতে {2} স্তরে সেটি আবার ইনস্টল করে।"+#: src/components/settings/LintingSection.tsx+msgid "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+msgstr "এটির জন্য আপনার ফাইলগুলি দেখতে হবে, শুধু খোলা নথি নয়, তাই এটি প্রদর্শিত হয় যখন আপনি টাইপ করার পরিবর্তে একটি প্রকল্প অডিট চালান।"+#: src/components/SeedDialog.tsxmsgid "This pack is already set up here."msgstr "এই প্যাকটি এখানে আগে থেকেই সেট আপ করা আছে।"@@ -12924,6 +13115,10 @@ msgstr "{0}-কে আবার একটি সত্যিকারের ডmsgid "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."msgstr "{display}-কে আবার একটি সত্যিকারের ডিরেক্টরি বানান যাতে এখন দেখা প্রতিটি স্কিলের জন্য আলাদা সিমলিংক থাকে — কিছুই কাজ করা বন্ধ করে না, আর তারপর প্রতিটি স্কিলের মেনু সেটি সামলায়।"+#: src/components/CreatedItemsList.tsx+msgid "Turn it off any time in Settings."+msgstr "সেটিংস থেকে যেকোনো সময় এটি বন্ধ করুন।"+#: src/components/NotInSidebarIndicator.tsxmsgid "Turn off Only markdown files"msgstr "কেবল markdown ফাইল বন্ধ করুন"@@ -12949,6 +13144,10 @@ msgstr "অর্থভিত্তিক অনুসন্ধান চালmsgid "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."msgstr "আপনি যা পড়েন তা স্পষ্ট, নির্ভরযোগ্য নিবন্ধে রূপ দিন। একটি উৎস সংরক্ষণ করুন, তার অর্থ বুঝুন, তারপর চূড়ান্ত সংস্করণটি রেখে দিন যাতে পরে তার উপর ভরসা করতে পারেন।"+#: src/components/settings/LintingSection.tsx+msgid "Turning it off"+msgstr "এটা বন্ধ করা"+#: src/components/acp/working-status.tsmsgid "Turning it over…"msgstr "ভেবে দেখা হচ্ছে…"@@ -13639,6 +13838,10 @@ msgstr "উইকি লিংক"msgid "Wiki link suggestions"msgstr "উইকি লিংকের পরামর্শ"+#: src/components/settings/LintingSection.tsx+msgid "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+msgstr "উইকি-লিঙ্ক যেমন [[Page]] — এখানে লিঙ্ক করার একটি সমর্থিত উপায়, কিন্তু একজন বহিরাগত পাঠক কিছুই সমাধান করে না এবং বন্ধনী দেখায়।"+#: src/components/PublishToGitHubDialog.tsxmsgid "Will be created as <0>{sanitizedName}</0>"msgstr "<0>{sanitizedName}</0> হিসেবে তৈরি হবে"diff --git a/packages/app/src/locales/en/messages.json b/packages/app/src/locales/en/messages.jsonindex 85035f6bd..fe91b627a 100644--- a/packages/app/src/locales/en/messages.json+++ b/packages/app/src/locales/en/messages.json@@ -121,6 +121,9 @@"0ySP5u": ["Changes save automatically to this theme."],"0zAhu6": ["every doc"],"10g8I_": ["Turn off Only markdown files"],+ "110eEb": [+ "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+ ],"11ukmX": ["Rename failed: ", ["0"]],"12F9WL": ["(no id)"],"151wvk": ["Show sidebar"],@@ -138,6 +141,9 @@"1GhYxC": ["of ", ["totalPages"]],"1HBhDS": ["Checking out files"],"1J0c0X": ["Still couldn't reach ", ["displayName"], " — try one more time?"],+ "1JpLgH": [+ "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+ ],"1LtA5r": ["Symlinks the skill to ", ["path"]],"1MGRQl": ["Terminal sessions"],"1NgrlY": ["Other ways to install"],@@ -151,6 +157,7 @@"1XSMhZ": ["Switching to <0>local-only</0> will refuse until they're untracked via<1> git rm --cached</1>."],+ "1ZXkqM": ["Turn it off any time in Settings."],"1ZpfyB": ["Open with AI ", ["displayName"], ", ", ["hint"]],"1a6ICf": ["Following the agent's edits"],"1bDVu5": ["Workspace Command Palette"],@@ -290,6 +297,8 @@"3o3tur": ["Starter content"],"3oh0nQ": ["Nested .okignore error in ", ["path"]],"3pU8e-": ["Pin tab"],+ "3qDsdf": ["Install skill"],+ "3ri_4O": ["Keeps your knowledge base aligned with the Open Knowledge Format."],"3s-k7L": [["0",@@ -429,6 +438,9 @@],"5tcmwY": ["Add value"],"5vAI6Z": ["It didn't fit into my workflow"],+ "5w38tn": [+ "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+ ],"5wV2qQ": ["and more"],"5y_9lO": ["Waiting for authorization"],"6-wLTJ": [["behind"], " behind origin"],@@ -565,6 +577,7 @@"7d1a0d": ["Public"],"7dZnmw": ["Relevance"],"7hctf2": ["Describe the project you want to create"],+ "7idx48": ["OKF agent skill installed"],"7jIIFX": ["You're all set up!"],"7kb4LU": ["Approved"],"7l15X4": ["failed"],@@ -572,6 +585,7 @@"7m3Ade": ["installs:"],"7qRHf0": ["Install for Claude Chat & Cowork"],"7uBlRT": ["Copy the focused file-tree item so Paste can duplicate it."],+ "7wogIQ": [["0", "plural", { "one": ["Plugin"], "other": ["Plugins"] }]],"80c4-P": ["Code copied to clipboard"],"81H_23": ["Add properties"],"851WA-": ["This can be configured in Settings > AI tools & CLI"],@@ -631,6 +645,7 @@"8nWu1k": ["Empty diagram"],"8oWgty": ["Mark every comment to send"],"8qgfac": ["MCP servers"],+ "8rZ1pk": ["Enable ", ["id"]],"8ruqQi": ["Broken internal links"],"8sMErm": ["Enable Follow?"],"8t9CRE": ["Starting ", ["agentName"], "…"],@@ -814,6 +829,9 @@"BQKHuL": ["Restart terminal"],"BQu9Pg": ["Symlink"],"BUyQnq": ["Couldn't restart the server. Try `ok start` in this folder."],+ "BVkqD9": [+ "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+ ],"BY-g4_": ["Add pattern"],"Ba4D2x": ["Template imported"],"Bdha5y": ["Publishing..."],@@ -832,6 +850,7 @@"Bv5a9_": ["Selection statistics"],"Bx4EXG": ["Actions for ", ["label"]],"By-7Pn": ["Toggle a bullet list."],+ "ByIOcK": ["The index files stay in place. Open Knowledge removes only the Git rule it added."],"BymzO4": ["Document outline"],"C-mmmK": ["The model id your endpoint serves. Its vector size is detected automatically — clear the field to go back to ",@@ -873,6 +892,9 @@"<0>~/.ok/bin</0> and <1>~/.ok/env.sh</1> stay either way — the app always maintains them."],"CXTwen": ["Can't safely edit this project config"],+ "CXcveY": [+ "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+ ],"CXj9C-": ["New property name"],"C_Lyvh": ["Failed to save theme setting"],"C_WGy8": [@@ -896,6 +918,9 @@"Cu6GXQ": ["The source folder itself does not move."],"CvsD6Y": ["via ", ["viaTags"]],"CwOXMT": ["Value for ", ["keyName"]],+ "CxCOFx": [+ "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+ ],"CxVk-w": ["Comment on ", ["address"]],"D-NlUC": ["System"],"D-Oh1s": ["How to set up ", ["0"], " (opens in browser)"],@@ -954,6 +979,9 @@"DhT_PK": ["OpenKnowledge imported a skill"],"DiFKSL": ["Counting markdown files"],"DiZ3pq": ["Icon picker"],+ "DjNcDy": [+ "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+ ],"DmkTrb": ["Couldn’t create this theme. Try again."],"Dnn2XG": ["Automatic"],"DpjYd6": ["Jump to the anchored text"],@@ -1168,6 +1196,9 @@"GNkUvW": ["Queued — sends when this run finishes"],"GQ3O42": ["Trash"],"GQDSBN": ["Layout options"],+ "GROUfG": [+ "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+ ],"GSYWCm": ["Hide document panel"],"GUYwCr": ["Dismiss notice"],"GUZHkL": ["Missing palette colors"],@@ -1324,6 +1355,7 @@"IxHMdF": ["Couldn't delete that comment."],"IxyZXD": ["Screenshot"],"Izh19j": ["Reading from ", ["tail"]],+ "J0uRhj": ["Checking skill"],"J1XRO3": ["Theme colors"],"J2Mv98": ["Name (e.g. ", ["login"], ")"],"J2_JuX": ["nothing (", ["0"], " cannot match a doc)"],@@ -1344,6 +1376,7 @@"JHf6qZ": ["[email protected]"],"JJcBCm": [["0"], " total"],"JK-Ave": ["Hide thumbnails"],+ "JKXcOi": ["Already in project"],"JL3si7": ["Updating"],"JLUTgi": ["No tags yet — author `#tagname` in any doc to populate the index."],"JLzQi_": ["Close ", ["accessibleLabel"]],@@ -1435,6 +1468,9 @@"L-rMC9": ["Reset to default"],"L1BQTH": [["0"], " isn't installed yet — opening its download page."],"L1ZE3M": ["Document statistics"],+ "L3BcJ4": [+ "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+ ],"L3CEC1": ["this item"],"L3w0_C": ["Present a document as a slide deck in its own window. Add <0>slides: true</0> to a document's frontmatter, then open it with the Slidev action. Rendering is handled by the Slidev CLI, which OpenKnowledge does not bundle."@@ -1897,6 +1933,12 @@"R6ABfU": ["Work directly, no plan step"],"R9IDFz": ["Renames the folder on disk and the id agents use to invoke it."],"R9dK63": ["Sample image"],+ "RB_g_C": [+ "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+ ],+ "RD6H9q": [+ "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+ ],"RDjuBN": ["Setup"],"RDrXh4": ["Configure user, project, and integration settings."],"RG3yW6": ["Enter a name for this theme."],@@ -1966,6 +2008,9 @@"SF9qpO": ["Share your email for followups"],"SFEWV6": ["Couldn't load the OpenKnowledge skills. Try again."],"SFN6dN": ["Heading 3"],+ "SIPelo": [+ "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+ ],"SInSnF": ["Reference <0>", ["0"], "</0>"],"SItQRc": ["How do you like OpenKnowledge?"],"SOPwPh": ["Restore to this edit"],@@ -2278,6 +2323,7 @@"X7u0xR": [["0"], " templates available"],"X8kjQX": ["Re-authenticate with GitHub"],"X9VpsP": ["Loading folder contents"],+ "XAnapw": ["Git merge rule"],"XAyxsa": ["Check out remote branch"],"XBBZnv": ["Link target \"", ["shown"], "\" does not resolve to an existing document."],"XBgr2S": ["Copy in"],@@ -2399,6 +2445,9 @@"Y_iImT": ["Unresolvable file ", ["identity"], ". Go to reference."],"Y_kL7X": ["Customize how the editor looks and behaves."],"Ya3PlJ": ["Permission required"],+ "YaVU2F": [+ "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+ ],"YaeyFh": ["Pulls may overwrite uncommitted edits in your local files."],"Yb82LN": ["ID: ", ["0"]],"Yea-K5": ["Restore to this point"],@@ -2525,6 +2574,7 @@"_Bix3-": ["Occurrences of ", ["localizedFirstMessage"]],"_DwR-n": ["Creating…"],"_FLBbi": [["sizeText"], " · secrets redacted · crash dump not redacted"],+ "_G7A92": ["Maintain index.md"],"_GRWOJ": ["Change the embeddings provider?"],"_HgF9q": ["Sort by"],"_IGfXZ": ["OpenKnowledge quit unexpectedly last time."],@@ -2609,10 +2659,12 @@"Couldn't connect to the agent service. Make sure the OpenKnowledge server is running and up to date (restart it if it was already running), then try again."],"aalx4E": ["Editing broken MDX source: ", ["reason"]],+ "aatPoi": ["Generated files"],"abiHje": ["Delete selected items"],"adsMWO": ["Resolving deltas"],"ah_ekO": ["\"", ["name"], "\" is already up to date"],"aiArms": ["We couldn't clone this repository."],+ "aiOceC": ["Enable indexes"],"ajHi4O": ["Auto-sync is paused — you don't have permission to push to this repo. Switch to Follow to keep receiving updates."],@@ -2745,11 +2797,13 @@],"cb-0G0": ["Clear color"],"ccNps_": ["Only modified"],+ "cd3THN": ["Document structure"],"cd5EXh": ["Report a bug"],"cdm00A": ["No Incoming"],"cdmk8A": ["Uncommitted changes"],"cgl-gn": ["Connected to GitHub"],"chL5IG": ["Community"],+ "ciozf1": ["Skill already in project"],"cjtjry": ["Traverse OpenKnowledge navigation history backward."],"cklVjM": ["Timeline"],"clJ3qM": ["Done."],@@ -2929,6 +2983,7 @@"fbdLmk": ["Toggle bold formatting."],"fbsiBw": ["Something went wrong starting the terminal."],"fcgvCA": ["Claude"],+ "fdKQAE": ["Turning it off"],"fdeFfN": ["(binary file, not previewable)"],"fevEu0": ["Pull latest changes"],"ffH3Rt": ["Add Comment (Enter)"],@@ -3012,12 +3067,16 @@"gUx34c": ["The language OpenKnowledge speaks; System follows your operating system. Your own notes stay in the language you wrote them in."],+ "gVMkEr": [+ "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+ ],"gY7wnY": ["Signing in to ", ["agentName"], "…"],"gYz2ep": ["Expires in ", ["timeLabel"]],"gZElfU": ["Fixing ", ["0"], " of ", ["1"], " files"],"gZiT5e": ["Replace these symlinks with independent copies?"],"gayL_Q": ["Release plan"],"gbHcbI": ["Failed to delete property"],+ "gfYI3o": ["Disable ", ["id"]],"gfb-CM": ["Could not fetch branch — sign in to GitHub and try again."],"gfdqcY": ["Couldn't apply the change: ", ["0"]],"gfohmY": ["Connect tools"],@@ -3076,6 +3135,9 @@"hLKfZe": ["Use a token instead"],"hLod4_": ["Convert to template"],"hLy8b1": ["Updated to Version ", ["version"]],+ "hPQBsa": [+ "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+ ],"hQXiDc": ["Search branches..."],"hQjvzi": ["A .zip or .skill archive."],"hS0wC4": ["OpenKnowledge restored an earlier version of ", ["subject"]],@@ -3211,6 +3273,9 @@"iz1LdD": ["Changed outside OK since it last wrote here — the state shown is what's on disk now"],+ "j-o6Z2": [+ "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+ ],"j15ZSH": ["Send comments to"],"j2229h": ["Removing OpenKnowledge files…"],"j2kt1j": [@@ -3294,6 +3359,7 @@"k4CuuV": ["Ready-made folders and templates to get you started quickly. Select a pack to preview what gets created, then add it to your project."],+ "k5rKNs": ["Frontmatter"],"k7Hoig": ["No content changes at this version."],"k8xtrB": ["Not required for a localhost endpoint like <0>",@@ -3333,7 +3399,9 @@"kV2YZv": ["Don't see <0>Skills</0>? Enable <1>Settings <2/> Capabilities <3/> Code execution and file creation</1> first."],+ "kVS5tE": ["Maintain generated indexes in every folder?"],"kVgQUA": ["Delete this chat?"],+ "kVzuTI": ["Recommended agent skill"],"kYL1lH": ["Agent activity"],"k_Dqw1": [[@@ -3425,7 +3493,9 @@"lWNpNB": ["Add cursors or select matching occurrences through CodeMirror."],"lXKZGw": ["Heading 1"],"lY27jj": [["0"], "y ago"],+ "lY7Unt": ["Enabling index generation"],"lZAiSP": ["Backlinks response did not match expected shape."],+ "lZoQdy": ["Open skill"],"lZvQrY": ["Use ", ["0"], " as the dark theme"],"l_6JHD": ["Search icons..."],"l_FAT6": ["Use letters, digits, <0>-</0> or <1>_</1> only."],@@ -3443,6 +3513,7 @@"ljHjfg": ["That branch is already open in another worktree."],"lkYioO": ["Show or hide document panel"],"ll2yNl": ["Content directory"],+ "llXHHh": [["pluginCount", "plural", { "one": ["plugin"], "other": ["plugins"] }]],"lmBPt0": ["Only external links trigger a request. Links to other documents in this project preview from the local index and never leave your computer."],@@ -3510,6 +3581,9 @@}]],+ "mhnCt3": [+ "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+ ],"mk2poV": ["e.g. server.ts"],"mlvM8g": ["Couldn't re-place that comment."],"mmpzAq": ["Wrap long lines in the markdown source editor."],@@ -3773,6 +3847,9 @@"qRZh7J": ["Let Tab leave the source editor instead of indenting."],"qSKu2v": ["Source navigation and selection"],"qSxaOz": ["Accept their deletion"],+ "qTT48-": [+ "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+ ],"qTcVwj": ["Browse or upload a skill for this project."],"qTcZZu": ["Failed to load tags. Press <0>Esc</0> and re-open to retry."],"qX-ABr": ["Or to use browser sign-in instead:"],@@ -3823,6 +3900,7 @@"r51jLC": ["File saved & Claude Desktop App opened"],"r6ncaO": ["Close tab"],"r6y-jM": ["Warning"],+ "r7IaYp": ["Open Knowledge Format guidance"],"r871ed": ["Your knowledge base is now on GitHub at <0>",["ownerLogin"],@@ -3852,6 +3930,9 @@"rZVMkf": ["Visual editor replace input focused"],"radOpL": ["Image ", ["identity"], ". Go to reference."],"rageVb": ["Custom HTML with a live preview pane (sandboxed iframe)."],+ "rarziH": [+ "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+ ],"rbrHTd": ["Approved — ", ["optionName"]],"rcJmK8": ["Convert locations to copies"],"rdU729": ["Layout"],@@ -3902,6 +3983,7 @@"sER-bs": ["Files"],"sFhaTJ": ["Disambiguates similarly-named templates in the menu."],"sGZLfB": ["Failed to fetch repositories"],+ "sHDllh": ["Stop maintaining index.md"],"sICrVf": ["Restored to the version from ", ["0"]],"sIGbBZ": ["Convert selection to footnote"],"sIxSSP": ["Resolve conflict in your terminal"],@@ -3915,6 +3997,7 @@"sOxZaS": ["Failed to load graph"],"sQoLn0": ["Quit"],"sR0I-f": ["Collapse all files"],+ "sSRndh": ["Start maintaining index.md"],"sW5OjU": ["required"],"sZ2IOu": ["This ",@@ -3929,6 +4012,9 @@"saIASg": ["Second item"],"saYiIO": ["Path cannot contain null bytes"],"scu3wk": ["Model"],+ "scyoP9": [+ "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+ ],"se-tU0": ["Could not fix ", ["0"], " of ", ["total"], " files."],"seeS6l": ["Setup OpenKnowledge in this folder?"],"sgmRY8": ["Skipped downloading ", ["0"], "."],@@ -3979,6 +4065,9 @@"tHKQ6j": ["Renaming"],"tKlWWY": ["Emoji"],"tLX6LY": ["OpenKnowledge wrote a document"],+ "tM5uzl": [+ "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+ ],"tN5WTS": ["The provider rejected the request. Check the API key and the model id."],"tP5DDk": ["Apply link"],"tUvUfp": ["Use a folder you already have."],@@ -4040,6 +4129,9 @@"uGaIIS": ["Check out worktree"],"uH_S-u": [["loadErrorTitle"], ": ", ["message"]],"uJfwF8": ["Already installed — nothing new to import."],+ "uK2peg": [+ "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+ ],"uKRYiW": ["Sync status unavailable — server error."],"uL_Wx8": ["The terminal stopped unexpectedly."],"uM6jnS": ["Restore failed"],@@ -4096,6 +4188,9 @@"uyOQ4e": ["Theme copied as base16 YAML"],"uynXup": [["tokens", "plural", { "one": ["token"], "other": ["tokens"] }]],"v-h2hx": ["Delete ", ["targetGitPath"]],+ "v15iQB": [+ "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+ ],"v2ZW0K": ["Enable terminal"],"v2a04T": ["markdownlint rules"],"v41fCm": ["File not found"],diff --git a/packages/app/src/locales/en/messages.po b/packages/app/src/locales/en/messages.poindex db5ee69b2..85a5e569c 100644--- a/packages/app/src/locales/en/messages.po+++ b/packages/app/src/locales/en/messages.po@@ -263,6 +263,11 @@ msgstr "{0, plural, one {Matches {1} of {2} doc right now.} other {Matches {3} omsgid "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"msgstr "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"+#. placeholder {0}: pluginRows.length+#: src/components/CreatedItemsList.tsx+msgid "{0, plural, one {Plugin} other {Plugins}}"+msgstr "{0, plural, one {Plugin} other {Plugins}}"+#. placeholder {0}: editorList.hiddenCount#: src/components/McpConsentDialogBody.tsxmsgid "{0, plural, one {Show # more tool} other {Show # more tools}}"@@ -629,7 +634,9 @@ msgstr "{displayName} CLI, {hint}"msgid "{docName} is {0}. OpenKnowledge currently opens files up to {1}."msgstr "{docName} is {0}. OpenKnowledge currently opens files up to {1}."+#. placeholder {0}: OKF_RULE_IDS.length#. placeholder {0}: entries.length+#: src/components/settings/LintingSection.tsx#: src/components/settings/markdownlint-rule-browser.tsxmsgid "{enabledCount}/{0} on"msgstr "{enabledCount}/{0} on"@@ -792,6 +799,10 @@ msgstr "{percent}% used ({left}% left)"msgid "{phase} — {pct}%"msgstr "{phase} — {pct}%"+#: src/components/CreatedItemsList.tsx+msgid "{pluginCount, plural, one {plugin} other {plugins}}"+msgstr "{pluginCount, plural, one {plugin} other {plugins}}"+#: src/components/PropertyDisclosure.tsxmsgid "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"msgstr "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"@@ -1547,6 +1558,10 @@ msgstr "Already covered by a picked parent folder"msgid "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."msgstr "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."+#: src/components/settings/LintingSection.tsx+msgid "Already in project"+msgstr "Already in project"+#: src/components/SkillPluginBundleDialog.tsxmsgid "Already installed — nothing new to import."msgstr "Already installed — nothing new to import."@@ -1592,6 +1607,10 @@ msgstr "Another sync operation is in progress. Try again in a moment."msgid "any"msgstr "any"+#: src/components/settings/LintingSection.tsx+msgid "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+msgstr "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+#. placeholder {0}: summary.name#: src/components/settings/LintingSection.tsxmsgid "any doc named {0}"@@ -2152,6 +2171,7 @@ msgstr "Can't share this path."#: src/components/ReportBugDialogBody.tsx#: src/components/SeedDialog.tsx#: src/components/settings/LinkPreviewsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/SavedThemesTiles.tsx#: src/components/settings/SearchSection.tsx#: src/components/ShareBranchSwitchDialog.tsx@@ -2292,6 +2312,10 @@ msgstr "Checking out files"msgid "Checking sign-in status"msgstr "Checking sign-in status"+#: src/components/settings/LintingSection.tsx+msgid "Checking skill"+msgstr "Checking skill"+#: src/components/ImportSkillForm.tsxmsgid "Checking source"msgstr "Checking source"@@ -2308,6 +2332,10 @@ msgstr "Checking..."msgid "Checklist with checkboxes."msgstr "Checklist with checkboxes."+#: src/components/CreatedItemsList.tsx+msgid "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+msgstr "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+#: src/components/ImportSkillForm.tsxmsgid "Choose a skill archive"msgstr "Choose a skill archive"@@ -4304,6 +4332,10 @@ msgstr "Disable {0}"msgid "Disable {file}"msgstr "Disable {file}"+#: src/components/settings/LintingSection.tsx+msgid "Disable {id}"+msgstr "Disable {id}"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "Disable external link previews"msgstr "Disable external link previews"@@ -4406,6 +4438,10 @@ msgstr "Document panels"msgid "Document statistics"msgstr "Document statistics"+#: src/components/settings/LintingSection.tsx+msgid "Document structure"+msgstr "Document structure"+#: src/components/empty-state/use-create-suggestions.tsmsgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."msgstr "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."@@ -4797,6 +4833,10 @@ msgstr "Enable {displayName} CLI"msgid "Enable {file}"msgstr "Enable {file}"+#: src/components/settings/LintingSection.tsx+msgid "Enable {id}"+msgstr "Enable {id}"+#: src/components/AutoSyncOnboardingDialog.tsx#: src/components/EnableSyncConfirmDialog.tsx#: src/components/share-receive-miss-content.tsx@@ -4821,6 +4861,10 @@ msgstr "Enable Follow?"msgid "Enable git auto-sync?"msgstr "Enable git auto-sync?"+#: src/components/settings/LintingSection.tsx+msgid "Enable indexes"+msgstr "Enable indexes"+#: src/components/ProblemsPanel.tsxmsgid "Enable plugins"msgstr "Enable plugins"@@ -4849,6 +4893,10 @@ msgstr "Enable terminal for this project"msgid "Enable Themes"msgstr "Enable Themes"+#: src/components/settings/LintingSection.tsx+msgid "Enabling index generation"+msgstr "Enabling index generation"+#: src/components/ActivityModeContent.tsxmsgid "Ended"msgstr "Ended"@@ -4919,6 +4967,10 @@ msgstr "Error:"msgid "Escape"msgstr "Escape"+#: src/components/settings/LintingSection.tsx+msgid "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+msgstr "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+#: src/components/settings/LintingSection.tsxmsgid "every doc"msgstr "every doc"@@ -5694,6 +5746,10 @@ msgstr "From template"msgid "From the {0} plugin"msgstr "From the {0} plugin"+#: src/components/settings/LintingSection.tsx+msgid "Frontmatter"+msgstr "Frontmatter"+#: src/components/TemplateForm.tsxmsgid "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."msgstr "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."@@ -5736,6 +5792,10 @@ msgstr "Game over · press space to play again"msgid "General"msgstr "General"+#: src/components/settings/LintingSection.tsx+msgid "Generated files"+msgstr "Generated files"+#: src/components/TerminalCliMissingBanner.tsxmsgid "Get {displayName}"msgstr "Get {displayName}"@@ -5769,6 +5829,10 @@ msgstr "git configuration is unavailable"msgid "Git identity isn't set — commits use a default author. Set yours so teammates see your name."msgstr "Git identity isn't set — commits use a default author. Set yours so teammates see your name."+#: src/components/settings/LintingSection.tsx+msgid "Git merge rule"+msgstr "Git merge rule"+#: src/components/ShareBranchSwitchDialog.tsxmsgid "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."msgstr "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."@@ -5923,7 +5987,7 @@ msgstr "heading-slug"msgid "Headings"msgstr "Headings"-#: src/components/AutoSyncEnableWarning.tsx+#: src/components/DisclosureWarning.tsx#: src/editor/slash-command/component-items.tsxmsgid "Heads up"msgstr "Heads up"@@ -5945,6 +6009,10 @@ msgstr "Hello, world!"msgid "Help"msgstr "Help"+#: src/components/settings/LintingSection.tsx+msgid "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+msgstr "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+#. Subtext for the open-knowledge-discovery skill row#. Subtext for the open-knowledge-discovery skill row#: src/components/McpConsentDialogBody.tsx@@ -6277,10 +6345,18 @@ msgstr "Imported as \"{0}\" — the name \"{1}\" was taken."msgid "Importing"msgstr "Importing"+#: src/components/settings/LintingSection.tsx+msgid "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+msgstr "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+#: src/components/SeedDialog.tsxmsgid "In a subfolder"msgstr "In a subfolder"+#: src/components/settings/LintingSection.tsx+msgid "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+msgstr "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+#: src/components/empty-state/CreatePromptComposer.tsx#: src/components/handoff/AgentSplitButton.tsx#: src/components/handoff/OpenInAgentContextSubmenu.tsx@@ -6299,6 +6375,14 @@ msgstr "In app"msgid "In app (beta)"msgstr "In app (beta)"+#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+msgstr "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."++#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+msgstr "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "In the Claude Desktop App"msgstr "In the Claude Desktop App"@@ -6323,6 +6407,26 @@ msgstr "Indent or outdent the current list item."msgid "Indented blockquote for citations."msgstr "Indented blockquote for citations."+#: src/components/settings/LintingSection.tsx+msgid "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+msgstr "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+msgstr "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+msgstr "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+msgstr "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+msgstr "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+#: src/components/settings/SearchSection.tsxmsgid "Indexed {embedded} of {total} pages."msgstr "Indexed {embedded} of {total} pages."@@ -6511,6 +6615,10 @@ msgstr "Install on all agents"msgid "Install selected"msgstr "Install selected"+#: src/components/settings/LintingSection.tsx+msgid "Install skill"+msgstr "Install skill"+#: src/components/SkillPluginBundleBanner.tsxmsgid "Install skills"msgstr "Install skills"@@ -6520,6 +6628,7 @@ msgid "Install the gh CLI"msgstr "Install the gh CLI"#: src/components/settings/AiToolsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ProjectAiToolsSection.tsx#: src/components/SkillEditorActions.tsxmsgid "Installed"@@ -6733,6 +6842,10 @@ msgstr "Keep this project in sync with your git remote. Follow fetches updates wmsgid "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."msgstr "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."+#: src/components/settings/LintingSection.tsx+msgid "Keeps your knowledge base aligned with the Open Knowledge Format."+msgstr "Keeps your knowledge base aligned with the Open Knowledge Format."+#. placeholder {0}: toName.trim()#: src/components/SkillForkDialog.tsxmsgid "Kept both — \"{0}\" is its own skill now"@@ -7108,6 +7221,14 @@ msgstr "Looking for <0>{lookingForUrl}</0>."msgid "Lost connection to \"{docName}\"."msgstr "Lost connection to \"{docName}\"."+#: src/components/settings/LintingSection.tsx+msgid "Maintain generated indexes in every folder?"+msgstr "Maintain generated indexes in every folder?"++#: src/components/settings/LintingSection.tsx+msgid "Maintain index.md"+msgstr "Maintain index.md"+#: src/components/SkillInstallMenu.tsxmsgid "make source"msgstr "make source"@@ -8252,6 +8373,10 @@ msgstr "OK Desktop"msgid "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."msgstr "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."+#: src/components/settings/LintingSection.tsx+msgid "OKF agent skill installed"+msgstr "OKF agent skill installed"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "On — hovering an external link sends its URL to the destination site to fetch a preview."msgstr "On — hovering an external link sends its URL to the destination site to fetch a preview."@@ -8268,6 +8393,10 @@ msgstr "On <0>{address}</0>"msgid "On selected text in <0>{address}</0>"msgstr "On selected text in <0>{address}</0>"+#: src/components/settings/LintingSection.tsx+msgid "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+msgstr "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+#. Next step for a Cursor project MCP row — Cursor leaves project servers disabled#: src/components/settings/ProjectAiToolsSection.tsxmsgid "One more step: enable it in Cursor → Settings → Tools & MCP (Cursor leaves project servers off until you turn them on)."@@ -8490,6 +8619,22 @@ msgstr "Open in worktree"msgid "Open it there"msgstr "Open it there"+#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+msgstr "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge Format guidance"+msgstr "Open Knowledge Format guidance"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+msgstr "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+msgstr "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+#. placeholder {0}: item.displayName#. placeholder {1}: item.displayName#. placeholder {2}: item.version@@ -8536,6 +8681,10 @@ msgstr "Open settings"msgid "Open shared {targetNoun}"msgstr "Open shared {targetNoun}"+#: src/components/settings/LintingSection.tsx+msgid "Open skill"+msgstr "Open skill"+#: src/editor/extensions/JsxComponentView.tsxmsgid "Open source doc: {mirrorSrc}"msgstr "Open source doc: {mirrorSrc}"@@ -9372,6 +9521,7 @@ msgid "project"msgstr "project"#: src/components/CommandPalette.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ScopeBadge.tsx#: src/lib/skill-scope.tsmsgid "Project"@@ -9643,6 +9793,10 @@ msgstr "Recent project"msgid "Recently opened"msgstr "Recently opened"+#: src/components/settings/LintingSection.tsx+msgid "Recommended agent skill"+msgstr "Recommended agent skill"+#: src/components/SyncStatusBadge.tsxmsgid "Reconnect required"msgstr "Reconnect required"@@ -10080,6 +10234,10 @@ msgstr "Research the extinction of flightless birds"msgid "research-note"msgstr "research-note"+#: src/components/settings/LintingSection.tsx+msgid "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+msgstr "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+#: src/components/settings/CustomThemeEditor.tsxmsgid "Reset"msgstr "Reset"@@ -10322,6 +10480,7 @@ msgid "Rule editing is available for the project's root markdownlint config"msgstr "Rule editing is available for the project's root markdownlint config"#: src/components/LintConfigEditor.tsx+#: src/components/settings/LintingSection.tsxmsgid "Rules"msgstr "Rules"@@ -11264,6 +11423,10 @@ msgstr "Skill \"{conflictName}\" was not installed for {conflictHosts} — you amsgid "Skill \"{name}\" created"msgstr "Skill \"{name}\" created"+#: src/components/settings/LintingSection.tsx+msgid "Skill already in project"+msgstr "Skill already in project"+#: src/components/ExploreSkills.tsxmsgid "Skill discovery powered by <0>skills.sh</0>"msgstr "Skill discovery powered by <0>skills.sh</0>"@@ -11523,6 +11686,10 @@ msgstr "Start from"msgid "Start here: what this is and how it's organized."msgstr "Start here: what this is and how it's organized."+#: src/components/settings/LintingSection.tsx+msgid "Start maintaining index.md"+msgstr "Start maintaining index.md"+#: src/lib/keyboard-shortcuts.tsmsgid "Start source completion"msgstr "Start source completion"@@ -11618,6 +11785,10 @@ msgstr "Stop fixing files"msgid "Stop fixing. Files already fixed stay fixed."msgstr "Stop fixing. Files already fixed stay fixed."+#: src/components/settings/LintingSection.tsx+msgid "Stop maintaining index.md"+msgstr "Stop maintaining index.md"+#: src/lib/project-fix-sweep-store.tsmsgid "Stopped fixing. Files already fixed stay fixed."msgstr "Stopped fixing. Files already fixed stay fixed."@@ -12121,6 +12292,10 @@ msgstr "The agent isn't stopping. Force stop closes this chat and quits the agenmsgid "The agent's persona, values, and voice."msgstr "The agent's persona, values, and voice."+#: src/components/settings/LintingSection.tsx+msgid "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+msgstr "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+#: src/components/ProblemsPanel.tsxmsgid "The audit could not be completed. Try again."msgstr "The audit could not be completed. Try again."@@ -12179,6 +12354,10 @@ msgstr "The formula <0>c = √(a² + b²)</0> renders inline."msgid "the git exclude file isn't writable"msgstr "the git exclude file isn't writable"+#: src/components/settings/LintingSection.tsx+msgid "The index files stay in place. Open Knowledge removes only the Git rule it added."+msgstr "The index files stay in place. Open Knowledge removes only the Git rule it added."+#: src/lib/locale-load-failure-notice.tsmsgid "The interface is still in the language you were reading. Check your connection, then reload to try again."msgstr "The interface is still in the language you were reading. Check your connection, then reload to try again."@@ -12215,6 +12394,10 @@ msgstr "The properties block at the top of this doc has a formatting error. Switmsgid "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."msgstr "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."+#: src/components/settings/LintingSection.tsx+msgid "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+msgstr "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+#: src/components/settings/SearchSection.tsxmsgid "The provider is rate-limiting this key. Try again in a moment."msgstr "The provider is rate-limiting this key. Try again in a moment."@@ -12252,6 +12435,10 @@ msgstr "The schema file does not exist or failed to load — adding a field creamsgid "the server responded but server.lock has no port yet"msgstr "the server responded but server.lock has no port yet"+#: src/components/settings/LintingSection.tsx+msgid "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+msgstr "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+#: src/components/SkillInstallMenu.tsxmsgid "The skill's own folder — the source other locations copy or link from"msgstr "The skill's own folder — the source other locations copy or link from"@@ -12565,6 +12752,10 @@ msgstr "This may take a moment. Your markdown content is kept."msgid "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."msgstr "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."+#: src/components/settings/LintingSection.tsx+msgid "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+msgstr "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+#: src/components/SeedDialog.tsxmsgid "This pack is already set up here."msgstr "This pack is already set up here."@@ -12928,6 +13119,10 @@ msgstr "Turn {0} back into a real directory holding a per-skill symlink for eachmsgid "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."msgstr "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."+#: src/components/CreatedItemsList.tsx+msgid "Turn it off any time in Settings."+msgstr "Turn it off any time in Settings."+#: src/components/NotInSidebarIndicator.tsxmsgid "Turn off Only markdown files"msgstr "Turn off Only markdown files"@@ -12953,6 +13148,10 @@ msgstr "Turn on semantic search?"msgid "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."msgstr "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."+#: src/components/settings/LintingSection.tsx+msgid "Turning it off"+msgstr "Turning it off"+#: src/components/acp/working-status.tsmsgid "Turning it over…"msgstr "Turning it over…"@@ -13643,6 +13842,10 @@ msgstr "Wiki link"msgid "Wiki link suggestions"msgstr "Wiki link suggestions"+#: src/components/settings/LintingSection.tsx+msgid "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+msgstr "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+#: src/components/PublishToGitHubDialog.tsxmsgid "Will be created as <0>{sanitizedName}</0>"msgstr "Will be created as <0>{sanitizedName}</0>"diff --git a/packages/app/src/locales/es/messages.json b/packages/app/src/locales/es/messages.jsonindex 58406aa18..b0a3e45e7 100644--- a/packages/app/src/locales/es/messages.json+++ b/packages/app/src/locales/es/messages.json@@ -139,6 +139,9 @@"0ySP5u": ["Los cambios se guardan automáticamente en este tema."],"0zAhu6": ["todos los documentos"],"10g8I_": ["Desactivar Solo archivos markdown"],+ "110eEb": [+ "Open Knowledge crea y mantiene un archivo de navegación llamado index.md en cada carpeta que contiene Markdown."+ ],"11ukmX": ["Falló al renombrar: ", ["0"]],"12F9WL": ["(sin id)"],"151wvk": ["Mostrar la barra lateral"],@@ -160,6 +163,9 @@"1GhYxC": ["de ", ["totalPages"]],"1HBhDS": ["Extrayendo archivos"],"1J0c0X": ["Sigue sin poder conectarse con ", ["displayName"], ". ¿Intentarlo una vez más?"],+ "1JpLgH": [+ "En un documento índice: las entradas se encuentran bajo un título de sección y cada una lleva un enlace. La prosa alrededor de las listas está bien."+ ],"1LtA5r": ["Enlaza simbólicamente la habilidad a ", ["path"]],"1MGRQl": ["Sesiones de terminal"],"1NgrlY": ["Otras formas de instalarlo"],@@ -173,6 +179,7 @@"1XSMhZ": ["Cambiar a <0>solo local</0> se rechazará hasta que dejen de seguirse con<1> git rm --cached</1>."],+ "1ZXkqM": ["Puedes desactivarlo en cualquier momento en Configuración."],"1ZpfyB": ["Abrir con la IA ", ["displayName"], ", ", ["hint"]],"1a6ICf": ["Siguiendo las ediciones del agente"],"1bDVu5": ["Paleta de comandos del espacio de trabajo"],@@ -339,6 +346,8 @@"3o3tur": ["Contenido inicial"],"3oh0nQ": ["Error en el .okignore anidado de ", ["path"]],"3pU8e-": ["Fijar pestaña"],+ "3qDsdf": ["Instalar habilidad"],+ "3ri_4O": ["Mantiene tu base de conocimientos alineada con el Open Knowledge Format."],"3s-k7L": [["0",@@ -512,6 +521,9 @@],"5tcmwY": ["Añadir valor"],"5vAI6Z": ["No encajaba en mi forma de trabajar"],+ "5w38tn": [+ "El mantenimiento del índice permaneció desactivado porque Open Knowledge no pudo comunicarse con el servidor del proyecto. Inténtalo de nuevo cuando el proyecto se vuelva a conectar."+ ],"5wV2qQ": ["y más"],"5y_9lO": ["Esperando la autorización"],"6-wLTJ": [["behind"], " por detrás de origin"],@@ -671,6 +683,7 @@"7d1a0d": ["Público"],"7dZnmw": ["Relevancia"],"7hctf2": ["Describe el proyecto que quieres crear"],+ "7idx48": ["Habilidad de agente OKF instalada"],"7jIIFX": ["¡Ya está todo listo!"],"7kb4LU": ["Aprobado"],"7l15X4": ["falló"],@@ -678,6 +691,13 @@"7m3Ade": ["instalaciones:"],"7qRHf0": ["Instalar para Claude Chat y Cowork"],"7uBlRT": ["Copia el elemento enfocado del árbol de archivos para que Pegar pueda duplicarlo."],+ "7wogIQ": [+ [+ "0",+ "plural",+ { "one": ["Complemento"], "many": ["Complementos"], "other": ["Complementos"] }+ ]+ ],"80c4-P": ["Código copiado al portapapeles"],"81H_23": ["Añadir propiedades"],"851WA-": ["Esto se puede configurar en Ajustes > Herramientas de IA y CLI"],@@ -743,6 +763,7 @@"8nWu1k": ["Diagrama vacío"],"8oWgty": ["Marcar todos los comentarios para enviar"],"8qgfac": ["Servidores MCP"],+ "8rZ1pk": ["Habilitar ", ["id"]],"8ruqQi": ["Enlaces internos rotos"],"8sMErm": ["¿Activar Seguir?"],"8t9CRE": ["Iniciando ", ["agentName"], "…"],@@ -955,6 +976,9 @@"BQKHuL": ["Reiniciar la terminal"],"BQu9Pg": ["Enlace simbólico"],"BUyQnq": ["No se pudo reiniciar el servidor. Prueba `ok start` en esta carpeta."],+ "BVkqD9": [+ "El mantenimiento del índice está en pausa porque otro atributo de Git controla index.md. Actualiza .gitattributes para que las rutas index.md de ese ámbito usen merge=union y vuelve a intentarlo."+ ],"BY-g4_": ["Añadir patrón"],"Ba4D2x": ["Plantilla importada"],"Bdha5y": ["Publicando..."],@@ -973,6 +997,9 @@"Bv5a9_": ["Estadísticas de la selección"],"Bx4EXG": ["Acciones de ", ["label"]],"By-7Pn": ["Activa o desactiva una lista con viñetas."],+ "ByIOcK": [+ "Los archivos de índice permanecen en su lugar. Open Knowledge elimina solo la regla Git que agregó."+ ],"BymzO4": ["Esquema del documento"],"C-mmmK": ["El id del modelo que sirve tu endpoint. El tamaño de su vector se detecta automáticamente; vacía el campo para volver a ",@@ -1022,6 +1049,9 @@"<0>~/.ok/bin</0> y <1>~/.ok/env.sh</1> se conservan en cualquier caso: la aplicación siempre los mantiene."],"CXTwen": ["No se puede editar con seguridad la configuración de este proyecto"],+ "CXcveY": [+ "Open Knowledge mantiene un archivo de navegación llamado index.md en cada carpeta que contiene Markdown, cada uno de los cuales enumera los documentos de esa carpeta por tipo y vincula a sus subcarpetas. Reescribe estos archivos a medida que cambian sus documentos y todo lo que edite en ellos se reemplaza."+ ],"CXj9C-": ["Nombre de la propiedad nueva"],"C_Lyvh": ["No se pudo guardar el ajuste de tema"],"C_WGy8": [@@ -1049,6 +1079,9 @@"Cu6GXQ": ["La carpeta de origen en sí no se mueve."],"CvsD6Y": ["vía ", ["viaTags"]],"CwOXMT": ["Valor de ", ["keyName"]],+ "CxCOFx": [+ "En los proyectos Git, Open Knowledge añade una regla con alcance al archivo .gitattributes de la raíz del repositorio para combinar los cambios simultáneos del índice."+ ],"CxVk-w": ["Comentar en ", ["address"]],"D-NlUC": ["Sistema"],"D-Oh1s": ["Cómo configurar ", ["0"], " (se abre en el navegador)"],@@ -1117,6 +1150,9 @@"DhT_PK": ["OpenKnowledge importó una habilidad"],"DiFKSL": ["Contando archivos markdown"],"DiZ3pq": ["Selector de iconos"],+ "DjNcDy": [+ "Las formas de title, description, resource y tags cuando se usan. Ninguno es obligatorio; declararlos solo fija su tipo, por lo que se marca si tags se escribe como una cadena separada por comas."+ ],"DmkTrb": ["No se pudo crear este tema. Inténtalo de nuevo."],"Dnn2XG": ["Automático"],"DpjYd6": ["Ir al texto anclado"],@@ -1353,6 +1389,9 @@"GNkUvW": ["En cola: se enviará cuando termine esta ejecución"],"GQ3O42": ["Papelera"],"GQDSBN": ["Opciones de diseño"],+ "GROUfG": [+ "Cualquier archivo .mdx. El formato es solo .md, por lo que un lector que busca .md nunca lo abre y, si existe un .md con el mismo nombre, lo lee en su lugar."+ ],"GSYWCm": ["Ocultar el panel del documento"],"GUYwCr": ["Descartar el aviso"],"GUZHkL": ["Faltan colores de la paleta"],@@ -1553,6 +1592,7 @@"IxHMdF": ["No se pudo eliminar ese comentario."],"IxyZXD": ["Captura de pantalla"],"Izh19j": ["Leyendo desde ", ["tail"]],+ "J0uRhj": ["Comprobando habilidad"],"J1XRO3": ["Colores del tema"],"J2Mv98": ["Nombre (p. ej. ", ["login"], ")"],"J2_JuX": ["nada (", ["0"], " no puede coincidir con un documento)"],@@ -1577,6 +1617,7 @@"JHf6qZ": ["[email protected]"],"JJcBCm": [["0"], " en total"],"JK-Ave": ["Ocultar las miniaturas"],+ "JKXcOi": ["Ya está en el proyecto"],"JL3si7": ["Actualizando"],"JLUTgi": ["Todavía no hay etiquetas: escribe `#nombredeetiqueta` en cualquier documento para llenar el índice."@@ -1678,6 +1719,9 @@"L-rMC9": ["Restablecer al valor por defecto"],"L1BQTH": [["0"], " todavía no está instalado: abriendo su página de descarga."],"L1ZE3M": ["Estadísticas del documento"],+ "L3BcJ4": [+ "Esta regla necesita ver tus archivos, no solo el documento abierto, por lo que aparece al ejecutar una auditoría del proyecto y no mientras escribes."+ ],"L3CEC1": ["este elemento"],"L3w0_C": ["Presenta un documento como una presentación de diapositivas en su propia ventana. Añade <0>slides: true</0> al frontmatter de un documento y ábrelo con la acción de Slidev. El renderizado lo gestiona la CLI de Slidev, que OpenKnowledge no incluye."@@ -2186,6 +2230,12 @@"R6ABfU": ["Trabajar directamente, sin paso de planificación"],"R9IDFz": ["Renombra la carpeta en el disco y el id con el que los agentes la invocan."],"R9dK63": ["Imagen de ejemplo"],+ "RB_g_C": [+ "En el índice raíz, okf_version se escribe como una cadena entrecomillada como \"0.2\". Sin comillas, YAML lo lee como un número y 0.10 silenciosamente se convierte en 0.1."+ ],+ "RD6H9q": [+ "Open Knowledge reescribe estos archivos index.md a medida que cambian los documentos, por lo que se reemplazan las ediciones manuales."+ ],"RDjuBN": ["Configuración"],"RDrXh4": ["Configura los ajustes de usuario, de proyecto y de integraciones."],"RG3yW6": ["Introduce un nombre para este tema."],@@ -2255,6 +2305,9 @@"SF9qpO": ["Comparte tu correo para que podamos hacer seguimiento"],"SFEWV6": ["No se pudieron cargar las habilidades de OpenKnowledge. Inténtalo de nuevo."],"SFN6dN": ["Encabezado 3"],+ "SIPelo": [+ "El mantenimiento del índice está en pausa porque Open Knowledge no pudo confirmar la regla de combinación de Git necesaria. Comprueba Git y .gitattributes y vuelve a intentarlo."+ ],"SInSnF": ["Referencia <0>", ["0"], "</0>"],"SItQRc": ["¿Qué te parece OpenKnowledge?"],"SOPwPh": ["Restaurar hasta esta edición"],@@ -2641,6 +2694,7 @@"X7u0xR": [["0"], " plantillas disponibles"],"X8kjQX": ["Volver a autenticarse con GitHub"],"X9VpsP": ["Cargando el contenido de la carpeta"],+ "XAnapw": ["Regla de combinación de Git"],"XAyxsa": ["Extraer rama remota"],"XBBZnv": ["El destino del enlace «", ["shown"], "» no corresponde a un documento existente."],"XBgr2S": ["Copiar aquí"],@@ -2788,6 +2842,9 @@"Y_iImT": ["No se puede resolver el archivo ", ["identity"], ". Ir a la referencia."],"Y_kL7X": ["Personaliza el aspecto y el comportamiento del editor."],"Ya3PlJ": ["Se requiere permiso"],+ "YaVU2F": [+ "En proyectos Git, Open Knowledge también agrega una regla .gitattributes con alcance para que los cambios de índice simultáneos se combinen antes de la siguiente reconstrucción."+ ],"YaeyFh": ["El pull puede sobrescribir ediciones sin confirmar en tus archivos locales."],"Yb82LN": ["ID: ", ["0"]],"Yea-K5": ["Restaurar hasta este punto"],@@ -2931,6 +2988,7 @@"_Bix3-": ["Apariciones de ", ["localizedFirstMessage"]],"_DwR-n": ["Creando…"],"_FLBbi": [["sizeText"], " · secretos ocultos · volcado de fallo sin ocultar"],+ "_G7A92": ["Mantener index.md"],"_GRWOJ": ["¿Cambiar el proveedor de embeddings?"],"_HgF9q": ["Ordenar por"],"_IGfXZ": ["La última vez OpenKnowledge se cerró de forma inesperada."],@@ -3027,10 +3085,12 @@"No se pudo conectar con el servicio de agentes. Asegúrate de que el servidor de OpenKnowledge esté en marcha y actualizado (reinícialo si ya estaba en marcha) y vuelve a intentarlo."],"aalx4E": ["Editando código MDX defectuoso: ", ["reason"]],+ "aatPoi": ["Archivos generados"],"abiHje": ["Eliminar los elementos seleccionados"],"adsMWO": ["Resolviendo deltas"],"ah_ekO": ["\"", ["name"], "\" ya está al día"],"aiArms": ["No pudimos clonar este repositorio."],+ "aiOceC": ["Habilitar índices"],"ajHi4O": ["La sincronización automática está en pausa: no tienes permiso para hacer push a este repositorio. Cambia a Seguir para seguir recibiendo actualizaciones."],@@ -3200,11 +3260,13 @@],"cb-0G0": ["Quitar color"],"ccNps_": ["Solo los modificados"],+ "cd3THN": ["Estructura del documento"],"cd5EXh": ["Informar de un error"],"cdm00A": ["Sin entrantes"],"cdmk8A": ["Cambios sin confirmar"],"cgl-gn": ["Conectado a GitHub"],"chL5IG": ["Comunidad"],+ "ciozf1": ["La habilidad ya está en el proyecto"],"cjtjry": ["Retrocede por el historial de navegación de OpenKnowledge."],"cklVjM": ["Cronología"],"clJ3qM": ["Listo."],@@ -3427,6 +3489,7 @@"fbdLmk": ["Activa o desactiva la negrita."],"fbsiBw": ["Algo salió mal al iniciar la terminal."],"fcgvCA": ["Claude"],+ "fdKQAE": ["Al desactivarlo"],"fdeFfN": ["(archivo binario, sin vista previa)"],"fevEu0": ["Traer los últimos cambios"],"ffH3Rt": ["Añadir comentario (Intro)"],@@ -3523,12 +3586,16 @@"gUx34c": ["El idioma en el que habla OpenKnowledge; Sistema sigue el de tu sistema operativo. Tus notas se quedan en el idioma en el que las escribiste."],+ "gVMkEr": [+ "En un documento de registro, los encabezados de las entradas comienzan con una fecha ISO YYYY-MM-DD y se ordenan de más reciente a más antigua. Tú decides cuántos títulos usar y si las entradas llevan viñetas."+ ],"gY7wnY": ["Iniciando sesión en ", ["agentName"], "…"],"gYz2ep": ["Caduca en ", ["timeLabel"]],"gZElfU": ["Arreglando ", ["0"], " de ", ["1"], " archivos"],"gZiT5e": ["¿Reemplazar estos enlaces simbólicos por copias independientes?"],"gayL_Q": ["Plan de lanzamiento"],"gbHcbI": ["No se pudo eliminar la propiedad"],+ "gfYI3o": ["Deshabilitar ", ["id"]],"gfb-CM": ["No se pudo obtener la rama: inicia sesión en GitHub e inténtalo de nuevo."],"gfdqcY": ["No se pudo aplicar el cambio: ", ["0"]],"gfohmY": ["Conectar herramientas"],@@ -3591,6 +3658,9 @@"hLKfZe": ["Usar un token en su lugar"],"hLod4_": ["Convertir en plantilla"],"hLy8b1": ["Actualizado a la versión ", ["version"]],+ "hPQBsa": [+ "Los archivos reservados se denominan index.md y log.md en minúsculas. En un sistema de archivos que distingue entre mayúsculas y minúsculas, Index.md se lee como un documento normal y pierde su significado."+ ],"hQXiDc": ["Buscar ramas..."],"hQjvzi": ["Un archivo .zip o .skill."],"hS0wC4": ["OpenKnowledge restauró una versión anterior de ", ["subject"]],@@ -3744,6 +3814,9 @@"iz1LdD": ["Se modificó fuera de OK desde la última vez que escribió aquí; el estado que se muestra es el que hay ahora en el disco"],+ "j-o6Z2": [+ "El mantenimiento del índice permaneció desactivado porque no se pudo guardar la configuración del proyecto. Verifique los permisos del archivo del proyecto y vuelva a intentarlo."+ ],"j15ZSH": ["Enviar los comentarios a"],"j2229h": ["Eliminando los archivos de OpenKnowledge…"],"j2kt1j": [@@ -3831,6 +3904,7 @@"k4CuuV": ["Carpetas y plantillas ya hechas para empezar rápido. Selecciona un paquete para ver qué se crea y añádelo después a tu proyecto."],+ "k5rKNs": ["frontmatter"],"k7Hoig": ["No hay cambios de contenido en esta versión."],"k8xtrB": ["No hace falta para un endpoint de localhost como <0>",@@ -3870,7 +3944,9 @@"kV2YZv": ["¿No ves <0>Habilidades</0>? Activa antes <1>Ajustes <2/> Capacidades <3/> Ejecución de código y creación de archivos</1>."],+ "kVS5tE": ["¿Mantener índices generados en cada carpeta?"],"kVgQUA": ["¿Eliminar este chat?"],+ "kVzuTI": ["Habilidad de agente recomendada"],"kYL1lH": ["Actividad del agente"],"k_Dqw1": [[@@ -3973,7 +4049,9 @@"lWNpNB": ["Añade cursores o selecciona coincidencias con CodeMirror."],"lXKZGw": ["Encabezado 1"],"lY27jj": ["hace ", ["0"], " años"],+ "lY7Unt": ["Activando la generación de índices"],"lZAiSP": ["La respuesta de retroenlaces no tenía la forma esperada."],+ "lZoQdy": ["Abrir habilidad"],"lZvQrY": ["Usar ", ["0"], " como tema oscuro"],"l_6JHD": ["Buscar iconos..."],"l_FAT6": ["Usa solo letras, dígitos, <0>-</0> o <1>_</1>."],@@ -3993,6 +4071,13 @@"ljHjfg": ["Esa rama ya está abierta en otro worktree."],"lkYioO": ["Mostrar u ocultar el panel del documento"],"ll2yNl": ["Directorio de contenido"],+ "llXHHh": [+ [+ "pluginCount",+ "plural",+ { "one": ["complemento"], "many": ["complementos"], "other": ["complementos"] }+ ]+ ],"lmBPt0": ["Solo los enlaces externos generan una solicitud. Los enlaces a otros documentos de este proyecto se previsualizan desde el índice local y nunca salen de tu equipo."],@@ -4079,6 +4164,9 @@}]],+ "mhnCt3": [+ "Cada documento conceptual incluye un tipo no vacío. Este es todo el mínimo de conformidad de OKF: un documento que solo tiene un tipo cumple plenamente el formato."+ ],"mk2poV": ["p. ej. server.ts"],"mlvM8g": ["No se pudo volver a colocar ese comentario."],"mmpzAq": ["Ajusta las líneas largas en el editor de código markdown."],@@ -4365,6 +4453,9 @@"qRZh7J": ["Permitir que el tabulador salga del editor de código en lugar de sangrar."],"qSKu2v": ["Navegación y selección en el código"],"qSxaOz": ["Aceptar su eliminación"],+ "qTT48-": [+ "Enlaces wiki como [[Page]]: una forma compatible de vincular aquí, pero un lector externo no resuelve nada y muestra los corchetes."+ ],"qTcVwj": ["Busca o sube una habilidad para este proyecto."],"qTcZZu": ["No se pudieron cargar las etiquetas. Pulsa <0>Esc</0> y vuelve a abrirlo para reintentarlo."@@ -4424,6 +4515,7 @@"r51jLC": ["Archivo guardado y aplicación Claude Desktop abierta"],"r6ncaO": ["Cerrar pestaña"],"r6y-jM": ["Advertencia"],+ "r7IaYp": ["Guía de Open Knowledge Format"],"r871ed": ["Tu base de conocimiento ya está en GitHub, en <0>",["ownerLogin"],@@ -4453,6 +4545,9 @@"rZVMkf": ["Campo de reemplazo del editor visual enfocado"],"radOpL": ["Imagen ", ["identity"], ". Ir a la referencia."],"rageVb": ["HTML personalizado con panel de vista previa en vivo (iframe aislado)."],+ "rarziH": [+ "Ayuda a los agentes de programación a elegir tipos de documento OKF, preservar la procedencia y evitar inventar metadatos no compatibles."+ ],"rbrHTd": ["Aprobado — ", ["optionName"]],"rcJmK8": ["Convertir las ubicaciones en copias"],"rdU729": ["Diseño"],@@ -4509,6 +4604,7 @@"sER-bs": ["Archivos"],"sFhaTJ": ["Distingue entre plantillas de nombre parecido en el menú."],"sGZLfB": ["No se pudieron obtener los repositorios"],+ "sHDllh": ["Dejar de mantener index.md"],"sICrVf": ["Se restauró la versión de ", ["0"]],"sIGbBZ": ["Convertir la selección en nota al pie"],"sIxSSP": ["Resuelve el conflicto en tu terminal"],@@ -4522,6 +4618,7 @@"sOxZaS": ["No se pudo cargar el grafo"],"sQoLn0": ["Salir"],"sR0I-f": ["Contraer todos los archivos"],+ "sSRndh": ["Comience a mantener index.md"],"sW5OjU": ["obligatorio"],"sZ2IOu": ["Este ",@@ -4536,6 +4633,9 @@"saIASg": ["Segundo elemento"],"saYiIO": ["La ruta no puede contener bytes nulos"],"scu3wk": ["Modelo"],+ "scyoP9": [+ "Los documentos de índice no llevan frontmatter, salvo el que está en la raíz de tu base de conocimiento. Los documentos de registro no están incluidos: OKF no limita su frontmatter."+ ],"se-tU0": ["No se pudieron corregir ", ["0"], " de ", ["total"], " archivos."],"seeS6l": ["¿Configurar OpenKnowledge en esta carpeta?"],"sgmRY8": ["Se omitió la descarga de ", ["0"], "."],@@ -4596,6 +4696,9 @@"tHKQ6j": ["Renombrando"],"tKlWWY": ["Emoji"],"tLX6LY": ["OpenKnowledge escribió un documento"],+ "tM5uzl": [+ "Las familias de procedencia, confianza y ciclo de vida: sources, generated, verified, status y stale_after. Cada campo es opcional y la ausencia nunca es un error."+ ],"tN5WTS": ["El proveedor rechazó la solicitud. Revisa la clave de API y el id del modelo."],"tP5DDk": ["Aplicar enlace"],"tUvUfp": ["Usa una carpeta que ya tengas."],@@ -4665,6 +4768,9 @@"uGaIIS": ["Extraer worktree"],"uH_S-u": [["loadErrorTitle"], ": ", ["message"]],"uJfwF8": ["Ya está instalado: no hay nada nuevo que importar."],+ "uK2peg": [+ "Comprueba tu proyecto con Open Knowledge Format. Puedes desactivarlo en cualquier momento en Configuración."+ ],"uKRYiW": ["Estado de sincronización no disponible: error del servidor."],"uL_Wx8": ["La terminal se detuvo de forma inesperada."],"uM6jnS": ["Falló la restauración"],@@ -4726,6 +4832,9 @@"uyOQ4e": ["Tema copiado como YAML base16"],"uynXup": [["tokens", "plural", { "one": ["token"], "many": ["tokens"], "other": ["tokens"] }]],"v-h2hx": ["Eliminar ", ["targetGitPath"]],+ "v15iQB": [+ "El contrato de cálculo certificado. Solo se aplica a documentos de tipo Attested Computation, para los que OKF requiere un runtime; los conceptos normales no se ven afectados."+ ],"v2ZW0K": ["Activar la terminal"],"v2a04T": ["Reglas de markdownlint"],"v41fCm": ["No se encontró el archivo"],diff --git a/packages/app/src/locales/es/messages.po b/packages/app/src/locales/es/messages.poindex d26277600..045f7cd9f 100644--- a/packages/app/src/locales/es/messages.po+++ b/packages/app/src/locales/es/messages.po@@ -263,6 +263,11 @@ msgstr "{0, plural, one {Ahora mismo coincide con {1} de {2} documento.} many {Amsgid "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"msgstr "{0, plural, one {Sin problemas en # documento.} many {Sin problemas en # documentos.} other {Sin problemas en # documentos.}}"+#. placeholder {0}: pluginRows.length+#: src/components/CreatedItemsList.tsx+msgid "{0, plural, one {Plugin} other {Plugins}}"+msgstr "{0, plural, one {Complemento} many {Complementos} other {Complementos}}"+#. placeholder {0}: editorList.hiddenCount#: src/components/McpConsentDialogBody.tsxmsgid "{0, plural, one {Show # more tool} other {Show # more tools}}"@@ -629,7 +634,9 @@ msgstr "CLI de {displayName}, {hint}"msgid "{docName} is {0}. OpenKnowledge currently opens files up to {1}."msgstr "{docName} ocupa {0}. Por ahora OpenKnowledge abre archivos de hasta {1}."+#. placeholder {0}: OKF_RULE_IDS.length#. placeholder {0}: entries.length+#: src/components/settings/LintingSection.tsx#: src/components/settings/markdownlint-rule-browser.tsxmsgid "{enabledCount}/{0} on"msgstr "{enabledCount}/{0} activos"@@ -792,6 +799,10 @@ msgstr "{percent}% usado (queda {left}%)"msgid "{phase} — {pct}%"msgstr "{phase} — {pct}%"+#: src/components/CreatedItemsList.tsx+msgid "{pluginCount, plural, one {plugin} other {plugins}}"+msgstr "{pluginCount, plural, one {complemento} many {complementos} other {complementos}}"+#: src/components/PropertyDisclosure.tsxmsgid "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"msgstr "{problemCount, plural, one {# propiedad no coincide con el esquema} many {# propiedades no coinciden con el esquema} other {# propiedades no coinciden con el esquema}}"@@ -1547,6 +1558,10 @@ msgstr "Ya cubierta por una carpeta principal seleccionada"msgid "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."msgstr "¿Ya tienes un repositorio git? Añádelo con <0>git remote add origin <url></0> en la carpeta de este proyecto. Esta página se actualiza automáticamente en cuanto se detecta un remoto."+#: src/components/settings/LintingSection.tsx+msgid "Already in project"+msgstr "Ya está en el proyecto"+#: src/components/SkillPluginBundleDialog.tsxmsgid "Already installed — nothing new to import."msgstr "Ya está instalado: no hay nada nuevo que importar."@@ -1592,6 +1607,10 @@ msgstr "Hay otra operación de sincronización en curso. Inténtalo de nuevo enmsgid "any"msgstr "cualquiera"+#: src/components/settings/LintingSection.tsx+msgid "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+msgstr "Cualquier archivo .mdx. El formato es solo .md, por lo que un lector que busca .md nunca lo abre y, si existe un .md con el mismo nombre, lo lee en su lugar."+#. placeholder {0}: summary.name#: src/components/settings/LintingSection.tsxmsgid "any doc named {0}"@@ -2152,6 +2171,7 @@ msgstr "No se puede compartir esta ruta."#: src/components/ReportBugDialogBody.tsx#: src/components/SeedDialog.tsx#: src/components/settings/LinkPreviewsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/SavedThemesTiles.tsx#: src/components/settings/SearchSection.tsx#: src/components/ShareBranchSwitchDialog.tsx@@ -2292,6 +2312,10 @@ msgstr "Extrayendo archivos"msgid "Checking sign-in status"msgstr "Comprobando el estado de la sesión"+#: src/components/settings/LintingSection.tsx+msgid "Checking skill"+msgstr "Comprobando habilidad"+#: src/components/ImportSkillForm.tsxmsgid "Checking source"msgstr "Comprobando el origen"@@ -2308,6 +2332,10 @@ msgstr "Comprobando..."msgid "Checklist with checkboxes."msgstr "Lista de comprobación con casillas."+#: src/components/CreatedItemsList.tsx+msgid "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+msgstr "Comprueba tu proyecto con Open Knowledge Format. Puedes desactivarlo en cualquier momento en Configuración."+#: src/components/ImportSkillForm.tsxmsgid "Choose a skill archive"msgstr "Elige un archivo de habilidad"@@ -4304,6 +4332,10 @@ msgstr "Desactivar {0}"msgid "Disable {file}"msgstr "Desactivar {file}"+#: src/components/settings/LintingSection.tsx+msgid "Disable {id}"+msgstr "Deshabilitar {id}"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "Disable external link previews"msgstr "Desactivar la vista previa de enlaces externos"@@ -4406,6 +4438,10 @@ msgstr "Paneles del documento"msgid "Document statistics"msgstr "Estadísticas del documento"+#: src/components/settings/LintingSection.tsx+msgid "Document structure"+msgstr "Estructura del documento"+#: src/components/empty-state/use-create-suggestions.tsmsgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."msgstr "Documenta la arquitectura de este repositorio: crea una página general que enlace a una página por cada módulo principal describiendo sus responsabilidades y sus puntos de entrada."@@ -4797,6 +4833,10 @@ msgstr "Activar la CLI de {displayName}"msgid "Enable {file}"msgstr "Activar {file}"+#: src/components/settings/LintingSection.tsx+msgid "Enable {id}"+msgstr "Habilitar {id}"+#: src/components/AutoSyncOnboardingDialog.tsx#: src/components/EnableSyncConfirmDialog.tsx#: src/components/share-receive-miss-content.tsx@@ -4821,6 +4861,10 @@ msgstr "¿Activar Seguir?"msgid "Enable git auto-sync?"msgstr "¿Activar la sincronización automática de git?"+#: src/components/settings/LintingSection.tsx+msgid "Enable indexes"+msgstr "Habilitar índices"+#: src/components/ProblemsPanel.tsxmsgid "Enable plugins"msgstr "Activar los complementos"@@ -4849,6 +4893,10 @@ msgstr "Activar la terminal en este proyecto"msgid "Enable Themes"msgstr "Activar los temas"+#: src/components/settings/LintingSection.tsx+msgid "Enabling index generation"+msgstr "Activando la generación de índices"+#: src/components/ActivityModeContent.tsxmsgid "Ended"msgstr "Terminado"@@ -4919,6 +4967,10 @@ msgstr "Error:"msgid "Escape"msgstr "Esc"+#: src/components/settings/LintingSection.tsx+msgid "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+msgstr "Cada documento conceptual incluye un tipo no vacío. Este es todo el mínimo de conformidad de OKF: un documento que solo tiene un tipo cumple plenamente el formato."+#: src/components/settings/LintingSection.tsxmsgid "every doc"msgstr "todos los documentos"@@ -5694,6 +5746,10 @@ msgstr "Desde plantilla"msgid "From the {0} plugin"msgstr "Del complemento {0}"+#: src/components/settings/LintingSection.tsx+msgid "Frontmatter"+msgstr "frontmatter"+#: src/components/TemplateForm.tsxmsgid "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."msgstr "El frontmatter con el que empieza cada documento creado a partir de esta plantilla. Los valores son YAML: una lista es <0>[a, b]</0>; <1>{{date}}</1> se rellena al crearlo."@@ -5736,6 +5792,10 @@ msgstr "Fin del juego · pulsa espacio para jugar de nuevo"msgid "General"msgstr "General"+#: src/components/settings/LintingSection.tsx+msgid "Generated files"+msgstr "Archivos generados"+#: src/components/TerminalCliMissingBanner.tsxmsgid "Get {displayName}"msgstr "Obtener {displayName}"@@ -5769,6 +5829,10 @@ msgstr "La configuración de git no está disponible"msgid "Git identity isn't set — commits use a default author. Set yours so teammates see your name."msgstr "No has definido tu identidad de git: los commits usan un autor por defecto. Define la tuya para que tus compañeros vean tu nombre."+#: src/components/settings/LintingSection.tsx+msgid "Git merge rule"+msgstr "Regla de combinación de Git"+#: src/components/ShareBranchSwitchDialog.tsxmsgid "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."msgstr "Git necesita {tool} para este repositorio, pero no está instalado o no se ha encontrado. Instálalo y vuelve a intentarlo."@@ -5923,7 +5987,7 @@ msgstr "slug-de-encabezado"msgid "Headings"msgstr "Encabezados"-#: src/components/AutoSyncEnableWarning.tsx+#: src/components/DisclosureWarning.tsx#: src/editor/slash-command/component-items.tsxmsgid "Heads up"msgstr "Atención"@@ -5945,6 +6009,10 @@ msgstr "¡Hola, mundo!"msgid "Help"msgstr "Ayuda"+#: src/components/settings/LintingSection.tsx+msgid "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+msgstr "Ayuda a los agentes de programación a elegir tipos de documento OKF, preservar la procedencia y evitar inventar metadatos no compatibles."+#. Subtext for the open-knowledge-discovery skill row#. Subtext for the open-knowledge-discovery skill row#: src/components/McpConsentDialogBody.tsx@@ -6277,10 +6345,18 @@ msgstr "Se importó como \"{0}\": el nombre \"{1}\" ya estaba ocupado."msgid "Importing"msgstr "Importando"+#: src/components/settings/LintingSection.tsx+msgid "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+msgstr "En un documento de registro, los encabezados de las entradas comienzan con una fecha ISO YYYY-MM-DD y se ordenan de más reciente a más antigua. Tú decides cuántos títulos usar y si las entradas llevan viñetas."+#: src/components/SeedDialog.tsxmsgid "In a subfolder"msgstr "En una subcarpeta"+#: src/components/settings/LintingSection.tsx+msgid "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+msgstr "En un documento índice: las entradas se encuentran bajo un título de sección y cada una lleva un enlace. La prosa alrededor de las listas está bien."+#: src/components/empty-state/CreatePromptComposer.tsx#: src/components/handoff/AgentSplitButton.tsx#: src/components/handoff/OpenInAgentContextSubmenu.tsx@@ -6299,6 +6375,14 @@ msgstr "En la aplicación"msgid "In app (beta)"msgstr "En la aplicación (beta)"+#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+msgstr "En los proyectos Git, Open Knowledge añade una regla con alcance al archivo .gitattributes de la raíz del repositorio para combinar los cambios simultáneos del índice."++#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+msgstr "En proyectos Git, Open Knowledge también agrega una regla .gitattributes con alcance para que los cambios de índice simultáneos se combinen antes de la siguiente reconstrucción."+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "In the Claude Desktop App"msgstr "En la aplicación Claude Desktop"@@ -6323,6 +6407,26 @@ msgstr "Aumenta o reduce la sangría del elemento de lista actual."msgid "Indented blockquote for citations."msgstr "Cita en bloque con sangría para citar fuentes."+#: src/components/settings/LintingSection.tsx+msgid "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+msgstr "Los documentos de índice no llevan frontmatter, salvo el que está en la raíz de tu base de conocimiento. Los documentos de registro no están incluidos: OKF no limita su frontmatter."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+msgstr "El mantenimiento del índice está en pausa porque otro atributo de Git controla index.md. Actualiza .gitattributes para que las rutas index.md de ese ámbito usen merge=union y vuelve a intentarlo."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+msgstr "El mantenimiento del índice está en pausa porque Open Knowledge no pudo confirmar la regla de combinación de Git necesaria. Comprueba Git y .gitattributes y vuelve a intentarlo."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+msgstr "El mantenimiento del índice permaneció desactivado porque Open Knowledge no pudo comunicarse con el servidor del proyecto. Inténtalo de nuevo cuando el proyecto se vuelva a conectar."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+msgstr "El mantenimiento del índice permaneció desactivado porque no se pudo guardar la configuración del proyecto. Verifique los permisos del archivo del proyecto y vuelva a intentarlo."+#: src/components/settings/SearchSection.tsxmsgid "Indexed {embedded} of {total} pages."msgstr "Se indexaron {embedded} de {total} páginas."@@ -6511,6 +6615,10 @@ msgstr "Instalar en todos los agentes"msgid "Install selected"msgstr "Instalar lo seleccionado"+#: src/components/settings/LintingSection.tsx+msgid "Install skill"+msgstr "Instalar habilidad"+#: src/components/SkillPluginBundleBanner.tsxmsgid "Install skills"msgstr "Instalar habilidades"@@ -6520,6 +6628,7 @@ msgid "Install the gh CLI"msgstr "Instalar la CLI de gh"#: src/components/settings/AiToolsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ProjectAiToolsSection.tsx#: src/components/SkillEditorActions.tsxmsgid "Installed"@@ -6733,6 +6842,10 @@ msgstr "Mantén este proyecto sincronizado con tu remoto de git. Seguir obtienemsgid "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."msgstr "Lleva la cuenta de las personas y empresas con las que trabajas y de las reuniones que tienes con ellas. Va bien para recordar quién es alguien, de qué la conoces y de qué hablasteis la última vez."+#: src/components/settings/LintingSection.tsx+msgid "Keeps your knowledge base aligned with the Open Knowledge Format."+msgstr "Mantiene tu base de conocimientos alineada con el Open Knowledge Format."+#. placeholder {0}: toName.trim()#: src/components/SkillForkDialog.tsxmsgid "Kept both — \"{0}\" is its own skill now"@@ -7108,6 +7221,14 @@ msgstr "Buscando <0>{lookingForUrl}</0>."msgid "Lost connection to \"{docName}\"."msgstr "Se perdió la conexión con \"{docName}\"."+#: src/components/settings/LintingSection.tsx+msgid "Maintain generated indexes in every folder?"+msgstr "¿Mantener índices generados en cada carpeta?"++#: src/components/settings/LintingSection.tsx+msgid "Maintain index.md"+msgstr "Mantener index.md"+#: src/components/SkillInstallMenu.tsxmsgid "make source"msgstr "convertir en origen"@@ -8252,6 +8373,10 @@ msgstr "OK Desktop"msgid "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."msgstr "La última vez OK dejó esta carpeta en {0}; algo ajeno a OK lo ha cambiado desde entonces. El estado que se muestra es el que hay ahora en el disco; tu próximo Enlazar/Desenlazar manda."+#: src/components/settings/LintingSection.tsx+msgid "OKF agent skill installed"+msgstr "Habilidad de agente OKF instalada"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "On — hovering an external link sends its URL to the destination site to fetch a preview."msgstr "Activada: al pasar el cursor por un enlace externo se envía su URL al sitio de destino para obtener una vista previa."@@ -8268,6 +8393,10 @@ msgstr "En <0>{address}</0>"msgid "On selected text in <0>{address}</0>"msgstr "Sobre el texto seleccionado en <0>{address}</0>"+#: src/components/settings/LintingSection.tsx+msgid "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+msgstr "En el índice raíz, okf_version se escribe como una cadena entrecomillada como \"0.2\". Sin comillas, YAML lo lee como un número y 0.10 silenciosamente se convierte en 0.1."+#. Next step for a Cursor project MCP row — Cursor leaves project servers disabled#: src/components/settings/ProjectAiToolsSection.tsxmsgid "One more step: enable it in Cursor → Settings → Tools & MCP (Cursor leaves project servers off until you turn them on)."@@ -8490,6 +8619,22 @@ msgstr "Abrir en un worktree"msgid "Open it there"msgstr "Abrirlo ahí"+#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+msgstr "Open Knowledge crea y mantiene un archivo de navegación llamado index.md en cada carpeta que contiene Markdown."++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge Format guidance"+msgstr "Guía de Open Knowledge Format"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+msgstr "Open Knowledge mantiene un archivo de navegación llamado index.md en cada carpeta que contiene Markdown, cada uno de los cuales enumera los documentos de esa carpeta por tipo y vincula a sus subcarpetas. Reescribe estos archivos a medida que cambian sus documentos y todo lo que edite en ellos se reemplaza."++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+msgstr "Open Knowledge reescribe estos archivos index.md a medida que cambian los documentos, por lo que se reemplazan las ediciones manuales."+#. placeholder {0}: item.displayName#. placeholder {1}: item.displayName#. placeholder {2}: item.version@@ -8536,6 +8681,10 @@ msgstr "Abrir los ajustes"msgid "Open shared {targetNoun}"msgstr "Abrir {targetNoun} compartido"+#: src/components/settings/LintingSection.tsx+msgid "Open skill"+msgstr "Abrir habilidad"+#: src/editor/extensions/JsxComponentView.tsxmsgid "Open source doc: {mirrorSrc}"msgstr "Abrir el documento de origen: {mirrorSrc}"@@ -9372,6 +9521,7 @@ msgid "project"msgstr "proyecto"#: src/components/CommandPalette.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ScopeBadge.tsx#: src/lib/skill-scope.tsmsgid "Project"@@ -9643,6 +9793,10 @@ msgstr "Proyecto reciente"msgid "Recently opened"msgstr "Abiertos recientemente"+#: src/components/settings/LintingSection.tsx+msgid "Recommended agent skill"+msgstr "Habilidad de agente recomendada"+#: src/components/SyncStatusBadge.tsxmsgid "Reconnect required"msgstr "Hay que reconectar"@@ -10080,6 +10234,10 @@ msgstr "Investigar la extinción de las aves no voladoras"msgid "research-note"msgstr "nota-de-investigacion"+#: src/components/settings/LintingSection.tsx+msgid "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+msgstr "Los archivos reservados se denominan index.md y log.md en minúsculas. En un sistema de archivos que distingue entre mayúsculas y minúsculas, Index.md se lee como un documento normal y pierde su significado."+#: src/components/settings/CustomThemeEditor.tsxmsgid "Reset"msgstr "Restablecer"@@ -10322,6 +10480,7 @@ msgid "Rule editing is available for the project's root markdownlint config"msgstr "La edición de reglas está disponible para la configuración raíz de markdownlint del proyecto"#: src/components/LintConfigEditor.tsx+#: src/components/settings/LintingSection.tsxmsgid "Rules"msgstr "Reglas"@@ -11264,6 +11423,10 @@ msgstr "No se instaló la skill «{conflictName}» para {conflictHosts}: ya tienmsgid "Skill \"{name}\" created"msgstr "Se creó la habilidad \"{name}\""+#: src/components/settings/LintingSection.tsx+msgid "Skill already in project"+msgstr "La habilidad ya está en el proyecto"+#: src/components/ExploreSkills.tsxmsgid "Skill discovery powered by <0>skills.sh</0>"msgstr "Descubrimiento de habilidades gracias a <0>skills.sh</0>"@@ -11523,6 +11686,10 @@ msgstr "Empezar desde"msgid "Start here: what this is and how it's organized."msgstr "Empieza aquí: qué es esto y cómo está organizado."+#: src/components/settings/LintingSection.tsx+msgid "Start maintaining index.md"+msgstr "Comience a mantener index.md"+#: src/lib/keyboard-shortcuts.tsmsgid "Start source completion"msgstr "Iniciar el autocompletado del código"@@ -11618,6 +11785,10 @@ msgstr "Dejar de arreglar archivos"msgid "Stop fixing. Files already fixed stay fixed."msgstr "Deja de arreglar. Los archivos ya arreglados se quedan como están."+#: src/components/settings/LintingSection.tsx+msgid "Stop maintaining index.md"+msgstr "Dejar de mantener index.md"+#: src/lib/project-fix-sweep-store.tsmsgid "Stopped fixing. Files already fixed stay fixed."msgstr "Se dejó de arreglar. Los archivos ya arreglados se quedan como están."@@ -12121,6 +12292,10 @@ msgstr "El agente no se detiene. La detención forzada cierra este chat y sale dmsgid "The agent's persona, values, and voice."msgstr "La personalidad, los valores y la voz del agente."+#: src/components/settings/LintingSection.tsx+msgid "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+msgstr "El contrato de cálculo certificado. Solo se aplica a documentos de tipo Attested Computation, para los que OKF requiere un runtime; los conceptos normales no se ven afectados."+#: src/components/ProblemsPanel.tsxmsgid "The audit could not be completed. Try again."msgstr "No se pudo completar la auditoría. Inténtalo de nuevo."@@ -12179,6 +12354,10 @@ msgstr "La fórmula <0>c = √(a² + b²)</0> se renderiza en línea."msgid "the git exclude file isn't writable"msgstr "el archivo de exclusión de git no admite escritura"+#: src/components/settings/LintingSection.tsx+msgid "The index files stay in place. Open Knowledge removes only the Git rule it added."+msgstr "Los archivos de índice permanecen en su lugar. Open Knowledge elimina solo la regla Git que agregó."+#: src/lib/locale-load-failure-notice.tsmsgid "The interface is still in the language you were reading. Check your connection, then reload to try again."msgstr "La interfaz sigue en el idioma que estabas leyendo. Comprueba tu conexión y vuelve a cargar para reintentar."@@ -12215,6 +12394,10 @@ msgstr "El bloque de propiedades del principio de este documento tiene un errormsgid "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."msgstr "Las propiedades cambiaron, pero no se pudieron comparar: el YAML no se pudo analizar. Se muestran ambas versiones tal como están escritas."+#: src/components/settings/LintingSection.tsx+msgid "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+msgstr "Las familias de procedencia, confianza y ciclo de vida: sources, generated, verified, status y stale_after. Cada campo es opcional y la ausencia nunca es un error."+#: src/components/settings/SearchSection.tsxmsgid "The provider is rate-limiting this key. Try again in a moment."msgstr "El proveedor está limitando la frecuencia de esta clave. Inténtalo de nuevo en un momento."@@ -12252,6 +12435,10 @@ msgstr "El archivo de esquema no existe o no se pudo cargar; al añadir un campomsgid "the server responded but server.lock has no port yet"msgstr "el servidor respondió pero server.lock aún no tiene puerto"+#: src/components/settings/LintingSection.tsx+msgid "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+msgstr "Las formas de title, description, resource y tags cuando se usan. Ninguno es obligatorio; declararlos solo fija su tipo, por lo que se marca si tags se escribe como una cadena separada por comas."+#: src/components/SkillInstallMenu.tsxmsgid "The skill's own folder — the source other locations copy or link from"msgstr "La carpeta propia de la habilidad: el origen del que copian o al que enlazan las demás ubicaciones"@@ -12565,6 +12752,10 @@ msgstr "Esto puede tardar un momento. Tu contenido markdown se conserva."msgid "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."msgstr "Esto mueve <0>{name}</0> de {0} a {1}, reubicando sus archivos en el disco y reinstalándola en tus editores en el nivel {2}."+#: src/components/settings/LintingSection.tsx+msgid "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+msgstr "Esta regla necesita ver tus archivos, no solo el documento abierto, por lo que aparece al ejecutar una auditoría del proyecto y no mientras escribes."+#: src/components/SeedDialog.tsxmsgid "This pack is already set up here."msgstr "Este paquete ya está configurado aquí."@@ -12928,6 +13119,10 @@ msgstr "Vuelve a convertir {0} en un directorio real que contiene un enlace simbmsgid "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."msgstr "Vuelve a convertir {display} en un directorio real que contiene un enlace simbólico por cada habilidad que ve ahora mismo: nada deja de funcionar, y a partir de ahí el menú de cada habilidad la gestiona."+#: src/components/CreatedItemsList.tsx+msgid "Turn it off any time in Settings."+msgstr "Puedes desactivarlo en cualquier momento en Configuración."+#: src/components/NotInSidebarIndicator.tsxmsgid "Turn off Only markdown files"msgstr "Desactivar Solo archivos markdown"@@ -12953,6 +13148,10 @@ msgstr "¿Activar la búsqueda semántica?"msgid "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."msgstr "Convierte lo que lees en artículos claros y fiables. Guarda una fuente, averigua qué significa y conserva la versión final para poder apoyarte en ella más adelante."+#: src/components/settings/LintingSection.tsx+msgid "Turning it off"+msgstr "Al desactivarlo"+#: src/components/acp/working-status.tsmsgid "Turning it over…"msgstr "Dándole vueltas…"@@ -13643,6 +13842,10 @@ msgstr "Enlace wiki"msgid "Wiki link suggestions"msgstr "Sugerencias de enlaces wiki"+#: src/components/settings/LintingSection.tsx+msgid "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+msgstr "Enlaces wiki como [[Page]]: una forma compatible de vincular aquí, pero un lector externo no resuelve nada y muestra los corchetes."+#: src/components/PublishToGitHubDialog.tsxmsgid "Will be created as <0>{sanitizedName}</0>"msgstr "Se creará como <0>{sanitizedName}</0>"diff --git a/packages/app/src/locales/fr/messages.json b/packages/app/src/locales/fr/messages.jsonindex 8291e1c6c..bfad8f590 100644--- a/packages/app/src/locales/fr/messages.json+++ b/packages/app/src/locales/fr/messages.json@@ -141,6 +141,9 @@"0ySP5u": ["Les modifications sont automatiquement enregistrées dans ce thème."],"0zAhu6": ["tous les documents"],"10g8I_": ["Désactiver Fichiers markdown uniquement"],+ "110eEb": [+ "Open Knowledge crée et gère un fichier de navigation nommé index.md dans chaque dossier contenant Markdown."+ ],"11ukmX": ["Échec du renommage : ", ["0"]],"12F9WL": ["(aucun id)"],"151wvk": ["Afficher la barre latérale"],@@ -166,6 +169,9 @@["displayName"],". Réessayer une dernière fois ?"],+ "1JpLgH": [+ "Dans un document d'index : les entrées se trouvent sous un en-tête de section et chacune comporte un lien. La prose autour des listes est très bien."+ ],"1LtA5r": ["Crée un lien symbolique de la compétence vers ", ["path"]],"1MGRQl": ["Sessions de terminal"],"1NgrlY": ["Autres méthodes d'installation"],@@ -179,6 +185,7 @@"1XSMhZ": ["Le passage à <0>local uniquement</0> sera refusé tant qu'ils ne seront pas retirés du suivi via<1> git rm --cached</1>."],+ "1ZXkqM": ["Désactivez-le à tout moment dans Paramètres."],"1ZpfyB": ["Ouvrir avec l'IA ", ["displayName"], ", ", ["hint"]],"1a6ICf": ["Suivi des modifications de l'agent"],"1bDVu5": ["Palette de commandes de l'espace de travail"],@@ -353,6 +360,8 @@"3o3tur": ["Contenu de départ"],"3oh0nQ": ["Erreur dans le .okignore imbriqué de ", ["path"]],"3pU8e-": ["Épingler l'onglet"],+ "3qDsdf": ["Installer la compétence"],+ "3ri_4O": ["Maintient votre base de connaissances alignée sur l’Open Knowledge Format."],"3s-k7L": [["0",@@ -534,6 +543,9 @@],"5tcmwY": ["Ajouter une valeur"],"5vAI6Z": ["Cela ne correspondait pas à mon flux de travail"],+ "5w38tn": [+ "La maintenance de l'index est restée désactivée car Open Knowledge n'a pas pu atteindre le serveur du projet. Réessayez lorsque le projet se reconnectera."+ ],"5wV2qQ": ["et plus encore"],"5y_9lO": ["En attente d'autorisation"],"6-wLTJ": [["behind"], " en retard sur origin"],@@ -697,6 +709,7 @@"7d1a0d": ["Public"],"7dZnmw": ["Pertinence"],"7hctf2": ["Décrivez le projet que vous voulez créer"],+ "7idx48": ["Compétence d'agent OKF installée"],"7jIIFX": ["Tout est prêt !"],"7kb4LU": ["Approuvé"],"7l15X4": ["échec"],@@ -706,6 +719,9 @@"7uBlRT": ["Copie l'élément de l'arborescence ayant le focus pour que Coller puisse le dupliquer."],+ "7wogIQ": [+ ["0", "plural", { "one": ["Extension"], "many": ["Extensions"], "other": ["Extensions"] }]+ ],"80c4-P": ["Code copié dans le presse-papiers"],"81H_23": ["Ajouter des propriétés"],"851WA-": ["Cela se configure dans Paramètres > Outils IA et CLI"],@@ -771,6 +787,7 @@"8nWu1k": ["Diagramme vide"],"8oWgty": ["Cocher tous les commentaires à envoyer"],"8qgfac": ["Serveurs MCP"],+ "8rZ1pk": ["Activer ", ["id"]],"8ruqQi": ["Liens internes cassés"],"8sMErm": ["Activer Suivre ?"],"8t9CRE": ["Démarrage de ", ["agentName"], "…"],@@ -983,6 +1000,9 @@"BQKHuL": ["Redémarrer le terminal"],"BQu9Pg": ["Lien symbolique"],"BUyQnq": ["Impossible de redémarrer le serveur. Essayez `ok start` dans ce dossier."],+ "BVkqD9": [+ "La maintenance de l'index est suspendue car un autre attribut Git contrôle index.md. Mettez à jour .gitattributes pour que les chemins index.md définis utilisent merge=union, puis réessayez."+ ],"BY-g4_": ["Ajouter un motif"],"Ba4D2x": ["Modèle importé"],"Bdha5y": ["Publication…"],@@ -1001,6 +1021,9 @@"Bv5a9_": ["Statistiques de la sélection"],"Bx4EXG": ["Actions pour ", ["label"]],"By-7Pn": ["Bascule une liste à puces."],+ "ByIOcK": [+ "Les fichiers d'index restent en place. Open Knowledge supprime uniquement la règle Git qu'il a ajoutée."+ ],"BymzO4": ["Plan du document"],"C-mmmK": ["L'id du modèle servi par votre point de terminaison. La taille de ses vecteurs est détectée automatiquement — videz le champ pour revenir à ",@@ -1048,6 +1071,9 @@"<0>~/.ok/bin</0> et <1>~/.ok/env.sh</1> restent dans les deux cas — l'application les maintient toujours."],"CXTwen": ["Impossible de modifier en toute sécurité la configuration de ce projet"],+ "CXcveY": [+ "Open Knowledge conserve un fichier de navigation nommé index.md dans chaque dossier contenant Markdown, chacun répertoriant les documents de ce dossier par type et établissant un lien vers ses sous-dossiers. Il réécrit ces fichiers à mesure que vos documents changent, et tout ce que vous y modifiez vous-même est remplacé."+ ],"CXj9C-": ["Nom de la nouvelle propriété"],"C_Lyvh": ["Échec de l'enregistrement du réglage de thème"],"C_WGy8": [@@ -1077,6 +1103,9 @@"Cu6GXQ": ["Le dossier source lui-même ne bouge pas."],"CvsD6Y": ["via ", ["viaTags"]],"CwOXMT": ["Valeur de ", ["keyName"]],+ "CxCOFx": [+ "Dans les projets Git, Open Knowledge ajoute une règle ciblée au fichier .gitattributes à la racine du dépôt afin de combiner les modifications simultanées des index."+ ],"CxVk-w": ["Commenter ", ["address"]],"D-NlUC": ["Système"],"D-Oh1s": ["Comment configurer ", ["0"], " (s'ouvre dans le navigateur)"],@@ -1149,6 +1178,9 @@"DhT_PK": ["OpenKnowledge a importé une compétence"],"DiFKSL": ["Comptage des fichiers markdown"],"DiZ3pq": ["Sélecteur d'icônes"],+ "DjNcDy": [+ "Les formes de title, description, resource et tags lorsque vous les utilisez. Aucun n'est requis ; en déclarer un épingle uniquement son type, donc tags écrit sous forme de chaîne séparée par des virgules est signalé."+ ],"DmkTrb": ["Impossible de créer ce thème. Réessayez."],"Dnn2XG": ["Automatique"],"DpjYd6": ["Aller au texte ancré"],@@ -1388,6 +1420,9 @@"GNkUvW": ["En file d’attente : envoi à la fin de cette exécution"],"GQ3O42": ["corbeille"],"GQDSBN": ["Options de mise en page"],+ "GROUfG": [+ "Tout fichier .mdx. Le format est uniquement .md, donc un lecteur recherchant .md ne l'ouvre jamais - et si un .md du même nom existe, il le lit à la place."+ ],"GSYWCm": ["Masquer le panneau du document"],"GUYwCr": ["Ignorer cet avis"],"GUZHkL": ["Des couleurs de la palette sont manquantes"],@@ -1580,6 +1615,7 @@"IxHMdF": ["Impossible de supprimer ce commentaire."],"IxyZXD": ["Capture d'écran"],"Izh19j": ["Lecture depuis ", ["tail"]],+ "J0uRhj": ["Vérification des compétences"],"J1XRO3": ["Couleurs du thème"],"J2Mv98": ["Nom (par ex. ", ["login"], ")"],"J2_JuX": ["rien (", ["0"], " ne peut correspondre à aucun document)"],@@ -1604,6 +1640,7 @@"JHf6qZ": ["[email protected]"],"JJcBCm": [["0"], " au total"],"JK-Ave": ["Masquer les miniatures"],+ "JKXcOi": ["Déjà en projet"],"JL3si7": ["Mise à jour en cours"],"JLUTgi": ["Pas encore d'étiquettes — écrivez `#nometiquette` dans un document pour alimenter l'index."@@ -1709,6 +1746,9 @@"L-rMC9": ["Réinitialiser à la valeur par défaut"],"L1BQTH": [["0"], " n'est pas encore installé — ouverture de sa page de téléchargement."],"L1ZE3M": ["Statistiques du document"],+ "L3BcJ4": [+ "Celui-ci doit voir vos fichiers, pas seulement le document ouvert, afin qu'il apparaisse lorsque vous exécutez un audit de projet plutôt que pendant que vous tapez."+ ],"L3CEC1": ["cet élément"],"L3w0_C": ["Présentez un document sous forme de diaporama dans sa propre fenêtre. Ajoutez <0>slides: true</0> au frontmatter d'un document, puis ouvrez-le avec l'action Slidev. Le rendu est assuré par la CLI Slidev, qu'OpenKnowledge ne fournit pas."@@ -2219,6 +2259,12 @@"Renomme le dossier sur le disque ainsi que l'id que les agents utilisent pour l'invoquer."],"R9dK63": ["Image d'exemple"],+ "RB_g_C": [+ "Sur l'index racine, okf_version est écrit sous forme de chaîne entre guillemets comme \"0.2\". Non cité, YAML le lit comme un nombre et 0.10 devient silencieusement 0.1."+ ],+ "RD6H9q": [+ "Open Knowledge réécrit ces fichiers index.md à mesure que les documents changent, de sorte que les modifications manuelles apportées à ceux-ci sont remplacées."+ ],"RDjuBN": ["Configuration"],"RDrXh4": ["Configurez les paramètres utilisateur, projet et intégrations."],"RG3yW6": ["Saisissez un nom pour ce thème."],@@ -2288,6 +2334,9 @@"SF9qpO": ["Partagez votre e-mail pour le suivi"],"SFEWV6": ["Impossible de charger les compétences OpenKnowledge. Réessayez."],"SFN6dN": ["Titre 3"],+ "SIPelo": [+ "La maintenance de l'index est suspendue car Open Knowledge n'a pas pu confirmer la règle de fusion Git requise. Vérifiez Git et .gitattributes, puis réessayez."+ ],"SInSnF": ["Référence <0>", ["0"], "</0>"],"SItQRc": ["Que pensez-vous d'OpenKnowledge ?"],"SOPwPh": ["Restaurer à cette modification"],@@ -2680,6 +2729,7 @@"X7u0xR": [["0"], " modèles disponibles"],"X8kjQX": ["Se réauthentifier auprès de GitHub"],"X9VpsP": ["Chargement du contenu du dossier"],+ "XAnapw": ["Règle de fusion Git"],"XAyxsa": ["Extraire une branche distante"],"XBBZnv": ["La cible du lien « ", ["shown"], " » ne correspond à aucun document existant."],"XBgr2S": ["Copier ici"],@@ -2824,6 +2874,9 @@"Y_iImT": ["Fichier ", ["identity"], " impossible à résoudre. Accéder à la référence."],"Y_kL7X": ["Personnalisez l'apparence et le comportement de l'éditeur."],"Ya3PlJ": ["Autorisation requise"],+ "YaVU2F": [+ "Dans les projets Git, Open Knowledge ajoute également une règle .gitattributes étendue afin que les modifications d'index simultanées se combinent avant la prochaine reconstruction."+ ],"YaeyFh": ["Les tirages peuvent écraser des modifications non validées dans vos fichiers locaux."],@@ -2967,6 +3020,7 @@"_Bix3-": ["Occurrences de ", ["localizedFirstMessage"]],"_DwR-n": ["Création…"],"_FLBbi": [["sizeText"], " · secrets masqués · vidage de plantage non masqué"],+ "_G7A92": ["Maintenir index.md"],"_GRWOJ": ["Changer de fournisseur d'embeddings ?"],"_HgF9q": ["Trier par"],"_IGfXZ": ["OpenKnowledge s'est arrêté de façon inattendue la dernière fois."],@@ -3061,10 +3115,12 @@"Impossible de joindre le service d'agents. Vérifiez que le serveur OpenKnowledge est en cours d'exécution et à jour (redémarrez-le s'il tournait déjà), puis réessayez."],"aalx4E": ["Modification d'une source MDX cassée : ", ["reason"]],+ "aatPoi": ["Fichiers générés"],"abiHje": ["Supprimer les éléments sélectionnés"],"adsMWO": ["Résolution des deltas"],"ah_ekO": ["« ", ["name"], " » est déjà à jour"],"aiArms": ["Nous n'avons pas pu cloner ce dépôt."],+ "aiOceC": ["Activer les index"],"ajHi4O": ["La synchronisation automatique est en pause — vous n'avez pas la permission de pousser vers ce dépôt. Passez à Suivre pour continuer à recevoir les mises à jour."],@@ -3239,11 +3295,13 @@],"cb-0G0": ["Effacer la couleur"],"ccNps_": ["Modifiées uniquement"],+ "cd3THN": ["Structure du document"],"cd5EXh": ["Signaler un bug"],"cdm00A": ["Aucun lien entrant"],"cdmk8A": ["Modifications non validées"],"cgl-gn": ["Connecté à GitHub"],"chL5IG": ["Communauté"],+ "ciozf1": ["Compétence déjà en projet"],"cjtjry": ["Recule dans l'historique de navigation d'OpenKnowledge."],"cklVjM": ["Chronologie"],"clJ3qM": ["Terminé."],@@ -3460,6 +3518,7 @@"fbdLmk": ["Bascule la mise en forme grasse."],"fbsiBw": ["Une erreur s'est produite au démarrage du terminal."],"fcgvCA": ["Claude"],+ "fdKQAE": ["L'éteindre"],"fdeFfN": ["(fichier binaire, aperçu impossible)"],"fevEu0": ["Tirer les dernières modifications"],"ffH3Rt": ["Ajouter un commentaire (Entrée)"],@@ -3556,12 +3615,16 @@"gUx34c": ["La langue que parle OpenKnowledge ; Système suit celle de votre système d’exploitation. Vos notes restent dans la langue dans laquelle vous les avez écrites."],+ "gVMkEr": [+ "Dans un document de journal : les en-têtes d'entrée commencent par une date ISO YYYY-MM-DD, la plus récente en premier. Le nombre de title que vous utilisez et le fait que les entrées soient des puces dépendent de vous."+ ],"gY7wnY": ["Connexion à ", ["agentName"], "…"],"gYz2ep": ["Expire dans ", ["timeLabel"]],"gZElfU": ["Correction du fichier ", ["0"], " sur ", ["1"]],"gZiT5e": ["Remplacer ces liens symboliques par des copies indépendantes ?"],"gayL_Q": ["Plan de publication"],"gbHcbI": ["Échec de la suppression de la propriété"],+ "gfYI3o": ["Désactiver ", ["id"]],"gfb-CM": ["Impossible de récupérer la branche — connectez-vous à GitHub et réessayez."],"gfdqcY": ["Impossible d'appliquer la modification : ", ["0"]],"gfohmY": ["Connecter les outils"],@@ -3622,6 +3685,9 @@"hLKfZe": ["Utiliser plutôt un jeton"],"hLod4_": ["Convertir en modèle"],"hLy8b1": ["Mis à jour vers la version ", ["version"]],+ "hPQBsa": [+ "Les fichiers réservés sont nommés index.md et log.md en minuscules. Sur un système de fichiers sensible à la casse, Index.md est lu comme un document ordinaire et perd sa signification."+ ],"hQXiDc": ["Rechercher des branches…"],"hQjvzi": ["Une archive .zip ou .skill."],"hS0wC4": ["OpenKnowledge a restauré une version antérieure de ", ["subject"]],@@ -3777,6 +3843,9 @@"iz1LdD": ["Modifié en dehors d'OK depuis sa dernière écriture ici — l'état affiché est celui qui se trouve sur le disque maintenant"],+ "j-o6Z2": [+ "La maintenance de l'index est restée désactivée car les paramètres du projet n'ont pas pu être enregistrés. Vérifiez les autorisations du fichier de projet, puis réessayez."+ ],"j15ZSH": ["Envoyer les commentaires à"],"j2229h": ["Suppression des fichiers OpenKnowledge…"],"j2kt1j": [@@ -3864,6 +3933,7 @@"k4CuuV": ["Des dossiers et des modèles prêts à l'emploi pour démarrer rapidement. Sélectionnez un pack pour prévisualiser ce qui sera créé, puis ajoutez-le à votre projet."],+ "k5rKNs": ["frontmatter"],"k7Hoig": ["Aucune modification de contenu dans cette version."],"k8xtrB": ["Pas nécessaire pour un point de terminaison local comme <0>",@@ -3905,7 +3975,9 @@"kV2YZv": ["Vous ne voyez pas <0>Compétences</0> ? Activez d'abord <1>Paramètres <2/> Fonctionnalités <3/> Exécution de code et création de fichiers</1>."],+ "kVS5tE": ["Conserver les index generated dans chaque dossier ?"],"kVgQUA": ["Supprimer ce chat ?"],+ "kVzuTI": ["Compétence d'agent recommandée"],"kYL1lH": ["Activité de l'agent"],"k_Dqw1": [[@@ -4010,7 +4082,9 @@],"lXKZGw": ["Titre 1"],"lY27jj": ["il y a ", ["0"], " ans"],+ "lY7Unt": ["Activation de la génération d'index"],"lZAiSP": ["La réponse des rétroliens ne correspond pas à la forme attendue."],+ "lZoQdy": ["Compétence ouverte"],"lZvQrY": ["Utiliser ", ["0"], " comme thème sombre"],"l_6JHD": ["Rechercher des icônes..."],"l_FAT6": ["Utilisez uniquement des lettres, des chiffres, <0>-</0> ou <1>_</1>."],@@ -4030,6 +4104,13 @@"ljHjfg": ["Cette branche est déjà ouverte dans un autre worktree."],"lkYioO": ["Afficher ou masquer le panneau du document"],"ll2yNl": ["Répertoire de contenu"],+ "llXHHh": [+ [+ "pluginCount",+ "plural",+ { "one": ["extension"], "many": ["extensions"], "other": ["extensions"] }+ ]+ ],"lmBPt0": ["Seuls les liens externes déclenchent une requête. Les liens vers d'autres documents de ce projet s'affichent depuis l'index local et ne quittent jamais votre ordinateur."],@@ -4116,6 +4197,9 @@}]],+ "mhnCt3": [+ "Chaque document conceptuel porte un type non vide. Il s'agit de l'ensemble du niveau de conformité de OKF : un document avec seulement un type est entièrement conforme."+ ],"mk2poV": ["par ex. server.ts"],"mlvM8g": ["Impossible de replacer ce commentaire."],"mmpzAq": ["Renvoie les lignes longues à la ligne dans l'éditeur de source markdown."],@@ -4416,6 +4500,9 @@"qRZh7J": ["Laisser la touche Tab quitter l'éditeur de source au lieu d'ajouter un retrait."],"qSKu2v": ["Navigation et sélection dans la source"],"qSxaOz": ["Accepter leur suppression"],+ "qTT48-": [+ "Liens wiki comme [[Page]] — un moyen pris en charge de créer un lien ici, mais un lecteur externe ne résout rien et affiche les parenthèses."+ ],"qTcVwj": ["Parcourez ou envoyez une compétence pour ce projet."],"qTcZZu": ["Échec du chargement des étiquettes. Appuyez sur <0>Échap</0> puis rouvrez pour réessayer."@@ -4479,6 +4566,7 @@"r51jLC": ["Fichier enregistré et application Claude Desktop ouverte"],"r6ncaO": ["Fermer l'onglet"],"r6y-jM": ["Avertissement"],+ "r7IaYp": ["Open Knowledge Format conseils"],"r871ed": ["Votre base de connaissances est désormais sur GitHub, à l'adresse <0>",["ownerLogin"],@@ -4510,6 +4598,9 @@"rZVMkf": ["Champ de remplacement de l'éditeur visuel actif"],"radOpL": ["Image ", ["identity"], ". Accéder à la référence."],"rageVb": ["HTML personnalisé avec un volet d'aperçu en direct (iframe en bac à sable)."],+ "rarziH": [+ "Aide les agents de codage à choisir les types de documents OKF, à préserver la provenance et à éviter d'inventer des métadonnées non prises en charge."+ ],"rbrHTd": ["Approuvé — ", ["optionName"]],"rcJmK8": ["Convertir les emplacements en copies"],"rdU729": ["Mise en page"],@@ -4564,6 +4655,7 @@"sER-bs": ["Fichiers"],"sFhaTJ": ["Distingue les modèles aux noms similaires dans le menu."],"sGZLfB": ["Échec de la récupération des dépôts"],+ "sHDllh": ["Arrêter de maintenir index.md"],"sICrVf": ["Restauré à la version du ", ["0"]],"sIGbBZ": ["Convertir la sélection en note de bas de page"],"sIxSSP": ["Résoudre le conflit dans votre terminal"],@@ -4577,6 +4669,7 @@"sOxZaS": ["Échec du chargement du graphe"],"sQoLn0": ["Quitter"],"sR0I-f": ["Réduire tous les fichiers"],+ "sSRndh": ["Commencez à maintenir index.md"],"sW5OjU": ["obligatoire"],"sZ2IOu": ["Ce ",@@ -4591,6 +4684,9 @@"saIASg": ["Deuxième élément"],"saYiIO": ["Le chemin ne peut pas contenir d'octets nuls"],"scu3wk": ["Modèle"],+ "scyoP9": [+ "Les documents d'index ne portent pas de frontmatter, à l'exception de celui à la racine de votre base de connaissances. Les documents de journal ne sont pas couverts — OKF ne limite pas leur frontmatter."+ ],"se-tU0": ["Impossible de corriger ", ["0"], " fichiers sur ", ["total"], "."],"seeS6l": ["Configurer OpenKnowledge dans ce dossier ?"],"sgmRY8": ["Téléchargement de ", ["0"], " ignoré."],@@ -4653,6 +4749,9 @@"tHKQ6j": ["Renommage"],"tKlWWY": ["Émoji"],"tLX6LY": ["OpenKnowledge a écrit un document"],+ "tM5uzl": [+ "Les familles de provenance, de confiance et de cycle de vie : sources, generated, verified, status et stale_after. Chaque champ est facultatif et l'absence n'est jamais une erreur."+ ],"tN5WTS": ["Le fournisseur a rejeté la requête. Vérifiez la clé API et l'id du modèle."],"tP5DDk": ["Appliquer le lien"],"tUvUfp": ["Utilisez un dossier que vous avez déjà."],@@ -4721,6 +4820,9 @@"uGaIIS": ["Extraire le worktree"],"uH_S-u": [["loadErrorTitle"], " : ", ["message"]],"uJfwF8": ["Déjà installé — rien de nouveau à importer."],+ "uK2peg": [+ "Vérifie votre projet par rapport au Open Knowledge Format. Désactivez-le à tout moment dans Paramètres."+ ],"uKRYiW": ["État de synchronisation indisponible — erreur serveur."],"uL_Wx8": ["Le terminal s'est arrêté de façon inattendue."],"uM6jnS": ["Échec de la restauration"],@@ -4782,6 +4884,9 @@"uyOQ4e": ["Thème copié au format YAML base16"],"uynXup": [["tokens", "plural", { "one": ["token"], "many": ["tokens"], "other": ["tokens"] }]],"v-h2hx": ["Supprimer ", ["targetGitPath"]],+ "v15iQB": [+ "Le contrat de calcul attesté. S'applique uniquement aux documents tapés Attested Computation, où OKF nécessite un runtime ; les concepts ordinaires ne sont pas affectés."+ ],"v2ZW0K": ["Activer le terminal"],"v2a04T": ["Règles markdownlint"],"v41fCm": ["Fichier introuvable"],diff --git a/packages/app/src/locales/fr/messages.po b/packages/app/src/locales/fr/messages.poindex 70ffb24ec..557266e9d 100644--- a/packages/app/src/locales/fr/messages.po+++ b/packages/app/src/locales/fr/messages.po@@ -263,6 +263,11 @@ msgstr "{0, plural, one {Correspond actuellement à {1} document sur {2}.} manymsgid "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"msgstr "{0, plural, one {Aucun problème dans # document.} many {Aucun problème dans # documents.} other {Aucun problème dans # documents.}}"+#. placeholder {0}: pluginRows.length+#: src/components/CreatedItemsList.tsx+msgid "{0, plural, one {Plugin} other {Plugins}}"+msgstr "{0, plural, one {Extension} many {Extensions} other {Extensions}}"+#. placeholder {0}: editorList.hiddenCount#: src/components/McpConsentDialogBody.tsxmsgid "{0, plural, one {Show # more tool} other {Show # more tools}}"@@ -629,7 +634,9 @@ msgstr "CLI {displayName}, {hint}"msgid "{docName} is {0}. OpenKnowledge currently opens files up to {1}."msgstr "{docName} fait {0}. OpenKnowledge ouvre actuellement les fichiers jusqu'à {1}."+#. placeholder {0}: OKF_RULE_IDS.length#. placeholder {0}: entries.length+#: src/components/settings/LintingSection.tsx#: src/components/settings/markdownlint-rule-browser.tsxmsgid "{enabledCount}/{0} on"msgstr "{enabledCount}/{0} activés"@@ -792,6 +799,10 @@ msgstr "{percent}% utilisé ({left}% restant)"msgid "{phase} — {pct}%"msgstr "{phase} — {pct}%"+#: src/components/CreatedItemsList.tsx+msgid "{pluginCount, plural, one {plugin} other {plugins}}"+msgstr "{pluginCount, plural, one {extension} many {extensions} other {extensions}}"+#: src/components/PropertyDisclosure.tsxmsgid "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"msgstr "{problemCount, plural, one {# propriété ne correspond pas au schéma} many {# propriétés ne correspondent pas au schéma} other {# propriétés ne correspondent pas au schéma}}"@@ -1547,6 +1558,10 @@ msgstr "Déjà couvert par un dossier parent sélectionné"msgid "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."msgstr "Vous avez déjà un dépôt git ? Ajoutez-le avec <0>git remote add origin <url></0> dans le dossier de ce projet. Cette page se met à jour automatiquement dès qu'un dépôt distant est détecté."+#: src/components/settings/LintingSection.tsx+msgid "Already in project"+msgstr "Déjà en projet"+#: src/components/SkillPluginBundleDialog.tsxmsgid "Already installed — nothing new to import."msgstr "Déjà installé — rien de nouveau à importer."@@ -1592,6 +1607,10 @@ msgstr "Une autre opération de synchronisation est en cours. Réessayez dans unmsgid "any"msgstr "quelconque"+#: src/components/settings/LintingSection.tsx+msgid "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+msgstr "Tout fichier .mdx. Le format est uniquement .md, donc un lecteur recherchant .md ne l'ouvre jamais - et si un .md du même nom existe, il le lit à la place."+#. placeholder {0}: summary.name#: src/components/settings/LintingSection.tsxmsgid "any doc named {0}"@@ -2152,6 +2171,7 @@ msgstr "Impossible de partager ce chemin."#: src/components/ReportBugDialogBody.tsx#: src/components/SeedDialog.tsx#: src/components/settings/LinkPreviewsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/SavedThemesTiles.tsx#: src/components/settings/SearchSection.tsx#: src/components/ShareBranchSwitchDialog.tsx@@ -2292,6 +2312,10 @@ msgstr "Extraction des fichiers"msgid "Checking sign-in status"msgstr "Vérification de l'état de connexion"+#: src/components/settings/LintingSection.tsx+msgid "Checking skill"+msgstr "Vérification des compétences"+#: src/components/ImportSkillForm.tsxmsgid "Checking source"msgstr "Vérification de la source"@@ -2308,6 +2332,10 @@ msgstr "Vérification…"msgid "Checklist with checkboxes."msgstr "Liste avec cases à cocher."+#: src/components/CreatedItemsList.tsx+msgid "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+msgstr "Vérifie votre projet par rapport au Open Knowledge Format. Désactivez-le à tout moment dans Paramètres."+#: src/components/ImportSkillForm.tsxmsgid "Choose a skill archive"msgstr "Choisir une archive de compétence"@@ -4304,6 +4332,10 @@ msgstr "Désactiver {0}"msgid "Disable {file}"msgstr "Désactiver {file}"+#: src/components/settings/LintingSection.tsx+msgid "Disable {id}"+msgstr "Désactiver {id}"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "Disable external link previews"msgstr "Désactiver les aperçus de liens externes"@@ -4406,6 +4438,10 @@ msgstr "Panneaux du document"msgid "Document statistics"msgstr "Statistiques du document"+#: src/components/settings/LintingSection.tsx+msgid "Document structure"+msgstr "Structure du document"+#: src/components/empty-state/use-create-suggestions.tsmsgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."msgstr "Documente l'architecture de ce dépôt : crée une page de synthèse qui renvoie vers une page par module principal décrivant ses responsabilités et ses points d'entrée."@@ -4797,6 +4833,10 @@ msgstr "Activer la CLI {displayName}"msgid "Enable {file}"msgstr "Activer {file}"+#: src/components/settings/LintingSection.tsx+msgid "Enable {id}"+msgstr "Activer {id}"+#: src/components/AutoSyncOnboardingDialog.tsx#: src/components/EnableSyncConfirmDialog.tsx#: src/components/share-receive-miss-content.tsx@@ -4821,6 +4861,10 @@ msgstr "Activer Suivre ?"msgid "Enable git auto-sync?"msgstr "Activer la synchronisation git automatique ?"+#: src/components/settings/LintingSection.tsx+msgid "Enable indexes"+msgstr "Activer les index"+#: src/components/ProblemsPanel.tsxmsgid "Enable plugins"msgstr "Activer les plugins"@@ -4849,6 +4893,10 @@ msgstr "Activer le terminal pour ce projet"msgid "Enable Themes"msgstr "Activer les thèmes"+#: src/components/settings/LintingSection.tsx+msgid "Enabling index generation"+msgstr "Activation de la génération d'index"+#: src/components/ActivityModeContent.tsxmsgid "Ended"msgstr "Terminé"@@ -4919,6 +4967,10 @@ msgstr "Erreur :"msgid "Escape"msgstr "Échap"+#: src/components/settings/LintingSection.tsx+msgid "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+msgstr "Chaque document conceptuel porte un type non vide. Il s'agit de l'ensemble du niveau de conformité de OKF : un document avec seulement un type est entièrement conforme."+#: src/components/settings/LintingSection.tsxmsgid "every doc"msgstr "tous les documents"@@ -5694,6 +5746,10 @@ msgstr "À partir d'un modèle"msgid "From the {0} plugin"msgstr "Du plugin {0}"+#: src/components/settings/LintingSection.tsx+msgid "Frontmatter"+msgstr "frontmatter"+#: src/components/TemplateForm.tsxmsgid "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."msgstr "Le frontmatter par lequel commence chaque document créé à partir de ce modèle. Les valeurs sont en YAML — une liste s'écrit <0>[a, b]</0> ; <1>{{date}}</1> est renseigné à la création."@@ -5736,6 +5792,10 @@ msgstr "Partie terminée · appuyez sur espace pour rejouer"msgid "General"msgstr "Général"+#: src/components/settings/LintingSection.tsx+msgid "Generated files"+msgstr "Fichiers générés"+#: src/components/TerminalCliMissingBanner.tsxmsgid "Get {displayName}"msgstr "Obtenir {displayName}"@@ -5769,6 +5829,10 @@ msgstr "la configuration git est indisponible"msgid "Git identity isn't set — commits use a default author. Set yours so teammates see your name."msgstr "L'identité git n'est pas définie — les commits utilisent un auteur par défaut. Définissez la vôtre pour que vos coéquipiers voient votre nom."+#: src/components/settings/LintingSection.tsx+msgid "Git merge rule"+msgstr "Règle de fusion Git"+#: src/components/ShareBranchSwitchDialog.tsxmsgid "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."msgstr "Git a besoin de {tool} pour ce dépôt, mais l'outil n'est pas installé ou est introuvable. Installez-le, puis réessayez."@@ -5923,7 +5987,7 @@ msgstr "heading-slug"msgid "Headings"msgstr "Titres"-#: src/components/AutoSyncEnableWarning.tsx+#: src/components/DisclosureWarning.tsx#: src/editor/slash-command/component-items.tsxmsgid "Heads up"msgstr "À noter"@@ -5945,6 +6009,10 @@ msgstr "Bonjour, tout le monde !"msgid "Help"msgstr "Aide"+#: src/components/settings/LintingSection.tsx+msgid "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+msgstr "Aide les agents de codage à choisir les types de documents OKF, à préserver la provenance et à éviter d'inventer des métadonnées non prises en charge."+#. Subtext for the open-knowledge-discovery skill row#. Subtext for the open-knowledge-discovery skill row#: src/components/McpConsentDialogBody.tsx@@ -6277,10 +6345,18 @@ msgstr "Importé sous « {0} » — le nom « {1} » était déjà pris."msgid "Importing"msgstr "Importation"+#: src/components/settings/LintingSection.tsx+msgid "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+msgstr "Dans un document de journal : les en-têtes d'entrée commencent par une date ISO YYYY-MM-DD, la plus récente en premier. Le nombre de title que vous utilisez et le fait que les entrées soient des puces dépendent de vous."+#: src/components/SeedDialog.tsxmsgid "In a subfolder"msgstr "Dans un sous-dossier"+#: src/components/settings/LintingSection.tsx+msgid "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+msgstr "Dans un document d'index : les entrées se trouvent sous un en-tête de section et chacune comporte un lien. La prose autour des listes est très bien."+#: src/components/empty-state/CreatePromptComposer.tsx#: src/components/handoff/AgentSplitButton.tsx#: src/components/handoff/OpenInAgentContextSubmenu.tsx@@ -6299,6 +6375,14 @@ msgstr "Dans l'application"msgid "In app (beta)"msgstr "Dans l'application (bêta)"+#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+msgstr "Dans les projets Git, Open Knowledge ajoute une règle ciblée au fichier .gitattributes à la racine du dépôt afin de combiner les modifications simultanées des index."++#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+msgstr "Dans les projets Git, Open Knowledge ajoute également une règle .gitattributes étendue afin que les modifications d'index simultanées se combinent avant la prochaine reconstruction."+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "In the Claude Desktop App"msgstr "Dans l'application Claude Desktop"@@ -6323,6 +6407,26 @@ msgstr "Augmente ou réduit le retrait de l'élément de liste courant."msgid "Indented blockquote for citations."msgstr "Citation en retrait pour les références."+#: src/components/settings/LintingSection.tsx+msgid "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+msgstr "Les documents d'index ne portent pas de frontmatter, à l'exception de celui à la racine de votre base de connaissances. Les documents de journal ne sont pas couverts — OKF ne limite pas leur frontmatter."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+msgstr "La maintenance de l'index est suspendue car un autre attribut Git contrôle index.md. Mettez à jour .gitattributes pour que les chemins index.md définis utilisent merge=union, puis réessayez."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+msgstr "La maintenance de l'index est suspendue car Open Knowledge n'a pas pu confirmer la règle de fusion Git requise. Vérifiez Git et .gitattributes, puis réessayez."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+msgstr "La maintenance de l'index est restée désactivée car Open Knowledge n'a pas pu atteindre le serveur du projet. Réessayez lorsque le projet se reconnectera."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+msgstr "La maintenance de l'index est restée désactivée car les paramètres du projet n'ont pas pu être enregistrés. Vérifiez les autorisations du fichier de projet, puis réessayez."+#: src/components/settings/SearchSection.tsxmsgid "Indexed {embedded} of {total} pages."msgstr "{embedded} pages indexées sur {total}."@@ -6511,6 +6615,10 @@ msgstr "Installer sur tous les agents"msgid "Install selected"msgstr "Installer la sélection"+#: src/components/settings/LintingSection.tsx+msgid "Install skill"+msgstr "Installer la compétence"+#: src/components/SkillPluginBundleBanner.tsxmsgid "Install skills"msgstr "Installer des compétences"@@ -6520,6 +6628,7 @@ msgid "Install the gh CLI"msgstr "Installer la CLI gh"#: src/components/settings/AiToolsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ProjectAiToolsSection.tsx#: src/components/SkillEditorActions.tsxmsgid "Installed"@@ -6733,6 +6842,10 @@ msgstr "Gardez ce projet synchronisé avec votre dépôt git distant. Suivre rémsgid "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."msgstr "Gardez la trace des personnes et des entreprises avec lesquelles vous travaillez et des réunions que vous avez avec elles. Utile pour se rappeler qui est quelqu'un, comment vous le connaissez, et de quoi vous avez parlé la dernière fois."+#: src/components/settings/LintingSection.tsx+msgid "Keeps your knowledge base aligned with the Open Knowledge Format."+msgstr "Maintient votre base de connaissances alignée sur l’Open Knowledge Format."+#. placeholder {0}: toName.trim()#: src/components/SkillForkDialog.tsxmsgid "Kept both — \"{0}\" is its own skill now"@@ -7108,6 +7221,14 @@ msgstr "Recherche de <0>{lookingForUrl}</0>."msgid "Lost connection to \"{docName}\"."msgstr "Connexion perdue avec « {docName} »."+#: src/components/settings/LintingSection.tsx+msgid "Maintain generated indexes in every folder?"+msgstr "Conserver les index generated dans chaque dossier ?"++#: src/components/settings/LintingSection.tsx+msgid "Maintain index.md"+msgstr "Maintenir index.md"+#: src/components/SkillInstallMenu.tsxmsgid "make source"msgstr "définir comme source"@@ -8252,6 +8373,10 @@ msgstr "OK Desktop"msgid "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."msgstr "OK avait réglé ce dossier sur {0} — quelque chose en dehors d'OK l'a modifié depuis. L'état affiché est celui du disque maintenant ; votre prochain Lien symbolique/Dissocier l'emportera."+#: src/components/settings/LintingSection.tsx+msgid "OKF agent skill installed"+msgstr "Compétence d'agent OKF installée"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "On — hovering an external link sends its URL to the destination site to fetch a preview."msgstr "Activé — survoler un lien externe envoie son URL au site de destination pour récupérer un aperçu."@@ -8268,6 +8393,10 @@ msgstr "Sur <0>{address}</0>"msgid "On selected text in <0>{address}</0>"msgstr "Sur le texte sélectionné dans <0>{address}</0>"+#: src/components/settings/LintingSection.tsx+msgid "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+msgstr "Sur l'index racine, okf_version est écrit sous forme de chaîne entre guillemets comme \"0.2\". Non cité, YAML le lit comme un nombre et 0.10 devient silencieusement 0.1."+#. Next step for a Cursor project MCP row — Cursor leaves project servers disabled#: src/components/settings/ProjectAiToolsSection.tsxmsgid "One more step: enable it in Cursor → Settings → Tools & MCP (Cursor leaves project servers off until you turn them on)."@@ -8490,6 +8619,22 @@ msgstr "Ouvrir dans un worktree"msgid "Open it there"msgstr "L'ouvrir là-bas"+#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+msgstr "Open Knowledge crée et gère un fichier de navigation nommé index.md dans chaque dossier contenant Markdown."++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge Format guidance"+msgstr "Open Knowledge Format conseils"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+msgstr "Open Knowledge conserve un fichier de navigation nommé index.md dans chaque dossier contenant Markdown, chacun répertoriant les documents de ce dossier par type et établissant un lien vers ses sous-dossiers. Il réécrit ces fichiers à mesure que vos documents changent, et tout ce que vous y modifiez vous-même est remplacé."++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+msgstr "Open Knowledge réécrit ces fichiers index.md à mesure que les documents changent, de sorte que les modifications manuelles apportées à ceux-ci sont remplacées."+#. placeholder {0}: item.displayName#. placeholder {1}: item.displayName#. placeholder {2}: item.version@@ -8536,6 +8681,10 @@ msgstr "Ouvrir les paramètres"msgid "Open shared {targetNoun}"msgstr "Ouvrir {targetNoun} partagé"+#: src/components/settings/LintingSection.tsx+msgid "Open skill"+msgstr "Compétence ouverte"+#: src/editor/extensions/JsxComponentView.tsxmsgid "Open source doc: {mirrorSrc}"msgstr "Ouvrir le document source : {mirrorSrc}"@@ -9372,6 +9521,7 @@ msgid "project"msgstr "projet"#: src/components/CommandPalette.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ScopeBadge.tsx#: src/lib/skill-scope.tsmsgid "Project"@@ -9643,6 +9793,10 @@ msgstr "Projet récent"msgid "Recently opened"msgstr "Ouverts récemment"+#: src/components/settings/LintingSection.tsx+msgid "Recommended agent skill"+msgstr "Compétence d'agent recommandée"+#: src/components/SyncStatusBadge.tsxmsgid "Reconnect required"msgstr "Reconnexion nécessaire"@@ -10080,6 +10234,10 @@ msgstr "Étudier l'extinction des oiseaux incapables de voler"msgid "research-note"msgstr "research-note"+#: src/components/settings/LintingSection.tsx+msgid "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+msgstr "Les fichiers réservés sont nommés index.md et log.md en minuscules. Sur un système de fichiers sensible à la casse, Index.md est lu comme un document ordinaire et perd sa signification."+#: src/components/settings/CustomThemeEditor.tsxmsgid "Reset"msgstr "Réinitialiser"@@ -10322,6 +10480,7 @@ msgid "Rule editing is available for the project's root markdownlint config"msgstr "La modification des règles n'est possible que pour la configuration markdownlint à la racine du projet"#: src/components/LintConfigEditor.tsx+#: src/components/settings/LintingSection.tsxmsgid "Rules"msgstr "Règles"@@ -11264,6 +11423,10 @@ msgstr "La compétence « {conflictName} » n’a pas été installée pour {conmsgid "Skill \"{name}\" created"msgstr "Compétence « {name} » créée"+#: src/components/settings/LintingSection.tsx+msgid "Skill already in project"+msgstr "Compétence déjà en projet"+#: src/components/ExploreSkills.tsxmsgid "Skill discovery powered by <0>skills.sh</0>"msgstr "Découverte de compétences propulsée par <0>skills.sh</0>"@@ -11523,6 +11686,10 @@ msgstr "Partir de"msgid "Start here: what this is and how it's organized."msgstr "Commencez ici : ce que c'est et comment c'est organisé."+#: src/components/settings/LintingSection.tsx+msgid "Start maintaining index.md"+msgstr "Commencez à maintenir index.md"+#: src/lib/keyboard-shortcuts.tsmsgid "Start source completion"msgstr "Démarrer la complétion dans la source"@@ -11618,6 +11785,10 @@ msgstr "Arrêter de corriger les fichiers"msgid "Stop fixing. Files already fixed stay fixed."msgstr "Arrêter la correction. Les fichiers déjà corrigés le restent."+#: src/components/settings/LintingSection.tsx+msgid "Stop maintaining index.md"+msgstr "Arrêter de maintenir index.md"+#: src/lib/project-fix-sweep-store.tsmsgid "Stopped fixing. Files already fixed stay fixed."msgstr "Correction arrêtée. Les fichiers déjà corrigés le restent."@@ -12121,6 +12292,10 @@ msgstr "L'agent ne s'arrête pas. L'arrêt forcé ferme ce chat et quitte l'agenmsgid "The agent's persona, values, and voice."msgstr "La personnalité, les valeurs et le ton de l'agent."+#: src/components/settings/LintingSection.tsx+msgid "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+msgstr "Le contrat de calcul attesté. S'applique uniquement aux documents tapés Attested Computation, où OKF nécessite un runtime ; les concepts ordinaires ne sont pas affectés."+#: src/components/ProblemsPanel.tsxmsgid "The audit could not be completed. Try again."msgstr "L'audit n'a pas pu être terminé. Réessayez."@@ -12179,6 +12354,10 @@ msgstr "La formule <0>c = √(a² + b²)</0> se rend en ligne."msgid "the git exclude file isn't writable"msgstr "le fichier d'exclusion git n'est pas accessible en écriture"+#: src/components/settings/LintingSection.tsx+msgid "The index files stay in place. Open Knowledge removes only the Git rule it added."+msgstr "Les fichiers d'index restent en place. Open Knowledge supprime uniquement la règle Git qu'il a ajoutée."+#: src/lib/locale-load-failure-notice.tsmsgid "The interface is still in the language you were reading. Check your connection, then reload to try again."msgstr "L'interface est restée dans la langue que vous lisiez. Vérifiez votre connexion, puis rechargez pour réessayer."@@ -12215,6 +12394,10 @@ msgstr "Le bloc de propriétés en haut de ce document contient une erreur de mimsgid "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."msgstr "Les propriétés ont changé, mais la comparaison a échoué : le YAML n'a pas pu être analysé. Les deux versions sont affichées telles quelles."+#: src/components/settings/LintingSection.tsx+msgid "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+msgstr "Les familles de provenance, de confiance et de cycle de vie : sources, generated, verified, status et stale_after. Chaque champ est facultatif et l'absence n'est jamais une erreur."+#: src/components/settings/SearchSection.tsxmsgid "The provider is rate-limiting this key. Try again in a moment."msgstr "Le fournisseur limite le débit de cette clé. Réessayez dans un instant."@@ -12252,6 +12435,10 @@ msgstr "Le fichier de schéma n'existe pas ou n'a pas pu être chargé — ajoutmsgid "the server responded but server.lock has no port yet"msgstr "le serveur a répondu mais server.lock n'a pas encore de port"+#: src/components/settings/LintingSection.tsx+msgid "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+msgstr "Les formes de title, description, resource et tags lorsque vous les utilisez. Aucun n'est requis ; en déclarer un épingle uniquement son type, donc tags écrit sous forme de chaîne séparée par des virgules est signalé."+#: src/components/SkillInstallMenu.tsxmsgid "The skill's own folder — the source other locations copy or link from"msgstr "Le dossier propre à la compétence — la source depuis laquelle les autres emplacements copient ou pointent"@@ -12565,6 +12752,10 @@ msgstr "Cela peut prendre un moment. Votre contenu markdown est conservé."msgid "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."msgstr "Cela déplace <0>{name}</0> de {0} vers {1}, en relocalisant ses fichiers sur le disque et en la réinstallant dans vos éditeurs au niveau {2}."+#: src/components/settings/LintingSection.tsx+msgid "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+msgstr "Celui-ci doit voir vos fichiers, pas seulement le document ouvert, afin qu'il apparaisse lorsque vous exécutez un audit de projet plutôt que pendant que vous tapez."+#: src/components/SeedDialog.tsxmsgid "This pack is already set up here."msgstr "Ce pack est déjà configuré ici."@@ -12928,6 +13119,10 @@ msgstr "Retransformez {0} en un vrai répertoire contenant un lien symbolique pamsgid "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."msgstr "Retransformez {display} en un vrai répertoire contenant un lien symbolique par compétence pour chacune de celles qu'il voit actuellement — rien ne cesse de fonctionner, et le menu de chaque compétence la gère à partir de là."+#: src/components/CreatedItemsList.tsx+msgid "Turn it off any time in Settings."+msgstr "Désactivez-le à tout moment dans Paramètres."+#: src/components/NotInSidebarIndicator.tsxmsgid "Turn off Only markdown files"msgstr "Désactiver Fichiers markdown uniquement"@@ -12953,6 +13148,10 @@ msgstr "Activer la recherche sémantique ?"msgid "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."msgstr "Transformez ce que vous lisez en articles clairs et fiables. Enregistrez une source, dégagez-en le sens, puis conservez la version finale pour pouvoir vous y fier plus tard."+#: src/components/settings/LintingSection.tsx+msgid "Turning it off"+msgstr "L'éteindre"+#: src/components/acp/working-status.tsmsgid "Turning it over…"msgstr "Rumination…"@@ -13643,6 +13842,10 @@ msgstr "Lien wiki"msgid "Wiki link suggestions"msgstr "Suggestions de liens wiki"+#: src/components/settings/LintingSection.tsx+msgid "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+msgstr "Liens wiki comme [[Page]] — un moyen pris en charge de créer un lien ici, mais un lecteur externe ne résout rien et affiche les parenthèses."+#: src/components/PublishToGitHubDialog.tsxmsgid "Will be created as <0>{sanitizedName}</0>"msgstr "Sera créé sous le nom <0>{sanitizedName}</0>"diff --git a/packages/app/src/locales/hi/messages.json b/packages/app/src/locales/hi/messages.jsonindex 67b5683a6..ee44a7996 100644--- a/packages/app/src/locales/hi/messages.json+++ b/packages/app/src/locales/hi/messages.json@@ -119,6 +119,9 @@"0ySP5u": ["बदलाव इस थीम में अपने आप सहेजे जाते हैं।"],"0zAhu6": ["हर दस्तावेज़"],"10g8I_": ["केवल markdown फ़ाइलें बंद करें"],+ "110eEb": [+ "Open Knowledge प्रत्येक फ़ोल्डर में index.md नामक एक नेविगेशन फ़ाइल बनाता है और उसका रखरखाव करता है जिसमें Markdown होता है।"+ ],"11ukmX": ["नाम बदलना विफल: ", ["0"]],"12F9WL": ["(कोई id नहीं)"],"151wvk": ["साइडबार दिखाएँ"],@@ -136,6 +139,9 @@"1GhYxC": [["totalPages"], " में से"],"1HBhDS": ["फ़ाइलें चेक आउट की जा रही हैं"],"1J0c0X": [["displayName"], " तक अब भी नहीं पहुँचा जा सका। एक बार और कोशिश करें?"],+ "1JpLgH": [+ "एक सूचकांक दस्तावेज़ में: प्रविष्टियाँ एक अनुभाग शीर्षक के अंतर्गत होती हैं और प्रत्येक में एक लिंक होता है। सूचियों के आसपास गद्य ठीक है."+ ],"1LtA5r": ["स्किल को ", ["path"], " पर सिमलिंक करता है"],"1MGRQl": ["टर्मिनल सत्र"],"1NgrlY": ["इंस्टॉल करने के अन्य तरीके"],@@ -149,6 +155,7 @@"1XSMhZ": ["<0>केवल-स्थानीय</0> पर जाना तब तक मना रहेगा जब तक उन्हें<1> git rm --cached</1> से अनट्रैक न किया जाए।"],+ "1ZXkqM": ["किसी भी समय सेटिंग में जाकर इसे बंद कर दें."],"1ZpfyB": ["AI ", ["displayName"], " से खोलें, ", ["hint"]],"1a6ICf": ["एजेंट के संपादन का अनुसरण किया जा रहा है"],"1bDVu5": ["कार्यक्षेत्र कमांड पैलेट"],@@ -285,6 +292,8 @@"3o3tur": ["शुरुआती सामग्री"],"3oh0nQ": [["path"], " में नेस्टेड .okignore त्रुटि"],"3pU8e-": ["टैब पिन करें"],+ "3qDsdf": ["कौशल स्थापित करें"],+ "3ri_4O": ["आपके ज्ञानकोष को Open Knowledge Format के अनुरूप रखता है।"],"3s-k7L": [["0", "plural", { "one": ["#", " और टूल दिखाएँ"], "other": ["#", " और टूल दिखाएँ"] }]],"3uSzeS": ["छवियाँ कहीं से भी · गैर-छवि फ़ाइलें कार्यक्षेत्र में होनी चाहिए"],"3v62tp": ["skills.sh पर लोकप्रिय"],@@ -419,6 +428,9 @@],"5tcmwY": ["मान जोड़ें"],"5vAI6Z": ["यह मेरे कार्यप्रवाह में फ़िट नहीं बैठा"],+ "5w38tn": [+ "सूचकांक रखरखाव बंद रहा क्योंकि Open Knowledge प्रोजेक्ट सर्वर तक नहीं पहुंच सका। प्रोजेक्ट पुनः कनेक्ट होने पर पुनः प्रयास करें."+ ],"5wV2qQ": ["और अन्य"],"5y_9lO": ["प्राधिकरण की प्रतीक्षा"],"6-wLTJ": ["origin से ", ["behind"], " पीछे"],@@ -551,6 +563,7 @@"7d1a0d": ["सार्वजनिक"],"7dZnmw": ["प्रासंगिकता"],"7hctf2": ["जो प्रोजेक्ट आप बनाना चाहते हैं उसका वर्णन करें"],+ "7idx48": ["OKF एजेंट कौशल स्थापित"],"7jIIFX": ["आपका सब कुछ तैयार है!"],"7kb4LU": ["स्वीकृत"],"7l15X4": ["विफल"],@@ -558,6 +571,7 @@"7m3Ade": ["इंस्टॉल:"],"7qRHf0": ["Claude Chat और Cowork के लिए इंस्टॉल करें"],"7uBlRT": ["फ़ाइल-ट्री के फ़ोकस किए गए आइटम को कॉपी करें ताकि Paste उसकी नकल बना सके।"],+ "7wogIQ": [["0", "plural", { "one": ["प्लगइन"], "other": ["प्लगइन"] }]],"80c4-P": ["कोड क्लिपबोर्ड पर कॉपी किया गया"],"81H_23": ["प्रॉपर्टी जोड़ें"],"851WA-": ["इसे Settings > AI tools & CLI में कॉन्फ़िगर किया जा सकता है"],@@ -607,6 +621,7 @@"8nWu1k": ["खाली आरेख"],"8oWgty": ["भेजने के लिए सभी टिप्पणियाँ चुनें"],"8qgfac": ["MCP सर्वर"],+ "8rZ1pk": [["id"], " सक्षम करें"],"8ruqQi": ["टूटे हुए आंतरिक लिंक"],"8sMErm": ["Follow सक्षम करें?"],"8t9CRE": [["agentName"], " शुरू किया जा रहा है…"],@@ -780,6 +795,9 @@"BQKHuL": ["टर्मिनल पुनः आरंभ करें"],"BQu9Pg": ["सिमलिंक"],"BUyQnq": ["सर्वर पुनः आरंभ नहीं किया जा सका। इस फ़ोल्डर में `ok start` आज़माएँ।"],+ "BVkqD9": [+ "सूचकांक रखरखाव रोक दिया गया है क्योंकि एक अन्य Git विशेषता index.md को नियंत्रित करती है। .gitattributes को अपडेट करें ताकि दायरे वाले index.md पथ merge=union का उपयोग करें, फिर पुनः प्रयास करें।"+ ],"BY-g4_": ["पैटर्न जोड़ें"],"Ba4D2x": ["टेम्पलेट आयात किया गया"],"Bdha5y": ["प्रकाशित किया जा रहा है…"],@@ -798,6 +816,9 @@"Bv5a9_": ["चयन के आँकड़े"],"Bx4EXG": [["label"], " के लिए क्रियाएँ"],"By-7Pn": ["बुलेट सूची चालू या बंद करें।"],+ "ByIOcK": [+ "अनुक्रमणिका फ़ाइलें यथावत रहती हैं. Open Knowledge केवल अपने द्वारा जोड़े गए Git नियम को हटाता है।"+ ],"BymzO4": ["दस्तावेज़ रूपरेखा"],"C-mmmK": ["वह मॉडल id जो आपका एंडपॉइंट देता है। इसका वेक्टर आकार अपने आप पहचाना जाता है — ",@@ -839,6 +860,9 @@"<0>~/.ok/bin</0> और <1>~/.ok/env.sh</1> दोनों ही स्थिति में बने रहते हैं — ऐप हमेशा इनका रखरखाव करता है।"],"CXTwen": ["इस प्रोजेक्ट कॉन्फ़िग को सुरक्षित रूप से संपादित नहीं किया जा सकता"],+ "CXcveY": [+ "Open Knowledge प्रत्येक फ़ोल्डर में index.md नामक एक नेविगेशन फ़ाइल रखता है जिसमें Markdown होता है, प्रत्येक उस फ़ोल्डर के दस्तावेज़ों को प्रकार के आधार पर सूचीबद्ध करता है और उसके सबफ़ोल्डर्स से लिंक करता है। जैसे ही आपके दस्तावेज़ बदलते हैं, यह इन फ़ाइलों को फिर से लिखता है, और आप उनमें जो कुछ भी संपादित करते हैं वह बदल दिया जाता है।"+ ],"CXj9C-": ["नई प्रॉपर्टी का नाम"],"C_Lyvh": ["थीम सेटिंग सहेजने में विफल"],"C_WGy8": [@@ -862,6 +886,9 @@"Cu6GXQ": ["स्रोत फ़ोल्डर ख़ुद नहीं हिलता।"],"CvsD6Y": [["viaTags"], " के ज़रिए"],"CwOXMT": [["keyName"], " का मान"],+ "CxCOFx": [+ "Git प्रोजेक्ट में, Open Knowledge रिपॉजिटरी के रूट की .gitattributes फ़ाइल में सीमित दायरे वाला नियम जोड़ता है, ताकि एक साथ किए गए इंडेक्स बदलाव जुड़ सकें।"+ ],"CxVk-w": [["address"], " पर टिप्पणी"],"D-NlUC": ["सिस्टम"],"D-Oh1s": [["0"], " कैसे सेट अप करें (ब्राउज़र में खुलता है)"],@@ -920,6 +947,9 @@"DhT_PK": ["OpenKnowledge ने एक स्किल आयात की"],"DiFKSL": ["markdown फ़ाइलें गिनी जा रही हैं"],"DiZ3pq": ["आइकन चयनकर्ता"],+ "DjNcDy": [+ "जब आप title, description, resource, और tags का उपयोग करते हैं तो उनकी आकृतियाँ। किसी की भी आवश्यकता नहीं है; किसी को घोषित करने से केवल उसके प्रकार का पता चलता है, इसलिए अल्पविराम से अलग की गई स्ट्रिंग के रूप में लिखे गए tags को चिह्नित किया जाता है।"+ ],"DmkTrb": ["यह थीम नहीं बनाई जा सकी। फिर से कोशिश करें।"],"Dnn2XG": ["स्वचालित"],"DpjYd6": ["एंकर किए गए पाठ पर जाएँ"],@@ -1123,6 +1153,9 @@"GNkUvW": ["क़तार में — यह प्रक्रिया समाप्त होने पर भेजा जाएगा"],"GQ3O42": ["ट्रैश"],"GQDSBN": ["लेआउट विकल्प"],+ "GROUfG": [+ "कोई भी .mdx फ़ाइल। प्रारूप केवल .md है, इसलिए .md को स्कैन करने वाला पाठक इसे कभी नहीं खोलता है - और यदि समान नाम का .md मौजूद है, तो इसके बजाय उसे पढ़ता है।"+ ],"GSYWCm": ["दस्तावेज़ पैनल छिपाएँ"],"GUYwCr": ["सूचना ख़ारिज करें"],"GUZHkL": ["पैलेट के रंग मौजूद नहीं हैं"],@@ -1275,6 +1308,7 @@"IxHMdF": ["वह टिप्पणी नहीं हटाई जा सकी।"],"IxyZXD": ["स्क्रीनशॉट"],"Izh19j": [["tail"], " से पढ़ रहे हैं"],+ "J0uRhj": ["कौशल की जाँच करना"],"J1XRO3": ["थीम के रंग"],"J2Mv98": ["नाम (जैसे ", ["login"], ")"],"J2_JuX": ["कुछ नहीं (", ["0"], " किसी दस्तावेज़ से मेल नहीं खा सकता)"],@@ -1295,6 +1329,7 @@"JHf6qZ": ["[email protected]"],"JJcBCm": ["कुल ", ["0"]],"JK-Ave": ["थंबनेल छिपाएँ"],+ "JKXcOi": ["पहले से ही प्रोजेक्ट में है"],"JL3si7": ["अपडेट किया जा रहा है"],"JLUTgi": ["अभी कोई टैग नहीं — अनुक्रमणिका भरने के लिए किसी भी दस्तावेज़ में `#tagname` लिखें।"],"JLzQi_": [["accessibleLabel"], " बंद करें"],@@ -1388,6 +1423,9 @@"L-rMC9": ["डिफ़ॉल्ट पर रीसेट करें"],"L1BQTH": [["0"], " अभी इंस्टॉल नहीं है — इसका डाउनलोड पेज खोला जा रहा है।"],"L1ZE3M": ["दस्तावेज़ आँकड़े"],+ "L3BcJ4": [+ "इसे आपकी फ़ाइलों को देखने की ज़रूरत है, न कि केवल खुले दस्तावेज़ को, इसलिए यह तब दिखाई देता है जब आप टाइप करते समय प्रोजेक्ट ऑडिट चलाते हैं।"+ ],"L3CEC1": ["यह आइटम"],"L3w0_C": ["किसी दस्तावेज़ को अलग विंडो में स्लाइड डेक के रूप में प्रस्तुत करें। दस्तावेज़ के frontmatter में <0>slides: true</0> जोड़ें, फिर उसे Slidev क्रिया से खोलें। रेंडरिंग Slidev CLI करता है, जिसे OpenKnowledge शामिल नहीं करता।"@@ -1840,6 +1878,12 @@"R6ABfU": ["सीधे काम करें, कोई योजना चरण नहीं"],"R9IDFz": ["डिस्क पर फ़ोल्डर का नाम और वह id दोनों बदल देता है जिससे एजेंट इसे बुलाते हैं।"],"R9dK63": ["नमूना छवि"],+ "RB_g_C": [+ "रूट इंडेक्स पर, okf_version को \"0.2\" जैसी उद्धृत स्ट्रिंग के रूप में लिखा जाता है। अउद्धृत, YAML इसे एक संख्या के रूप में पढ़ता है और 0.10 चुपचाप 0.1 बन जाता है।"+ ],+ "RD6H9q": [+ "दस्तावेज़ बदलने पर Open Knowledge इन index.md फ़ाइलों को फिर से लिखता है, इसलिए उनमें मैन्युअल संपादन बदल दिए जाते हैं।"+ ],"RDjuBN": ["सेटअप"],"RDrXh4": ["उपयोगकर्ता, प्रोजेक्ट और एकीकरण सेटिंग कॉन्फ़िगर करें।"],"RG3yW6": ["इस थीम का नाम दर्ज करें।"],@@ -1909,6 +1953,9 @@"SF9qpO": ["आगे संपर्क के लिए अपना ईमेल साझा करें"],"SFEWV6": ["OpenKnowledge स्किल लोड नहीं हो सकीं। फिर कोशिश करें।"],"SFN6dN": ["शीर्षक 3"],+ "SIPelo": [+ "सूचकांक रखरखाव रोक दिया गया है क्योंकि Open Knowledge आवश्यक Git मर्ज नियम की पुष्टि नहीं कर सका। Git और .gitattributes को जांचें, फिर पुनः प्रयास करें।"+ ],"SInSnF": ["संदर्भ <0>", ["0"], "</0>"],"SItQRc": ["आपको OpenKnowledge कैसा लगा?"],"SOPwPh": ["इस संपादन पर बहाल करें"],@@ -2208,6 +2255,7 @@"X7u0xR": [["0"], " टेम्पलेट उपलब्ध"],"X8kjQX": ["GitHub के साथ फिर से प्रमाणित करें"],"X9VpsP": ["फ़ोल्डर की सामग्री लोड हो रही है"],+ "XAnapw": ["Git मर्ज नियम"],"XAyxsa": ["रिमोट ब्रांच चेक आउट करें"],"XBBZnv": ["लिंक लक्ष्य \"", ["shown"], "\" किसी मौजूदा दस्तावेज़ पर हल नहीं होता।"],"XBgr2S": ["यहाँ कॉपी करें"],@@ -2329,6 +2377,9 @@"Y_iImT": ["हल न की जा सकने वाली फ़ाइल ", ["identity"], "। संदर्भ पर जाएँ।"],"Y_kL7X": ["संपादक कैसा दिखे और कैसे काम करे यह अपने अनुसार तय करें।"],"Ya3PlJ": ["अनुमति आवश्यक है"],+ "YaVU2F": [+ "Git परियोजनाओं में, Open Knowledge एक स्कोप्ड .gitattributes नियम भी जोड़ता है ताकि समवर्ती सूचकांक परिवर्तन अगले पुनर्निर्माण से पहले संयोजित हो जाएं।"+ ],"YaeyFh": ["खींचने पर आपकी स्थानीय फ़ाइलों के बिना कमिट किए संपादन मिट सकते हैं।"],"Yb82LN": ["ID: ", ["0"]],"Yea-K5": ["इस बिंदु पर बहाल करें"],@@ -2452,6 +2503,7 @@"_Bix3-": [["localizedFirstMessage"], " की घटनाएँ"],"_DwR-n": ["बनाया जा रहा है…"],"_FLBbi": [["sizeText"], " · गोपनीय जानकारी हटाई गई · क्रैश डंप से नहीं हटाई गई"],+ "_G7A92": ["index.md बनाए रखें"],"_GRWOJ": ["एम्बेडिंग प्रदाता बदलें?"],"_HgF9q": ["इसके अनुसार क्रम"],"_IGfXZ": ["पिछली बार OpenKnowledge अप्रत्याशित रूप से बंद हो गया था।"],@@ -2536,10 +2588,12 @@"एजेंट सेवा से नहीं जुड़ा जा सका। सुनिश्चित करें कि OpenKnowledge सर्वर चल रहा है और अद्यतित है (यदि पहले से चल रहा था तो उसे पुनः आरंभ करें), फिर कोशिश करें।"],"aalx4E": ["टूटा हुआ MDX स्रोत संपादित किया जा रहा है: ", ["reason"]],+ "aatPoi": ["जेनरेट की गई फ़ाइलें"],"abiHje": ["चयनित आइटम हटाएँ"],"adsMWO": ["डेल्टा सुलझाए जा रहे हैं"],"ah_ekO": ["\"", ["name"], "\" पहले से ही अद्यतित है"],"aiArms": ["हम यह रिपॉज़िटरी क्लोन नहीं कर सके।"],+ "aiOceC": ["अनुक्रमणिका सक्षम करें"],"ajHi4O": ["स्वत: सिंक रुका हुआ है — आपके पास इस रिपॉज़िटरी में पुश करने की अनुमति नहीं है। अपडेट पाते रहने के लिए Follow पर जाएँ।"],@@ -2667,11 +2721,13 @@],"cb-0G0": ["रंग हटाएँ"],"ccNps_": ["केवल संशोधित"],+ "cd3THN": ["दस्तावेज़ संरचना"],"cd5EXh": ["बग की रिपोर्ट करें"],"cdm00A": ["कोई आने वाला नहीं"],"cdmk8A": ["बिना कमिट किए बदलाव"],"cgl-gn": ["GitHub से जुड़ गया"],"chL5IG": ["समुदाय"],+ "ciozf1": ["कौशल पहले से ही परियोजना में है"],"cjtjry": ["OpenKnowledge के नेविगेशन इतिहास में पीछे जाएँ।"],"cklVjM": ["समयरेखा"],"clJ3qM": ["पूर्ण।"],@@ -2841,6 +2897,7 @@"fbdLmk": ["गाढ़ी फ़ॉर्मैटिंग चालू या बंद करें।"],"fbsiBw": ["टर्मिनल शुरू करते समय कुछ ग़लत हो गया।"],"fcgvCA": ["Claude"],+ "fdKQAE": ["इसे बंद कर रहा हूँ"],"fdeFfN": ["(बाइनरी फ़ाइल, पूर्वावलोकन योग्य नहीं)"],"fevEu0": ["नवीनतम बदलाव खींचें"],"ffH3Rt": ["टिप्पणी जोड़ें (Enter)"],@@ -2910,12 +2967,16 @@"gUx34c": ["वह भाषा जिसमें OpenKnowledge बात करता है; सिस्टम आपके ऑपरेटिंग सिस्टम का अनुसरण करता है। आपके अपने नोट्स उसी भाषा में रहते हैं जिसमें आपने उन्हें लिखा था।"],+ "gVMkEr": [+ "एक लॉग दस्तावेज़ में: प्रविष्टि शीर्षक ISO YYYY-MM-DD दिनांक के साथ आगे बढ़ते हैं, सबसे पहले नवीनतम। आप कितने title का उपयोग करते हैं, और क्या प्रविष्टियाँ बुलेट हैं, यह आप पर निर्भर है।"+ ],"gY7wnY": [["agentName"], " में साइन इन किया जा रहा है…"],"gYz2ep": [["timeLabel"], " में समाप्त होगा"],"gZElfU": [["1"], " में से ", ["0"], " फ़ाइलें ठीक की जा रही हैं"],"gZiT5e": ["इन सिमलिंक को स्वतंत्र प्रतियों से बदलें?"],"gayL_Q": ["रिलीज़ योजना"],"gbHcbI": ["प्रॉपर्टी हटाने में विफल"],+ "gfYI3o": [["id"], " को अक्षम करें"],"gfb-CM": ["ब्रांच नहीं लाई जा सकी — GitHub में साइन इन करें और फिर कोशिश करें।"],"gfdqcY": ["बदलाव लागू नहीं किया जा सका: ", ["0"]],"gfohmY": ["टूल जोड़ें"],@@ -2968,6 +3029,9 @@"hLKfZe": ["इसके बजाय कोई टोकन उपयोग करें"],"hLod4_": ["टेम्पलेट में बदलें"],"hLy8b1": ["संस्करण ", ["version"], " पर अपडेट किया गया"],+ "hPQBsa": [+ "आरक्षित फ़ाइलों को लोअरकेस में index.md और log.md नाम दिया गया है। केस-संवेदी फ़ाइल सिस्टम पर, Index.md को एक सामान्य दस्तावेज़ के रूप में पढ़ा जाता है और इसका अर्थ खो जाता है।"+ ],"hQXiDc": ["ब्रांच खोजें…"],"hQjvzi": ["एक .zip या .skill संग्रह।"],"hS0wC4": ["OpenKnowledge ने ", ["subject"], " का पिछला संस्करण पुनर्स्थापित किया"],@@ -3103,6 +3167,9 @@"iz1LdD": ["OK के पिछली बार यहाँ लिखने के बाद से बाहर बदला गया — दिखाई गई स्थिति वही है जो अभी डिस्क पर है"],+ "j-o6Z2": [+ "इंडेक्स रखरखाव बंद रहा क्योंकि प्रोजेक्ट सेटिंग सहेजी नहीं जा सकी। प्रोजेक्ट फ़ाइल अनुमतियाँ जाँचें, फिर पुनः प्रयास करें।"+ ],"j15ZSH": ["टिप्पणियाँ यहाँ भेजें"],"j2229h": ["OpenKnowledge की फ़ाइलें हटाई जा रही हैं…"],"j2kt1j": [@@ -3188,6 +3255,7 @@"k4CuuV": ["जल्दी शुरू करने के लिए तैयार फ़ोल्डर और टेम्पलेट। क्या बनेगा इसका पूर्वावलोकन देखने के लिए कोई पैक चुनें, फिर उसे अपने प्रोजेक्ट में जोड़ें।"],+ "k5rKNs": ["frontmatter"],"k7Hoig": ["इस संस्करण में सामग्री का कोई बदलाव नहीं।"],"k8xtrB": ["<0>",@@ -3227,7 +3295,9 @@"kV2YZv": ["<0>Skills</0> नहीं दिख रहा? पहले <1>Settings <2/> Capabilities <3/> Code execution and file creation</1> सक्षम करें।"],+ "kVS5tE": ["प्रत्येक फ़ोल्डर में generated अनुक्रमणिका बनाए रखें?"],"kVgQUA": ["यह चैट हटाएं?"],+ "kVzuTI": ["अनुशंसित एजेंट कौशल"],"kYL1lH": ["एजेंट गतिविधि"],"k_Dqw1": [[@@ -3316,7 +3386,9 @@"lWNpNB": ["CodeMirror के ज़रिए कर्सर जोड़ें या मेल खाती घटनाएँ चुनें।"],"lXKZGw": ["शीर्षक 1"],"lY27jj": [["0"], " वर्ष पहले"],+ "lY7Unt": ["सूचकांक निर्माण सक्षम करना"],"lZAiSP": ["बैकलिंक प्रतिक्रिया अपेक्षित आकार से मेल नहीं खाई।"],+ "lZoQdy": ["खुला कौशल"],"lZvQrY": [["0"], " को गहरी थीम के रूप में उपयोग करें"],"l_6JHD": ["आइकन खोजें..."],"l_FAT6": ["केवल अक्षर, अंक, <0>-</0> या <1>_</1> उपयोग करें।"],@@ -3334,6 +3406,7 @@"ljHjfg": ["वह ब्रांच पहले से किसी दूसरे वर्कट्री में खुली है।"],"lkYioO": ["दस्तावेज़ पैनल दिखाएँ या छिपाएँ"],"ll2yNl": ["सामग्री निर्देशिका"],+ "llXHHh": [["pluginCount", "plural", { "one": ["प्लगइन"], "other": ["प्लगइन"] }]],"lmBPt0": ["केवल बाहरी लिंक कोई अनुरोध भेजते हैं। इस प्रोजेक्ट के अन्य दस्तावेज़ों के लिंक स्थानीय अनुक्रमणिका से पूर्वावलोकन बनाते हैं और कभी आपके कंप्यूटर से बाहर नहीं जाते।"],@@ -3393,6 +3466,9 @@}]],+ "mhnCt3": [+ "प्रत्येक अवधारणा दस्तावेज़ एक गैर-रिक्त प्रकार का होता है। यह OKF की संपूर्ण अनुरूपता मंजिल है - केवल एक प्रकार वाला दस्तावेज़ पूरी तरह से अनुरूप है।"+ ],"mk2poV": ["जैसे server.ts"],"mlvM8g": ["उस टिप्पणी को फिर से रखा नहीं जा सका।"],"mmpzAq": ["markdown स्रोत संपादक में लंबी पंक्तियाँ लपेटें।"],@@ -3651,6 +3727,9 @@"qRZh7J": ["Tab को अंदर करने के बजाय स्रोत संपादक से बाहर जाने दें।"],"qSKu2v": ["स्रोत नेविगेशन और चयन"],"qSxaOz": ["उनका विलोपन स्वीकारें"],+ "qTT48-": [+ "[[Page]] जैसे विकी-लिंक - यहां लिंक करने का एक समर्थित तरीका है, लेकिन एक बाहरी पाठक कुछ भी हल नहीं करता है और कोष्ठक दिखाता है।"+ ],"qTcVwj": ["इस प्रोजेक्ट के लिए कोई स्किल ब्राउज़ करें या अपलोड करें।"],"qTcZZu": ["टैग लोड करने में विफल। <0>Esc</0> दबाएँ और फिर कोशिश करने के लिए दोबारा खोलें।"],"qX-ABr": ["या इसके बजाय ब्राउज़र साइन-इन उपयोग करने के लिए:"],@@ -3693,6 +3772,7 @@"r51jLC": ["फ़ाइल सहेजी गई और Claude Desktop App खुला"],"r6ncaO": ["टैब बंद करें"],"r6y-jM": ["चेतावनी"],+ "r7IaYp": ["Open Knowledge Format मार्गदर्शन"],"r871ed": ["आपका ज्ञान आधार अब GitHub पर <0>", ["ownerLogin"], "/", ["repoName"], "</0> पर है।"],"rDOuNw": ["टेम्पलेट आयात करने में विफल"],"rENNI6": ["साझा करने का URL अमान्य है।"],@@ -3716,6 +3796,9 @@"rZVMkf": ["दृश्य संपादक का बदलें इनपुट फ़ोकस में"],"radOpL": ["चित्र ", ["identity"], "। संदर्भ पर जाएँ।"],"rageVb": ["लाइव पूर्वावलोकन पैनल वाला कस्टम HTML (सैंडबॉक्स किया गया iframe)।"],+ "rarziH": [+ "कोडिंग एजेंटों को OKF दस्तावेज़ प्रकार चुनने, उत्पत्ति को संरक्षित करने और असमर्थित मेटाडेटा का आविष्कार करने से बचने में मदद करता है।"+ ],"rbrHTd": ["स्वीकृत — ", ["optionName"]],"rcJmK8": ["स्थानों को प्रतियों में बदलें"],"rdU729": ["लेआउट"],@@ -3762,6 +3845,7 @@"sER-bs": ["फ़ाइलें"],"sFhaTJ": ["मेन्यू में एक जैसे नाम वाले टेम्पलेट में फ़र्क़ स्पष्ट करता है।"],"sGZLfB": ["रिपॉजिटरी लाने में विफल"],+ "sHDllh": ["index.md बनाए रखना बंद करें"],"sICrVf": [["0"], " वाले संस्करण पर बहाल किया गया"],"sIGbBZ": ["चयन को फ़ुटनोट में बदलें"],"sIxSSP": ["अपने टर्मिनल में टकराव सुलझाएँ"],@@ -3775,6 +3859,7 @@"sOxZaS": ["ग्राफ़ लोड करने में विफल"],"sQoLn0": ["बाहर निकलें"],"sR0I-f": ["सभी फ़ाइलें समेटें"],+ "sSRndh": ["index.md बनाए रखना प्रारंभ करें"],"sW5OjU": ["आवश्यक"],"sZ2IOu": ["यह ",@@ -3789,6 +3874,9 @@"saIASg": ["दूसरा आइटम"],"saYiIO": ["पथ में null बाइट नहीं हो सकते"],"scu3wk": ["मॉडल"],+ "scyoP9": [+ "आपके ज्ञानकोष के मूल दस्तावेज़ को छोड़कर, अनुक्रमणिका दस्तावेज़ों में कोई frontmatter नहीं होता है। लॉग दस्तावेज़ कवर नहीं किए गए हैं - OKF उनके frontmatter को बाधित नहीं करता है।"+ ],"se-tU0": [["total"], " में से ", ["0"], " फ़ाइलें ठीक नहीं की जा सकीं।"],"seeS6l": ["इस फ़ोल्डर में OpenKnowledge सेट अप करें?"],"sgmRY8": [["0"], " डाउनलोड करना छोड़ दिया गया।"],@@ -3841,6 +3929,9 @@"tHKQ6j": ["नाम बदला जा रहा है"],"tKlWWY": ["इमोजी"],"tLX6LY": ["OpenKnowledge ने एक दस्तावेज़ लिखा"],+ "tM5uzl": [+ "उत्पत्ति, विश्वास और जीवनचक्र परिवार: sources, generated, verified, status, और stale_after। प्रत्येक क्षेत्र वैकल्पिक है, और अनुपस्थिति कभी भी कोई त्रुटि नहीं होती है।"+ ],"tN5WTS": ["प्रदाता ने अनुरोध अस्वीकार कर दिया। API कुंजी और मॉडल id जाँचें।"],"tP5DDk": ["लिंक लागू करें"],"tUvUfp": ["कोई ऐसा फ़ोल्डर उपयोग करें जो आपके पास पहले से है।"],@@ -3898,6 +3989,9 @@"uGaIIS": ["वर्कट्री चेक आउट करें"],"uH_S-u": [["loadErrorTitle"], ": ", ["message"]],"uJfwF8": ["पहले से इंस्टॉल है — आयात करने के लिए कुछ नया नहीं।"],+ "uK2peg": [+ "Open Knowledge Format के विरुद्ध आपके प्रोजेक्ट की जाँच करता है। किसी भी समय सेटिंग में जाकर इसे बंद कर दें."+ ],"uKRYiW": ["सिंक स्थिति अनुपलब्ध — सर्वर त्रुटि।"],"uL_Wx8": ["टर्मिनल अप्रत्याशित रूप से रुक गया।"],"uM6jnS": ["बहाली विफल"],@@ -3950,6 +4044,9 @@"uyOQ4e": ["थीम को base16 YAML के रूप में कॉपी किया गया"],"uynXup": [["tokens", "plural", { "one": ["टोकन"], "other": ["टोकन"] }]],"v-h2hx": [["targetGitPath"], " हटाएँ"],+ "v15iQB": [+ "प्रमाणित-गणना अनुबंध। केवल Attested Computation टाइप किए गए दस्तावेज़ों पर लागू होता है, जहां OKF को runtime की आवश्यकता होती है; सामान्य अवधारणाएँ अप्रभावित रहती हैं।"+ ],"v2ZW0K": ["टर्मिनल सक्षम करें"],"v2a04T": ["markdownlint नियम"],"v41fCm": ["फ़ाइल नहीं मिली"],diff --git a/packages/app/src/locales/hi/messages.po b/packages/app/src/locales/hi/messages.poindex 3d600ba46..7f92c2ba5 100644--- a/packages/app/src/locales/hi/messages.po+++ b/packages/app/src/locales/hi/messages.po@@ -263,6 +263,11 @@ msgstr "{0, plural, one {अभी {2} में से {1} दस्तावmsgid "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"msgstr "{0, plural, one {# दस्तावेज़ में कोई समस्या नहीं।} other {# दस्तावेज़ों में कोई समस्या नहीं।}}"+#. placeholder {0}: pluginRows.length+#: src/components/CreatedItemsList.tsx+msgid "{0, plural, one {Plugin} other {Plugins}}"+msgstr "{0, plural, one {प्लगइन} other {प्लगइन}}"+#. placeholder {0}: editorList.hiddenCount#: src/components/McpConsentDialogBody.tsxmsgid "{0, plural, one {Show # more tool} other {Show # more tools}}"@@ -629,7 +634,9 @@ msgstr "{displayName} CLI, {hint}"msgid "{docName} is {0}. OpenKnowledge currently opens files up to {1}."msgstr "{docName} {0} है। OpenKnowledge फ़िलहाल {1} तक की फ़ाइलें खोलता है।"+#. placeholder {0}: OKF_RULE_IDS.length#. placeholder {0}: entries.length+#: src/components/settings/LintingSection.tsx#: src/components/settings/markdownlint-rule-browser.tsxmsgid "{enabledCount}/{0} on"msgstr "{0} में से {enabledCount} चालू"@@ -792,6 +799,10 @@ msgstr "{percent}% उपयोग में ({left}% शेष)"msgid "{phase} — {pct}%"msgstr "{phase} — {pct}%"+#: src/components/CreatedItemsList.tsx+msgid "{pluginCount, plural, one {plugin} other {plugins}}"+msgstr "{pluginCount, plural, one {प्लगइन} other {प्लगइन}}"+#: src/components/PropertyDisclosure.tsxmsgid "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"msgstr "{problemCount, plural, one {# प्रॉपर्टी स्कीमा से मेल नहीं खाती} other {# प्रॉपर्टी स्कीमा से मेल नहीं खातीं}}"@@ -1543,6 +1554,10 @@ msgstr "पहले से चुने गए मूल फ़ोल्डरmsgid "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."msgstr "पहले से एक git रिपॉज़िटरी है? इस प्रोजेक्ट के फ़ोल्डर में <0>git remote add origin <url></0> से इसे जोड़ें। रिमोट का पता चलते ही यह पेज अपने आप अद्यतित हो जाता है।"+#: src/components/settings/LintingSection.tsx+msgid "Already in project"+msgstr "पहले से ही प्रोजेक्ट में है"+#: src/components/SkillPluginBundleDialog.tsxmsgid "Already installed — nothing new to import."msgstr "पहले से इंस्टॉल है — आयात करने के लिए कुछ नया नहीं।"@@ -1588,6 +1603,10 @@ msgstr "एक और सिंक कार्रवाई चल रही हmsgid "any"msgstr "कोई भी"+#: src/components/settings/LintingSection.tsx+msgid "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+msgstr "कोई भी .mdx फ़ाइल। प्रारूप केवल .md है, इसलिए .md को स्कैन करने वाला पाठक इसे कभी नहीं खोलता है - और यदि समान नाम का .md मौजूद है, तो इसके बजाय उसे पढ़ता है।"+#. placeholder {0}: summary.name#: src/components/settings/LintingSection.tsxmsgid "any doc named {0}"@@ -2148,6 +2167,7 @@ msgstr "यह पथ साझा नहीं किया जा सकता#: src/components/ReportBugDialogBody.tsx#: src/components/SeedDialog.tsx#: src/components/settings/LinkPreviewsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/SavedThemesTiles.tsx#: src/components/settings/SearchSection.tsx#: src/components/ShareBranchSwitchDialog.tsx@@ -2288,6 +2308,10 @@ msgstr "फ़ाइलें चेक आउट की जा रही हैmsgid "Checking sign-in status"msgstr "साइन-इन स्थिति जाँची जा रही है"+#: src/components/settings/LintingSection.tsx+msgid "Checking skill"+msgstr "कौशल की जाँच करना"+#: src/components/ImportSkillForm.tsxmsgid "Checking source"msgstr "स्रोत जाँचा जा रहा है"@@ -2304,6 +2328,10 @@ msgstr "जाँचा जा रहा है…"msgid "Checklist with checkboxes."msgstr "चेकबॉक्स वाली चेकलिस्ट।"+#: src/components/CreatedItemsList.tsx+msgid "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+msgstr "Open Knowledge Format के विरुद्ध आपके प्रोजेक्ट की जाँच करता है। किसी भी समय सेटिंग में जाकर इसे बंद कर दें."+#: src/components/ImportSkillForm.tsxmsgid "Choose a skill archive"msgstr "कोई स्किल संग्रह चुनें"@@ -4300,6 +4328,10 @@ msgstr "{0} अक्षम करें"msgid "Disable {file}"msgstr "{file} अक्षम करें"+#: src/components/settings/LintingSection.tsx+msgid "Disable {id}"+msgstr "{id} को अक्षम करें"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "Disable external link previews"msgstr "बाहरी लिंक पूर्वावलोकन अक्षम करें"@@ -4402,6 +4434,10 @@ msgstr "दस्तावेज़ पैनल"msgid "Document statistics"msgstr "दस्तावेज़ आँकड़े"+#: src/components/settings/LintingSection.tsx+msgid "Document structure"+msgstr "दस्तावेज़ संरचना"+#: src/components/empty-state/use-create-suggestions.tsmsgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."msgstr "इस रिपॉज़िटरी की संरचना का दस्तावेज़ीकरण करें: एक सिंहावलोकन पेज बनाएँ जो हर प्रमुख मॉड्यूल के पेज से जुड़ता हो और उसकी ज़िम्मेदारियाँ तथा प्रवेश बिंदु बताता हो।"@@ -4793,6 +4829,10 @@ msgstr "{displayName} CLI सक्षम करें"msgid "Enable {file}"msgstr "{file} सक्षम करें"+#: src/components/settings/LintingSection.tsx+msgid "Enable {id}"+msgstr "{id} सक्षम करें"+#: src/components/AutoSyncOnboardingDialog.tsx#: src/components/EnableSyncConfirmDialog.tsx#: src/components/share-receive-miss-content.tsx@@ -4817,6 +4857,10 @@ msgstr "Follow सक्षम करें?"msgid "Enable git auto-sync?"msgstr "git स्वत: सिंक सक्षम करें?"+#: src/components/settings/LintingSection.tsx+msgid "Enable indexes"+msgstr "अनुक्रमणिका सक्षम करें"+#: src/components/ProblemsPanel.tsxmsgid "Enable plugins"msgstr "प्लगइन सक्षम करें"@@ -4845,6 +4889,10 @@ msgstr "इस प्रोजेक्ट के लिए टर्मिनmsgid "Enable Themes"msgstr "थीम सक्षम करें"+#: src/components/settings/LintingSection.tsx+msgid "Enabling index generation"+msgstr "सूचकांक निर्माण सक्षम करना"+#: src/components/ActivityModeContent.tsxmsgid "Ended"msgstr "समाप्त"@@ -4915,6 +4963,10 @@ msgstr "त्रुटि:"msgid "Escape"msgstr "Escape"+#: src/components/settings/LintingSection.tsx+msgid "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+msgstr "प्रत्येक अवधारणा दस्तावेज़ एक गैर-रिक्त प्रकार का होता है। यह OKF की संपूर्ण अनुरूपता मंजिल है - केवल एक प्रकार वाला दस्तावेज़ पूरी तरह से अनुरूप है।"+#: src/components/settings/LintingSection.tsxmsgid "every doc"msgstr "हर दस्तावेज़"@@ -5690,6 +5742,10 @@ msgstr "टेम्पलेट से"msgid "From the {0} plugin"msgstr "{0} प्लगइन से"+#: src/components/settings/LintingSection.tsx+msgid "Frontmatter"+msgstr "frontmatter"+#: src/components/TemplateForm.tsxmsgid "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."msgstr "वह frontmatter जिससे इस टेम्पलेट से बना हर दस्तावेज़ शुरू होता है। मान YAML होते हैं — सूची <0>[a, b]</0> होती है; <1>{{date}}</1> बनाते समय भर जाता है।"@@ -5732,6 +5788,10 @@ msgstr "खेल समाप्त · फिर से खेलने केmsgid "General"msgstr "सामान्य"+#: src/components/settings/LintingSection.tsx+msgid "Generated files"+msgstr "जेनरेट की गई फ़ाइलें"+#: src/components/TerminalCliMissingBanner.tsxmsgid "Get {displayName}"msgstr "{displayName} लें"@@ -5765,6 +5825,10 @@ msgstr "git कॉन्फ़िगरेशन अनुपलब्ध हैmsgid "Git identity isn't set — commits use a default author. Set yours so teammates see your name."msgstr "Git पहचान सेट नहीं है — कमिट एक डिफ़ॉल्ट लेखक का उपयोग करते हैं। अपनी पहचान सेट करें ताकि सहकर्मी आपका नाम देख सकें।"+#: src/components/settings/LintingSection.tsx+msgid "Git merge rule"+msgstr "Git मर्ज नियम"+#: src/components/ShareBranchSwitchDialog.tsxmsgid "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."msgstr "Git को इस रिपॉज़िटरी के लिए {tool} चाहिए, पर वह इंस्टॉल नहीं है या मिला नहीं। इसे इंस्टॉल करें, फिर कोशिश करें।"@@ -5919,7 +5983,7 @@ msgstr "heading-slug"msgid "Headings"msgstr "शीर्षक"-#: src/components/AutoSyncEnableWarning.tsx+#: src/components/DisclosureWarning.tsx#: src/editor/slash-command/component-items.tsxmsgid "Heads up"msgstr "ध्यान दें"@@ -5941,6 +6005,10 @@ msgstr "नमस्ते, दुनिया!"msgid "Help"msgstr "सहायता"+#: src/components/settings/LintingSection.tsx+msgid "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+msgstr "कोडिंग एजेंटों को OKF दस्तावेज़ प्रकार चुनने, उत्पत्ति को संरक्षित करने और असमर्थित मेटाडेटा का आविष्कार करने से बचने में मदद करता है।"+#. Subtext for the open-knowledge-discovery skill row#. Subtext for the open-knowledge-discovery skill row#: src/components/McpConsentDialogBody.tsx@@ -6273,10 +6341,18 @@ msgstr "\"{0}\" के रूप में आयात किया गयाmsgid "Importing"msgstr "आयात किया जा रहा है"+#: src/components/settings/LintingSection.tsx+msgid "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+msgstr "एक लॉग दस्तावेज़ में: प्रविष्टि शीर्षक ISO YYYY-MM-DD दिनांक के साथ आगे बढ़ते हैं, सबसे पहले नवीनतम। आप कितने title का उपयोग करते हैं, और क्या प्रविष्टियाँ बुलेट हैं, यह आप पर निर्भर है।"+#: src/components/SeedDialog.tsxmsgid "In a subfolder"msgstr "किसी उप-फ़ोल्डर में"+#: src/components/settings/LintingSection.tsx+msgid "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+msgstr "एक सूचकांक दस्तावेज़ में: प्रविष्टियाँ एक अनुभाग शीर्षक के अंतर्गत होती हैं और प्रत्येक में एक लिंक होता है। सूचियों के आसपास गद्य ठीक है."+#: src/components/empty-state/CreatePromptComposer.tsx#: src/components/handoff/AgentSplitButton.tsx#: src/components/handoff/OpenInAgentContextSubmenu.tsx@@ -6295,6 +6371,14 @@ msgstr "ऐप में"msgid "In app (beta)"msgstr "ऐप में (बीटा)"+#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+msgstr "Git प्रोजेक्ट में, Open Knowledge रिपॉजिटरी के रूट की .gitattributes फ़ाइल में सीमित दायरे वाला नियम जोड़ता है, ताकि एक साथ किए गए इंडेक्स बदलाव जुड़ सकें।"++#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+msgstr "Git परियोजनाओं में, Open Knowledge एक स्कोप्ड .gitattributes नियम भी जोड़ता है ताकि समवर्ती सूचकांक परिवर्तन अगले पुनर्निर्माण से पहले संयोजित हो जाएं।"+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "In the Claude Desktop App"msgstr "Claude Desktop App में"@@ -6319,6 +6403,26 @@ msgstr "मौजूदा सूची आइटम को अंदर याmsgid "Indented blockquote for citations."msgstr "उद्धरणों के लिए अंदर की ओर खिसका हुआ ब्लॉककोट।"+#: src/components/settings/LintingSection.tsx+msgid "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+msgstr "आपके ज्ञानकोष के मूल दस्तावेज़ को छोड़कर, अनुक्रमणिका दस्तावेज़ों में कोई frontmatter नहीं होता है। लॉग दस्तावेज़ कवर नहीं किए गए हैं - OKF उनके frontmatter को बाधित नहीं करता है।"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+msgstr "सूचकांक रखरखाव रोक दिया गया है क्योंकि एक अन्य Git विशेषता index.md को नियंत्रित करती है। .gitattributes को अपडेट करें ताकि दायरे वाले index.md पथ merge=union का उपयोग करें, फिर पुनः प्रयास करें।"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+msgstr "सूचकांक रखरखाव रोक दिया गया है क्योंकि Open Knowledge आवश्यक Git मर्ज नियम की पुष्टि नहीं कर सका। Git और .gitattributes को जांचें, फिर पुनः प्रयास करें।"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+msgstr "सूचकांक रखरखाव बंद रहा क्योंकि Open Knowledge प्रोजेक्ट सर्वर तक नहीं पहुंच सका। प्रोजेक्ट पुनः कनेक्ट होने पर पुनः प्रयास करें."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+msgstr "इंडेक्स रखरखाव बंद रहा क्योंकि प्रोजेक्ट सेटिंग सहेजी नहीं जा सकी। प्रोजेक्ट फ़ाइल अनुमतियाँ जाँचें, फिर पुनः प्रयास करें।"+#: src/components/settings/SearchSection.tsxmsgid "Indexed {embedded} of {total} pages."msgstr "{total} में से {embedded} पेज अनुक्रमित।"@@ -6507,6 +6611,10 @@ msgstr "सभी एजेंट पर इंस्टॉल करें"msgid "Install selected"msgstr "चयनित इंस्टॉल करें"+#: src/components/settings/LintingSection.tsx+msgid "Install skill"+msgstr "कौशल स्थापित करें"+#: src/components/SkillPluginBundleBanner.tsxmsgid "Install skills"msgstr "स्किल इंस्टॉल करें"@@ -6516,6 +6624,7 @@ msgid "Install the gh CLI"msgstr "gh CLI इंस्टॉल करें"#: src/components/settings/AiToolsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ProjectAiToolsSection.tsx#: src/components/SkillEditorActions.tsxmsgid "Installed"@@ -6729,6 +6838,10 @@ msgstr "इस प्रोजेक्ट को अपने git रिमोmsgid "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."msgstr "आप जिन लोगों और कंपनियों के साथ काम करते हैं और उनके साथ होने वाली बैठकों पर नज़र रखें। यह याद रखने के लिए अच्छा कि कोई कौन है, आप उसे कैसे जानते हैं, और आपकी आख़िरी बात किस पर हुई थी।"+#: src/components/settings/LintingSection.tsx+msgid "Keeps your knowledge base aligned with the Open Knowledge Format."+msgstr "आपके ज्ञानकोष को Open Knowledge Format के अनुरूप रखता है।"+#. placeholder {0}: toName.trim()#: src/components/SkillForkDialog.tsxmsgid "Kept both — \"{0}\" is its own skill now"@@ -7104,6 +7217,14 @@ msgstr "<0>{lookingForUrl}</0> खोजा जा रहा है।"msgid "Lost connection to \"{docName}\"."msgstr "\"{docName}\" से कनेक्शन टूट गया।"+#: src/components/settings/LintingSection.tsx+msgid "Maintain generated indexes in every folder?"+msgstr "प्रत्येक फ़ोल्डर में generated अनुक्रमणिका बनाए रखें?"++#: src/components/settings/LintingSection.tsx+msgid "Maintain index.md"+msgstr "index.md बनाए रखें"+#: src/components/SkillInstallMenu.tsxmsgid "make source"msgstr "स्रोत बनाएँ"@@ -8248,6 +8369,10 @@ msgstr "OK Desktop"msgid "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."msgstr "OK ने पिछली बार इस फ़ोल्डर को {0} पर सेट किया था — उसके बाद OK के बाहर किसी चीज़ ने इसे बदल दिया। दिखाई गई स्थिति वही है जो अभी डिस्क पर है; आपका अगला Symlink/Unlink प्रभावी होगा।"+#: src/components/settings/LintingSection.tsx+msgid "OKF agent skill installed"+msgstr "OKF एजेंट कौशल स्थापित"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "On — hovering an external link sends its URL to the destination site to fetch a preview."msgstr "चालू — किसी बाहरी लिंक पर माउस ले जाने पर पूर्वावलोकन लाने के लिए उसका URL गंतव्य साइट को भेजा जाता है।"@@ -8264,6 +8389,10 @@ msgstr "<0>{address}</0> पर"msgid "On selected text in <0>{address}</0>"msgstr "<0>{address}</0> में चयनित पाठ पर"+#: src/components/settings/LintingSection.tsx+msgid "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+msgstr "रूट इंडेक्स पर, okf_version को \"0.2\" जैसी उद्धृत स्ट्रिंग के रूप में लिखा जाता है। अउद्धृत, YAML इसे एक संख्या के रूप में पढ़ता है और 0.10 चुपचाप 0.1 बन जाता है।"+#. Next step for a Cursor project MCP row — Cursor leaves project servers disabled#: src/components/settings/ProjectAiToolsSection.tsxmsgid "One more step: enable it in Cursor → Settings → Tools & MCP (Cursor leaves project servers off until you turn them on)."@@ -8486,6 +8615,22 @@ msgstr "वर्कट्री में खोलें"msgid "Open it there"msgstr "इसे वहाँ खोलें"+#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+msgstr "Open Knowledge प्रत्येक फ़ोल्डर में index.md नामक एक नेविगेशन फ़ाइल बनाता है और उसका रखरखाव करता है जिसमें Markdown होता है।"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge Format guidance"+msgstr "Open Knowledge Format मार्गदर्शन"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+msgstr "Open Knowledge प्रत्येक फ़ोल्डर में index.md नामक एक नेविगेशन फ़ाइल रखता है जिसमें Markdown होता है, प्रत्येक उस फ़ोल्डर के दस्तावेज़ों को प्रकार के आधार पर सूचीबद्ध करता है और उसके सबफ़ोल्डर्स से लिंक करता है। जैसे ही आपके दस्तावेज़ बदलते हैं, यह इन फ़ाइलों को फिर से लिखता है, और आप उनमें जो कुछ भी संपादित करते हैं वह बदल दिया जाता है।"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+msgstr "दस्तावेज़ बदलने पर Open Knowledge इन index.md फ़ाइलों को फिर से लिखता है, इसलिए उनमें मैन्युअल संपादन बदल दिए जाते हैं।"+#. placeholder {0}: item.displayName#. placeholder {1}: item.displayName#. placeholder {2}: item.version@@ -8532,6 +8677,10 @@ msgstr "सेटिंग खोलें"msgid "Open shared {targetNoun}"msgstr "साझा {targetNoun} खोलें"+#: src/components/settings/LintingSection.tsx+msgid "Open skill"+msgstr "खुला कौशल"+#: src/editor/extensions/JsxComponentView.tsxmsgid "Open source doc: {mirrorSrc}"msgstr "स्रोत दस्तावेज़ खोलें: {mirrorSrc}"@@ -9368,6 +9517,7 @@ msgid "project"msgstr "प्रोजेक्ट"#: src/components/CommandPalette.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ScopeBadge.tsx#: src/lib/skill-scope.tsmsgid "Project"@@ -9639,6 +9789,10 @@ msgstr "हाल का प्रोजेक्ट"msgid "Recently opened"msgstr "हाल में खोले गए"+#: src/components/settings/LintingSection.tsx+msgid "Recommended agent skill"+msgstr "अनुशंसित एजेंट कौशल"+#: src/components/SyncStatusBadge.tsxmsgid "Reconnect required"msgstr "फिर से जुड़ना ज़रूरी"@@ -10076,6 +10230,10 @@ msgstr "उड़ान न भरने वाले पक्षियोंmsgid "research-note"msgstr "research-note"+#: src/components/settings/LintingSection.tsx+msgid "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+msgstr "आरक्षित फ़ाइलों को लोअरकेस में index.md और log.md नाम दिया गया है। केस-संवेदी फ़ाइल सिस्टम पर, Index.md को एक सामान्य दस्तावेज़ के रूप में पढ़ा जाता है और इसका अर्थ खो जाता है।"+#: src/components/settings/CustomThemeEditor.tsxmsgid "Reset"msgstr "रीसेट करें"@@ -10318,6 +10476,7 @@ msgid "Rule editing is available for the project's root markdownlint config"msgstr "नियम संपादन प्रोजेक्ट के रूट markdownlint कॉन्फ़िग के लिए उपलब्ध है"#: src/components/LintConfigEditor.tsx+#: src/components/settings/LintingSection.tsxmsgid "Rules"msgstr "नियम"@@ -11260,6 +11419,10 @@ msgstr "{conflictHosts} के लिए स्किल “{conflictName}”msgid "Skill \"{name}\" created"msgstr "स्किल \"{name}\" बनाई गई"+#: src/components/settings/LintingSection.tsx+msgid "Skill already in project"+msgstr "कौशल पहले से ही परियोजना में है"+#: src/components/ExploreSkills.tsxmsgid "Skill discovery powered by <0>skills.sh</0>"msgstr "स्किल खोज <0>skills.sh</0> द्वारा संचालित"@@ -11519,6 +11682,10 @@ msgstr "यहाँ से शुरू करें"msgid "Start here: what this is and how it's organized."msgstr "यहाँ से शुरू करें: यह क्या है और कैसे व्यवस्थित है।"+#: src/components/settings/LintingSection.tsx+msgid "Start maintaining index.md"+msgstr "index.md बनाए रखना प्रारंभ करें"+#: src/lib/keyboard-shortcuts.tsmsgid "Start source completion"msgstr "स्रोत पूर्णता शुरू करें"@@ -11614,6 +11781,10 @@ msgstr "फ़ाइलें ठीक करना रोकें"msgid "Stop fixing. Files already fixed stay fixed."msgstr "ठीक करना रोकें। जो फ़ाइलें पहले ही ठीक हो चुकी हैं वे ठीक ही रहेंगी।"+#: src/components/settings/LintingSection.tsx+msgid "Stop maintaining index.md"+msgstr "index.md बनाए रखना बंद करें"+#: src/lib/project-fix-sweep-store.tsmsgid "Stopped fixing. Files already fixed stay fixed."msgstr "ठीक करना रोक दिया गया। जो फ़ाइलें पहले ही ठीक हो चुकी हैं वे ठीक ही रहेंगी।"@@ -12117,6 +12288,10 @@ msgstr "एजेंट रुक नहीं रहा है। फ़ोरmsgid "The agent's persona, values, and voice."msgstr "एजेंट का व्यक्तित्व, मूल्य और स्वर।"+#: src/components/settings/LintingSection.tsx+msgid "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+msgstr "प्रमाणित-गणना अनुबंध। केवल Attested Computation टाइप किए गए दस्तावेज़ों पर लागू होता है, जहां OKF को runtime की आवश्यकता होती है; सामान्य अवधारणाएँ अप्रभावित रहती हैं।"+#: src/components/ProblemsPanel.tsxmsgid "The audit could not be completed. Try again."msgstr "ऑडिट पूरा नहीं हो सका। फिर कोशिश करें।"@@ -12175,6 +12350,10 @@ msgstr "सूत्र <0>c = √(a² + b²)</0> इनलाइन रेंmsgid "the git exclude file isn't writable"msgstr "git exclude फ़ाइल लिखने योग्य नहीं है"+#: src/components/settings/LintingSection.tsx+msgid "The index files stay in place. Open Knowledge removes only the Git rule it added."+msgstr "अनुक्रमणिका फ़ाइलें यथावत रहती हैं. Open Knowledge केवल अपने द्वारा जोड़े गए Git नियम को हटाता है।"+#: src/lib/locale-load-failure-notice.tsmsgid "The interface is still in the language you were reading. Check your connection, then reload to try again."msgstr "इंटरफ़ेस अब भी उसी भाषा में है जिसे आप पढ़ रहे थे। अपना कनेक्शन जाँचें, फिर दोबारा कोशिश करने के लिए फिर से लोड करें।"@@ -12211,6 +12390,10 @@ msgstr "इस दस्तावेज़ के ऊपर मौजूद पmsgid "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."msgstr "प्रॉपर्टी बदलीं, पर उनकी तुलना नहीं हो सकी — YAML पार्स नहीं हुआ। दोनों संस्करण जैसे लिखे थे वैसे ही दिखाए जा रहे हैं।"+#: src/components/settings/LintingSection.tsx+msgid "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+msgstr "उत्पत्ति, विश्वास और जीवनचक्र परिवार: sources, generated, verified, status, और stale_after। प्रत्येक क्षेत्र वैकल्पिक है, और अनुपस्थिति कभी भी कोई त्रुटि नहीं होती है।"+#: src/components/settings/SearchSection.tsxmsgid "The provider is rate-limiting this key. Try again in a moment."msgstr "प्रदाता इस कुंजी की दर सीमित कर रहा है। कुछ देर बाद फिर कोशिश करें।"@@ -12248,6 +12431,10 @@ msgstr "स्कीमा फ़ाइल मौजूद नहीं हैmsgid "the server responded but server.lock has no port yet"msgstr "सर्वर ने जवाब दिया लेकिन server.lock में अभी कोई पोर्ट नहीं है"+#: src/components/settings/LintingSection.tsx+msgid "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+msgstr "जब आप title, description, resource, और tags का उपयोग करते हैं तो उनकी आकृतियाँ। किसी की भी आवश्यकता नहीं है; किसी को घोषित करने से केवल उसके प्रकार का पता चलता है, इसलिए अल्पविराम से अलग की गई स्ट्रिंग के रूप में लिखे गए tags को चिह्नित किया जाता है।"+#: src/components/SkillInstallMenu.tsxmsgid "The skill's own folder — the source other locations copy or link from"msgstr "स्किल का अपना फ़ोल्डर — वह स्रोत जिससे बाकी स्थान प्रति बनाते या लिंक करते हैं"@@ -12561,6 +12748,10 @@ msgstr "इसमें कुछ समय लग सकता है। आपmsgid "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."msgstr "यह <0>{name}</0> को {0} से {1} में ले जाता है, डिस्क पर इसकी फ़ाइलें दूसरी जगह रखता है और इसे आपके संपादकों में {2} स्तर पर फिर से इंस्टॉल करता है।"+#: src/components/settings/LintingSection.tsx+msgid "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+msgstr "इसे आपकी फ़ाइलों को देखने की ज़रूरत है, न कि केवल खुले दस्तावेज़ को, इसलिए यह तब दिखाई देता है जब आप टाइप करते समय प्रोजेक्ट ऑडिट चलाते हैं।"+#: src/components/SeedDialog.tsxmsgid "This pack is already set up here."msgstr "यह पैक यहाँ पहले से सेट अप है।"@@ -12924,6 +13115,10 @@ msgstr "{0} को फिर से एक असली निर्देशिmsgid "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."msgstr "{display} को फिर से एक असली निर्देशिका बनाएँ जिसमें उसे अभी दिखने वाली हर स्किल के लिए एक अलग सिमलिंक हो — कुछ भी काम करना बंद नहीं करता, और उसके बाद हर स्किल का मेन्यू उसे सँभालता है।"+#: src/components/CreatedItemsList.tsx+msgid "Turn it off any time in Settings."+msgstr "किसी भी समय सेटिंग में जाकर इसे बंद कर दें."+#: src/components/NotInSidebarIndicator.tsxmsgid "Turn off Only markdown files"msgstr "केवल markdown फ़ाइलें बंद करें"@@ -12949,6 +13144,10 @@ msgstr "अर्थ-आधारित खोज चालू करें?"msgid "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."msgstr "आप जो पढ़ते हैं उसे स्पष्ट, भरोसेमंद लेखों में बदलें। कोई स्रोत सहेजें, समझें कि उसका क्या अर्थ है, फिर अंतिम संस्करण रखें ताकि आप बाद में उस पर भरोसा कर सकें।"+#: src/components/settings/LintingSection.tsx+msgid "Turning it off"+msgstr "इसे बंद कर रहा हूँ"+#: src/components/acp/working-status.tsmsgid "Turning it over…"msgstr "सोचा जा रहा है…"@@ -13639,6 +13838,10 @@ msgstr "विकी लिंक"msgid "Wiki link suggestions"msgstr "विकी लिंक सुझाव"+#: src/components/settings/LintingSection.tsx+msgid "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+msgstr "[[Page]] जैसे विकी-लिंक - यहां लिंक करने का एक समर्थित तरीका है, लेकिन एक बाहरी पाठक कुछ भी हल नहीं करता है और कोष्ठक दिखाता है।"+#: src/components/PublishToGitHubDialog.tsxmsgid "Will be created as <0>{sanitizedName}</0>"msgstr "<0>{sanitizedName}</0> के रूप में बनाया जाएगा"diff --git a/packages/app/src/locales/id/messages.json b/packages/app/src/locales/id/messages.jsonindex 7af87c2dd..66b354133 100644--- a/packages/app/src/locales/id/messages.json+++ b/packages/app/src/locales/id/messages.json@@ -121,6 +121,9 @@"0ySP5u": ["Perubahan disimpan otomatis ke tema ini."],"0zAhu6": ["semua dokumen"],"10g8I_": ["Matikan Hanya berkas markdown"],+ "110eEb": [+ "Open Knowledge membuat dan memelihara file navigasi bernama index.md di setiap folder yang berisi Markdown."+ ],"11ukmX": ["Gagal mengganti nama: ", ["0"]],"12F9WL": ["(tanpa id)"],"151wvk": ["Tampilkan bilah sisi"],@@ -138,6 +141,9 @@"1GhYxC": ["dari ", ["totalPages"]],"1HBhDS": ["Mengambil berkas"],"1J0c0X": ["Masih tidak dapat menghubungi ", ["displayName"], ". Coba sekali lagi?"],+ "1JpLgH": [+ "Dalam dokumen indeks: entri berada di bawah judul bagian dan masing-masing membawa tautan. Prosa seputar daftar itu baik-baik saja."+ ],"1LtA5r": ["Menautkan keterampilan secara symlink ke ", ["path"]],"1MGRQl": ["Sesi terminal"],"1NgrlY": ["Cara lain untuk memasang"],@@ -151,6 +157,7 @@"1XSMhZ": ["Beralih ke <0>lokal saja</0> akan ditolak sampai semuanya berhenti dilacak lewat<1> git rm --cached</1>."],+ "1ZXkqM": ["Matikan kapan saja di Pengaturan."],"1ZpfyB": ["Buka dengan AI ", ["displayName"], ", ", ["hint"]],"1a6ICf": ["Mengikuti suntingan agen"],"1bDVu5": ["Palet Perintah Ruang Kerja"],@@ -289,6 +296,8 @@"3o3tur": ["Isi awal"],"3oh0nQ": ["Galat .okignore bersarang di ", ["path"]],"3pU8e-": ["Sematkan tab"],+ "3qDsdf": ["Instal keterampilan"],+ "3ri_4O": ["Menjaga basis pengetahuan Anda tetap selaras dengan Open Knowledge Format."],"3s-k7L": [["0", "plural", { "other": ["Tampilkan ", "#", " alat lagi"] }]],"3uSzeS": ["Gambar dari mana saja · berkas non-gambar harus berada di ruang kerja"],"3v62tp": ["Populer di skills.sh"],@@ -432,6 +441,9 @@],"5tcmwY": ["Tambahkan nilai"],"5vAI6Z": ["Tidak cocok dengan alur kerja saya"],+ "5w38tn": [+ "Pemeliharaan indeks terhenti karena Open Knowledge tidak dapat menjangkau server proyek. Coba lagi saat proyek tersambung kembali."+ ],"5wV2qQ": ["dan lainnya"],"5y_9lO": ["Menunggu otorisasi"],"6-wLTJ": [["behind"], " di belakang origin"],@@ -567,6 +579,7 @@"7d1a0d": ["Publik"],"7dZnmw": ["Relevansi"],"7hctf2": ["Jelaskan proyek yang ingin Anda buat"],+ "7idx48": ["OKF keterampilan agen diinstal"],"7jIIFX": ["Semuanya sudah siap!"],"7kb4LU": ["Disetujui"],"7l15X4": ["gagal"],@@ -574,6 +587,7 @@"7m3Ade": ["pemasangan:"],"7qRHf0": ["Pasang untuk Claude Chat & Cowork"],"7uBlRT": ["Menyalin item pohon berkas yang sedang difokus agar Tempel bisa menggandakannya."],+ "7wogIQ": [["0", "plural", { "other": ["Plugin"] }]],"80c4-P": ["Kode disalin ke papan klip"],"81H_23": ["Tambahkan properti"],"851WA-": ["Ini bisa diatur di Pengaturan > Alat AI & CLI"],@@ -629,6 +643,7 @@"8nWu1k": ["Diagram kosong"],"8oWgty": ["Tandai semua komentar untuk dikirim"],"8qgfac": ["Server MCP"],+ "8rZ1pk": ["Aktifkan ", ["id"]],"8ruqQi": ["Tautan internal rusak"],"8sMErm": ["Aktifkan Ikuti?"],"8t9CRE": ["Memulai ", ["agentName"], "…"],@@ -793,6 +808,9 @@"BQKHuL": ["Mulai ulang terminal"],"BQu9Pg": ["Symlink"],"BUyQnq": ["Server tidak bisa dimulai ulang. Coba `ok start` di folder ini."],+ "BVkqD9": [+ "Pemeliharaan indeks dihentikan sementara karena atribut Git lainnya mengontrol index.md. Perbarui .gitattributes sehingga jalur index.md yang dicakup menggunakan merge=union, lalu coba lagi."+ ],"BY-g4_": ["Tambahkan pola"],"Ba4D2x": ["Templat diimpor"],"Bdha5y": ["Menerbitkan..."],@@ -811,6 +829,9 @@"Bv5a9_": ["Statistik pilihan"],"Bx4EXG": ["Tindakan untuk ", ["label"]],"By-7Pn": ["Menyalakan atau mematikan daftar berpoin."],+ "ByIOcK": [+ "File indeks tetap di tempatnya. Open Knowledge hanya menghapus aturan Git yang ditambahkannya."+ ],"BymzO4": ["Kerangka dokumen"],"C-mmmK": ["Id model yang dilayani endpoint Anda. Ukuran vektornya terdeteksi otomatis — kosongkan bidang ini untuk kembali ke ",@@ -852,6 +873,9 @@"<0>~/.ok/bin</0> dan <1>~/.ok/env.sh</1> tetap ada apa pun pilihannya — aplikasi selalu memeliharanya."],"CXTwen": ["Konfigurasi proyek ini tidak bisa disunting dengan aman"],+ "CXcveY": [+ "Open Knowledge menyimpan file navigasi bernama index.md di setiap folder yang berisi Markdown, masing-masing mencantumkan dokumen folder tersebut berdasarkan jenis dan tautan ke subfoldernya. Itu menulis ulang file-file ini saat dokumen Anda berubah, dan apa pun yang Anda edit sendiri ke dalamnya akan diganti."+ ],"CXj9C-": ["Nama properti baru"],"C_Lyvh": ["Gagal menyimpan pengaturan tema"],"C_WGy8": [@@ -875,6 +899,9 @@"Cu6GXQ": ["Folder sumbernya sendiri tidak berpindah."],"CvsD6Y": ["via ", ["viaTags"]],"CwOXMT": ["Nilai untuk ", ["keyName"]],+ "CxCOFx": [+ "Dalam proyek Git, Open Knowledge menambahkan aturan tercakup ke file .gitattributes di root repositori agar perubahan indeks yang bersamaan dapat digabungkan."+ ],"CxVk-w": ["Komentari ", ["address"]],"D-NlUC": ["Sistem"],"D-Oh1s": ["Cara menyiapkan ", ["0"], " (terbuka di peramban)"],@@ -936,6 +963,9 @@"DhT_PK": ["OpenKnowledge mengimpor sebuah keterampilan"],"DiFKSL": ["Menghitung berkas markdown"],"DiZ3pq": ["Pemilih ikon"],+ "DjNcDy": [+ "Bentuk title, description, resource, dan tags saat Anda menggunakannya. Tidak ada yang diperlukan; mendeklarasikan satu hanya menyematkan tipenya, jadi tags yang ditulis sebagai string yang dipisahkan koma akan ditandai."+ ],"DmkTrb": ["Tema ini tidak dapat dibuat. Coba lagi."],"Dnn2XG": ["Otomatis"],"DpjYd6": ["Lompat ke teks berjangkar"],@@ -1158,6 +1188,9 @@"GNkUvW": ["Dalam antrean — dikirim saat proses ini selesai"],"GQ3O42": ["Tempat Sampah"],"GQDSBN": ["Opsi tata letak"],+ "GROUfG": [+ "File .mdx apa pun. Formatnya hanya .md saja, sehingga pembaca yang memindai .md tidak akan pernah membukanya — dan jika ada .md dengan nama yang sama, maka yang dibaca adalah yang tersebut."+ ],"GSYWCm": ["Sembunyikan panel dokumen"],"GUYwCr": ["Tutup pemberitahuan"],"GUZHkL": ["Warna palet tidak lengkap"],@@ -1325,6 +1358,7 @@"IxHMdF": ["Komentar itu tidak bisa dihapus."],"IxyZXD": ["Tangkapan layar"],"Izh19j": ["Membaca dari ", ["tail"]],+ "J0uRhj": ["Memeriksa keterampilan"],"J1XRO3": ["Warna tema"],"J2Mv98": ["Nama (mis. ", ["login"], ")"],"J2_JuX": ["tidak apa pun (", ["0"], " tidak bisa cocok dengan sebuah dokumen)"],@@ -1347,6 +1381,7 @@"JHf6qZ": ["[email protected]"],"JJcBCm": [["0"], " total"],"JK-Ave": ["Sembunyikan gambar mini"],+ "JKXcOi": ["Sudah dalam proyek"],"JL3si7": ["Memperbarui"],"JLUTgi": ["Belum ada tag — tulis `#namatag` di dokumen mana pun untuk mengisi indeksnya."],"JLzQi_": ["Tutup ", ["accessibleLabel"]],@@ -1444,6 +1479,9 @@"L-rMC9": ["Setel ulang ke bawaan"],"L1BQTH": [["0"], " belum terpasang — membuka halaman unduhannya."],"L1ZE3M": ["Statistik dokumen"],+ "L3BcJ4": [+ "Yang ini perlu melihat file Anda, bukan hanya dokumen yang terbuka, sehingga muncul saat Anda menjalankan audit proyek, bukan saat Anda mengetik."+ ],"L3CEC1": ["item ini"],"L3w0_C": ["Tampilkan dokumen sebagai dek slide di jendela tersendiri. Tambahkan <0>slides: true</0> ke frontmatter dokumen, lalu buka dengan aksi Slidev. Perenderan ditangani oleh CLI Slidev, yang tidak disertakan OpenKnowledge."@@ -1902,6 +1940,12 @@"R6ABfU": ["Bekerja langsung, tanpa tahap perencanaan"],"R9IDFz": ["Mengganti nama folder di disk dan id yang dipakai agen untuk memanggilnya."],"R9dK63": ["Contoh gambar"],+ "RB_g_C": [+ "Pada indeks root, okf_version ditulis sebagai string yang dikutip seperti \"0.2\". Tanpa tanda kutip, YAML membacanya sebagai angka dan 0.10 diam-diam menjadi 0.1."+ ],+ "RD6H9q": [+ "Open Knowledge menulis ulang file index.md ini seiring perubahan dokumen, sehingga pengeditan manual pada file tersebut diganti."+ ],"RDjuBN": ["Penyiapan"],"RDrXh4": ["Atur pengaturan pengguna, proyek, dan integrasi."],"RG3yW6": ["Masukkan nama untuk tema ini."],@@ -1970,6 +2014,9 @@"SF9qpO": ["Bagikan surel Anda untuk tindak lanjut"],"SFEWV6": ["Keterampilan OpenKnowledge tidak dapat dimuat. Coba lagi."],"SFN6dN": ["Judul 3"],+ "SIPelo": [+ "Pemeliharaan indeks dihentikan sementara karena Open Knowledge tidak dapat mengonfirmasi aturan penggabungan Git yang diperlukan. Centang Git dan .gitattributes, lalu coba lagi."+ ],"SInSnF": ["Referensi <0>", ["0"], "</0>"],"SItQRc": ["Bagaimana pendapat Anda tentang OpenKnowledge?"],"SOPwPh": ["Pulihkan hingga suntingan ini"],@@ -2295,6 +2342,7 @@"X7u0xR": [["0"], " templat tersedia"],"X8kjQX": ["Autentikasi ulang dengan GitHub"],"X9VpsP": ["Memuat isi folder"],+ "XAnapw": ["Git aturan penggabungan"],"XAyxsa": ["Ambil cabang remote"],"XBBZnv": ["Target tautan \"", ["shown"], "\" tidak merujuk ke dokumen yang ada."],"XBgr2S": ["Salin ke sini"],@@ -2412,6 +2460,9 @@"Y_iImT": ["File ", ["identity"], " tidak dapat ditentukan. Buka referensi."],"Y_kL7X": ["Sesuaikan tampilan dan perilaku penyunting."],"Ya3PlJ": ["Perlu izin"],+ "YaVU2F": [+ "Dalam proyek Git, Open Knowledge juga menambahkan aturan cakupan .gitattributes sehingga perubahan indeks secara bersamaan digabungkan sebelum pembangunan kembali berikutnya."+ ],"YaeyFh": ["Pull bisa menimpa suntingan yang belum di-commit di berkas lokal Anda."],"Yb82LN": ["ID: ", ["0"]],"Yea-K5": ["Pulihkan hingga titik ini"],@@ -2531,6 +2582,7 @@"_Bix3-": ["Kemunculan ", ["localizedFirstMessage"]],"_DwR-n": ["Membuat…"],"_FLBbi": [["sizeText"], " · rahasia disunting · crash dump tidak disunting"],+ "_G7A92": ["Pertahankan index.md"],"_GRWOJ": ["Ganti penyedia embedding?"],"_HgF9q": ["Urutkan menurut"],"_IGfXZ": ["OpenKnowledge berhenti tak terduga terakhir kali."],@@ -2617,10 +2669,12 @@"Tidak bisa terhubung ke layanan agen. Pastikan server OpenKnowledge berjalan dan mutakhir (mulai ulang jika sudah berjalan), lalu coba lagi."],"aalx4E": ["Menyunting sumber MDX yang rusak: ", ["reason"]],+ "aatPoi": ["File yang dihasilkan"],"abiHje": ["Hapus item terpilih"],"adsMWO": ["Menyelesaikan delta"],"ah_ekO": ["\"", ["name"], "\" sudah yang terbaru"],"aiArms": ["Kami tidak bisa mengkloning repositori ini."],+ "aiOceC": ["Aktifkan indeks"],"ajHi4O": ["Sinkronisasi otomatis dijeda — Anda tidak punya izin push ke repo ini. Beralih ke Ikuti agar tetap menerima pembaruan."],@@ -2767,11 +2821,13 @@],"cb-0G0": ["Hapus warna"],"ccNps_": ["Hanya yang diubah"],+ "cd3THN": ["Struktur dokumen"],"cd5EXh": ["Laporkan bug"],"cdm00A": ["Tidak Ada Masuk"],"cdmk8A": ["Perubahan yang belum di-commit"],"cgl-gn": ["Terhubung ke GitHub"],"chL5IG": ["Komunitas"],+ "ciozf1": ["Keterampilan sudah ada dalam proyek"],"cjtjry": ["Menyusuri riwayat navigasi OpenKnowledge ke belakang."],"cklVjM": ["Lini masa"],"clJ3qM": ["Selesai."],@@ -2952,6 +3008,7 @@"fbdLmk": ["Menyalakan atau mematikan format tebal."],"fbsiBw": ["Ada yang tidak beres saat memulai terminal."],"fcgvCA": ["Claude"],+ "fdKQAE": ["Mematikannya"],"fdeFfN": ["(berkas biner, tidak bisa dipratinjau)"],"fevEu0": ["Tarik perubahan terbaru"],"ffH3Rt": ["Tambah Komentar (Enter)"],@@ -3026,12 +3083,16 @@"gUx34c": ["Bahasa yang digunakan OpenKnowledge; Sistem mengikuti sistem operasi Anda. Catatan Anda sendiri tetap dalam bahasa saat Anda menulisnya."],+ "gVMkEr": [+ "Dalam dokumen log: judul entri diawali dengan tanggal ISO YYYY-MM-DD, terbaru terlebih dahulu. Berapa banyak title yang Anda gunakan, dan apakah entri merupakan poin, terserah Anda."+ ],"gY7wnY": ["Sedang masuk ke ", ["agentName"], "…"],"gYz2ep": ["Kedaluwarsa dalam ", ["timeLabel"]],"gZElfU": ["Memperbaiki ", ["0"], " dari ", ["1"], " berkas"],"gZiT5e": ["Ganti symlink-symlink ini dengan salinan mandiri?"],"gayL_Q": ["Rencana rilis"],"gbHcbI": ["Gagal menghapus properti"],+ "gfYI3o": ["Nonaktifkan ", ["id"]],"gfb-CM": ["Cabang tidak dapat diambil — masuk ke GitHub lalu coba lagi."],"gfdqcY": ["Perubahannya tidak bisa diterapkan: ", ["0"]],"gfohmY": ["Hubungkan alat"],@@ -3092,6 +3153,9 @@"hLKfZe": ["Pakai token saja"],"hLod4_": ["Ubah menjadi templat"],"hLy8b1": ["Diperbarui ke Versi ", ["version"]],+ "hPQBsa": [+ "File yang dicadangkan diberi nama index.md dan log.md dalam huruf kecil. Pada sistem file peka huruf besar-kecil, Index.md dibaca sebagai dokumen biasa dan kehilangan maknanya."+ ],"hQXiDc": ["Cari cabang..."],"hQjvzi": ["Arsip .zip atau .skill."],"hS0wC4": ["OpenKnowledge memulihkan versi sebelumnya dari ", ["subject"]],@@ -3240,6 +3304,9 @@"iz1LdD": ["Diubah di luar OK sejak terakhir kali OK menulis di sini — keadaan yang ditampilkan adalah apa yang ada di disk sekarang"],+ "j-o6Z2": [+ "Pemeliharaan indeks tidak dilakukan karena pengaturan proyek tidak dapat disimpan. Periksa izin file proyek, lalu coba lagi."+ ],"j15ZSH": ["Kirim komentar ke"],"j2229h": ["Menghapus berkas OpenKnowledge…"],"j2kt1j": [@@ -3327,6 +3394,7 @@"k4CuuV": ["Folder dan templat siap pakai agar Anda cepat memulai. Pilih sebuah paket untuk melihat apa yang akan dibuat, lalu tambahkan ke proyek Anda."],+ "k5rKNs": ["frontmatter"],"k7Hoig": ["Tidak ada perubahan isi pada versi ini."],"k8xtrB": ["Tidak diperlukan untuk endpoint localhost seperti <0>",@@ -3366,7 +3434,9 @@"kV2YZv": ["Tidak melihat <0>Keterampilan</0>? Aktifkan dulu <1>Pengaturan <2/> Kemampuan <3/> Eksekusi kode dan pembuatan berkas</1>."],+ "kVS5tE": ["Pertahankan indeks generated di setiap folder?"],"kVgQUA": ["Hapus obrolan ini?"],+ "kVzuTI": ["Keterampilan agen yang direkomendasikan"],"kYL1lH": ["Aktivitas agen"],"k_Dqw1": [["0", "plural", { "other": ["Tidak ada masalah di ", "#", " dokumen."] }]],"k_pade": [@@ -3458,7 +3528,9 @@"lWNpNB": ["Menambahkan kursor atau memilih kemunculan yang cocok lewat CodeMirror."],"lXKZGw": ["Judul 1"],"lY27jj": [["0"], " thn lalu"],+ "lY7Unt": ["Mengaktifkan pembuatan indeks"],"lZAiSP": ["Respons tautan balik tidak sesuai bentuk yang diharapkan."],+ "lZoQdy": ["Keterampilan terbuka"],"lZvQrY": ["Pakai ", ["0"], " sebagai tema gelap"],"l_6JHD": ["Cari ikon..."],"l_FAT6": ["Pakai hanya huruf, angka, <0>-</0>, atau <1>_</1>."],@@ -3478,6 +3550,7 @@"ljHjfg": ["Cabang itu sudah terbuka di worktree lain."],"lkYioO": ["Tampilkan atau sembunyikan panel dokumen"],"ll2yNl": ["Direktori konten"],+ "llXHHh": [["pluginCount", "plural", { "other": ["plugin"] }]],"lmBPt0": ["Hanya tautan eksternal yang memicu permintaan. Tautan ke dokumen lain di proyek ini dipratinjau dari indeks lokal dan tidak pernah keluar dari komputer Anda."],@@ -3546,6 +3619,9 @@}]],+ "mhnCt3": [+ "Setiap dokumen konsep memiliki tipe yang tidak kosong. Ini adalah keseluruhan batas kesesuaian OKF — dokumen yang hanya memiliki satu jenis sudah sepenuhnya sesuai."+ ],"mk2poV": ["mis. server.ts"],"mlvM8g": ["Komentar itu tidak bisa ditempatkan ulang."],"mmpzAq": ["Membungkus baris panjang di penyunting sumber markdown."],@@ -3804,6 +3880,9 @@"qRZh7J": ["Biarkan Tab keluar dari penyunting sumber alih-alih menambah indentasi."],"qSKu2v": ["Navigasi dan pemilihan di sumber"],"qSxaOz": ["Terima penghapusan mereka"],+ "qTT48-": [+ "Tautan wiki seperti [[Page]] — cara yang didukung untuk membuat tautan di sini, tetapi pembaca eksternal tidak menyelesaikan apa pun dan memperlihatkan tanda kurung."+ ],"qTcVwj": ["Telusuri atau unggah sebuah keterampilan untuk proyek ini."],"qTcZZu": ["Gagal memuat tag. Tekan <0>Esc</0> lalu buka lagi untuk mencoba ulang."],"qX-ABr": ["Atau, untuk memakai proses masuk lewat peramban:"],@@ -3845,6 +3924,7 @@"r51jLC": ["Berkas tersimpan & aplikasi Claude Desktop terbuka"],"r6ncaO": ["Tutup tab"],"r6y-jM": ["Peringatan"],+ "r7IaYp": ["Open Knowledge Format bimbingan"],"r871ed": ["Basis pengetahuan Anda kini ada di GitHub di <0>",["ownerLogin"],@@ -3874,6 +3954,9 @@"rZVMkf": ["Bidang penggantian penyunting visual sedang difokus"],"radOpL": ["Gambar ", ["identity"], ". Buka referensi."],"rageVb": ["HTML khusus dengan panel pratinjau langsung (iframe tersekat)."],+ "rarziH": [+ "Membantu agen pengkodean memilih jenis dokumen OKF, mempertahankan asal, dan menghindari penemuan metadata yang tidak didukung."+ ],"rbrHTd": ["Disetujui — ", ["optionName"]],"rcJmK8": ["Ubah lokasi menjadi salinan"],"rdU729": ["Tata letak"],@@ -3926,6 +4009,7 @@"sER-bs": ["Berkas"],"sFhaTJ": ["Membedakan templat yang namanya mirip di menu."],"sGZLfB": ["Gagal mengambil repositori"],+ "sHDllh": ["Berhenti mempertahankan index.md"],"sICrVf": ["Dipulihkan ke versi dari ", ["0"]],"sIGbBZ": ["Ubah pilihan menjadi catatan kaki"],"sIxSSP": ["Selesaikan konfliknya di terminal Anda"],@@ -3939,6 +4023,7 @@"sOxZaS": ["Gagal memuat graf"],"sQoLn0": ["Keluar"],"sR0I-f": ["Ciutkan semua berkas"],+ "sSRndh": ["Mulai pertahankan index.md"],"sW5OjU": ["wajib"],"sZ2IOu": [["targetNoun"],@@ -3952,6 +4037,9 @@"saIASg": ["Item kedua"],"saYiIO": ["Jalur tidak boleh memuat bita null"],"scu3wk": ["Model"],+ "scyoP9": [+ "Dokumen indeks tidak membawa frontmatter, kecuali dokumen yang ada di akar basis pengetahuan Anda. Dokumen log tidak tercakup — OKF tidak membatasi frontmatter mereka."+ ],"se-tU0": ["Tidak dapat memperbaiki ", ["0"], " dari ", ["total"], " berkas."],"seeS6l": ["Siapkan OpenKnowledge di folder ini?"],"sgmRY8": ["Unduhan ", ["0"], " dilewati."],@@ -4004,6 +4092,9 @@"tHKQ6j": ["Mengganti nama"],"tKlWWY": ["Emoji"],"tLX6LY": ["OpenKnowledge menulis sebuah dokumen"],+ "tM5uzl": [+ "Keluarga asal, kepercayaan, dan siklus hidup: sources, generated, verified, status, dan stale_after. Setiap bidang bersifat opsional, dan ketidakhadiran tidak pernah merupakan kesalahan."+ ],"tN5WTS": ["Penyedianya menolak permintaannya. Periksa kunci API dan id modelnya."],"tP5DDk": ["Terapkan tautan"],"tUvUfp": ["Pakai folder yang sudah Anda punya."],@@ -4066,6 +4157,9 @@"uGaIIS": ["Ambil worktree"],"uH_S-u": [["loadErrorTitle"], ": ", ["message"]],"uJfwF8": ["Sudah terpasang — tidak ada yang baru untuk diimpor."],+ "uK2peg": [+ "Periksa proyek Anda terhadap Open Knowledge Format. Matikan kapan saja di Pengaturan."+ ],"uKRYiW": ["Status sinkronisasi tidak tersedia — galat server."],"uL_Wx8": ["Terminal berhenti tak terduga."],"uM6jnS": ["Gagal memulihkan"],@@ -4111,6 +4205,9 @@"uyOQ4e": ["Tema disalin sebagai YAML base16"],"uynXup": [["tokens", "plural", { "other": ["token"] }]],"v-h2hx": ["Hapus ", ["targetGitPath"]],+ "v15iQB": [+ "Kontrak perhitungan yang dibuktikan. Hanya berlaku untuk dokumen yang diketik Attested Computation, dimana OKF memerlukan runtime; konsep biasa tidak terpengaruh."+ ],"v2ZW0K": ["Aktifkan terminal"],"v2a04T": ["Aturan markdownlint"],"v41fCm": ["Berkas tidak ditemukan"],diff --git a/packages/app/src/locales/id/messages.po b/packages/app/src/locales/id/messages.poindex 4fdb23bf2..d3fcef2f5 100644--- a/packages/app/src/locales/id/messages.po+++ b/packages/app/src/locales/id/messages.po@@ -263,6 +263,11 @@ msgstr "{0, plural, other {Saat ini cocok dengan {3} dari {4} dokumen.}}"msgid "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"msgstr "{0, plural, other {Tidak ada masalah di # dokumen.}}"+#. placeholder {0}: pluginRows.length+#: src/components/CreatedItemsList.tsx+msgid "{0, plural, one {Plugin} other {Plugins}}"+msgstr "{0, plural, other {Plugin}}"+#. placeholder {0}: editorList.hiddenCount#: src/components/McpConsentDialogBody.tsxmsgid "{0, plural, one {Show # more tool} other {Show # more tools}}"@@ -629,7 +634,9 @@ msgstr "CLI {displayName}, {hint}"msgid "{docName} is {0}. OpenKnowledge currently opens files up to {1}."msgstr "{docName} berukuran {0}. Saat ini OpenKnowledge membuka berkas hingga {1}."+#. placeholder {0}: OKF_RULE_IDS.length#. placeholder {0}: entries.length+#: src/components/settings/LintingSection.tsx#: src/components/settings/markdownlint-rule-browser.tsxmsgid "{enabledCount}/{0} on"msgstr "{enabledCount}/{0} aktif"@@ -792,6 +799,10 @@ msgstr "{percent}% terpakai (sisa {left}%)"msgid "{phase} — {pct}%"msgstr "{phase} — {pct}%"+#: src/components/CreatedItemsList.tsx+msgid "{pluginCount, plural, one {plugin} other {plugins}}"+msgstr "{pluginCount, plural, other {plugin}}"+#: src/components/PropertyDisclosure.tsxmsgid "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"msgstr "{problemCount, plural, other {# properti tidak sesuai skema}}"@@ -1543,6 +1554,10 @@ msgstr "Sudah tercakup oleh folder induk yang dipilih"msgid "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."msgstr "Sudah punya repositori git? Tambahkan dengan <0>git remote add origin <url></0> di folder proyek ini. Halaman ini diperbarui otomatis begitu sebuah remote terdeteksi."+#: src/components/settings/LintingSection.tsx+msgid "Already in project"+msgstr "Sudah dalam proyek"+#: src/components/SkillPluginBundleDialog.tsxmsgid "Already installed — nothing new to import."msgstr "Sudah terpasang — tidak ada yang baru untuk diimpor."@@ -1588,6 +1603,10 @@ msgstr "Operasi sinkronisasi lain sedang berjalan. Coba lagi sebentar."msgid "any"msgstr "apa saja"+#: src/components/settings/LintingSection.tsx+msgid "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+msgstr "File .mdx apa pun. Formatnya hanya .md saja, sehingga pembaca yang memindai .md tidak akan pernah membukanya — dan jika ada .md dengan nama yang sama, maka yang dibaca adalah yang tersebut."+#. placeholder {0}: summary.name#: src/components/settings/LintingSection.tsxmsgid "any doc named {0}"@@ -2148,6 +2167,7 @@ msgstr "Tidak dapat membagikan jalur ini."#: src/components/ReportBugDialogBody.tsx#: src/components/SeedDialog.tsx#: src/components/settings/LinkPreviewsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/SavedThemesTiles.tsx#: src/components/settings/SearchSection.tsx#: src/components/ShareBranchSwitchDialog.tsx@@ -2288,6 +2308,10 @@ msgstr "Mengambil berkas"msgid "Checking sign-in status"msgstr "Memeriksa status masuk"+#: src/components/settings/LintingSection.tsx+msgid "Checking skill"+msgstr "Memeriksa keterampilan"+#: src/components/ImportSkillForm.tsxmsgid "Checking source"msgstr "Memeriksa sumber"@@ -2304,6 +2328,10 @@ msgstr "Memeriksa..."msgid "Checklist with checkboxes."msgstr "Daftar periksa dengan kotak centang."+#: src/components/CreatedItemsList.tsx+msgid "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+msgstr "Periksa proyek Anda terhadap Open Knowledge Format. Matikan kapan saja di Pengaturan."+#: src/components/ImportSkillForm.tsxmsgid "Choose a skill archive"msgstr "Pilih arsip keterampilan"@@ -4300,6 +4328,10 @@ msgstr "Nonaktifkan {0}"msgid "Disable {file}"msgstr "Nonaktifkan {file}"+#: src/components/settings/LintingSection.tsx+msgid "Disable {id}"+msgstr "Nonaktifkan {id}"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "Disable external link previews"msgstr "Nonaktifkan pratinjau tautan eksternal"@@ -4402,6 +4434,10 @@ msgstr "Panel dokumen"msgid "Document statistics"msgstr "Statistik dokumen"+#: src/components/settings/LintingSection.tsx+msgid "Document structure"+msgstr "Struktur dokumen"+#: src/components/empty-state/use-create-suggestions.tsmsgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."msgstr "Dokumentasikan arsitektur repo ini: buat halaman ikhtisar yang menaut ke satu halaman per modul utama yang menjelaskan tanggung jawab dan titik masuknya."@@ -4793,6 +4829,10 @@ msgstr "Aktifkan CLI {displayName}"msgid "Enable {file}"msgstr "Aktifkan {file}"+#: src/components/settings/LintingSection.tsx+msgid "Enable {id}"+msgstr "Aktifkan {id}"+#: src/components/AutoSyncOnboardingDialog.tsx#: src/components/EnableSyncConfirmDialog.tsx#: src/components/share-receive-miss-content.tsx@@ -4817,6 +4857,10 @@ msgstr "Aktifkan Ikuti?"msgid "Enable git auto-sync?"msgstr "Aktifkan sinkronisasi otomatis git?"+#: src/components/settings/LintingSection.tsx+msgid "Enable indexes"+msgstr "Aktifkan indeks"+#: src/components/ProblemsPanel.tsxmsgid "Enable plugins"msgstr "Aktifkan plugin"@@ -4845,6 +4889,10 @@ msgstr "Aktifkan terminal untuk proyek ini"msgid "Enable Themes"msgstr "Aktifkan Tema"+#: src/components/settings/LintingSection.tsx+msgid "Enabling index generation"+msgstr "Mengaktifkan pembuatan indeks"+#: src/components/ActivityModeContent.tsxmsgid "Ended"msgstr "Berakhir"@@ -4915,6 +4963,10 @@ msgstr "Galat:"msgid "Escape"msgstr "Escape"+#: src/components/settings/LintingSection.tsx+msgid "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+msgstr "Setiap dokumen konsep memiliki tipe yang tidak kosong. Ini adalah keseluruhan batas kesesuaian OKF — dokumen yang hanya memiliki satu jenis sudah sepenuhnya sesuai."+#: src/components/settings/LintingSection.tsxmsgid "every doc"msgstr "semua dokumen"@@ -5690,6 +5742,10 @@ msgstr "Dari templat"msgid "From the {0} plugin"msgstr "Dari plugin {0}"+#: src/components/settings/LintingSection.tsx+msgid "Frontmatter"+msgstr "frontmatter"+#: src/components/TemplateForm.tsxmsgid "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."msgstr "Frontmatter yang mengawali setiap dokumen yang dibuat dari templat ini. Nilainya berupa YAML — daftar ditulis <0>[a, b]</0>; <1>{{date}}</1> terisi saat pembuatan."@@ -5732,6 +5788,10 @@ msgstr "Permainan berakhir · tekan spasi untuk main lagi"msgid "General"msgstr "Umum"+#: src/components/settings/LintingSection.tsx+msgid "Generated files"+msgstr "File yang dihasilkan"+#: src/components/TerminalCliMissingBanner.tsxmsgid "Get {displayName}"msgstr "Dapatkan {displayName}"@@ -5765,6 +5825,10 @@ msgstr "konfigurasi git tidak tersedia"msgid "Git identity isn't set — commits use a default author. Set yours so teammates see your name."msgstr "Identitas git belum disetel — commit memakai penulis bawaan. Setel milik Anda agar rekan tim melihat nama Anda."+#: src/components/settings/LintingSection.tsx+msgid "Git merge rule"+msgstr "Git aturan penggabungan"+#: src/components/ShareBranchSwitchDialog.tsxmsgid "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."msgstr "Git membutuhkan {tool} untuk repositori ini, tetapi ia belum terpasang atau tidak ditemukan. Pasang dulu, lalu coba lagi."@@ -5919,7 +5983,7 @@ msgstr "slug-judul"msgid "Headings"msgstr "Judul"-#: src/components/AutoSyncEnableWarning.tsx+#: src/components/DisclosureWarning.tsx#: src/editor/slash-command/component-items.tsxmsgid "Heads up"msgstr "Perhatian"@@ -5941,6 +6005,10 @@ msgstr "Halo, dunia!"msgid "Help"msgstr "Bantuan"+#: src/components/settings/LintingSection.tsx+msgid "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+msgstr "Membantu agen pengkodean memilih jenis dokumen OKF, mempertahankan asal, dan menghindari penemuan metadata yang tidak didukung."+#. Subtext for the open-knowledge-discovery skill row#. Subtext for the open-knowledge-discovery skill row#: src/components/McpConsentDialogBody.tsx@@ -6273,10 +6341,18 @@ msgstr "Diimpor sebagai \"{0}\" — nama \"{1}\" sudah dipakai."msgid "Importing"msgstr "Mengimpor"+#: src/components/settings/LintingSection.tsx+msgid "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+msgstr "Dalam dokumen log: judul entri diawali dengan tanggal ISO YYYY-MM-DD, terbaru terlebih dahulu. Berapa banyak title yang Anda gunakan, dan apakah entri merupakan poin, terserah Anda."+#: src/components/SeedDialog.tsxmsgid "In a subfolder"msgstr "Di subfolder"+#: src/components/settings/LintingSection.tsx+msgid "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+msgstr "Dalam dokumen indeks: entri berada di bawah judul bagian dan masing-masing membawa tautan. Prosa seputar daftar itu baik-baik saja."+#: src/components/empty-state/CreatePromptComposer.tsx#: src/components/handoff/AgentSplitButton.tsx#: src/components/handoff/OpenInAgentContextSubmenu.tsx@@ -6295,6 +6371,14 @@ msgstr "Di aplikasi"msgid "In app (beta)"msgstr "Di aplikasi (beta)"+#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+msgstr "Dalam proyek Git, Open Knowledge menambahkan aturan tercakup ke file .gitattributes di root repositori agar perubahan indeks yang bersamaan dapat digabungkan."++#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+msgstr "Dalam proyek Git, Open Knowledge juga menambahkan aturan cakupan .gitattributes sehingga perubahan indeks secara bersamaan digabungkan sebelum pembangunan kembali berikutnya."+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "In the Claude Desktop App"msgstr "Di aplikasi Claude Desktop"@@ -6319,6 +6403,26 @@ msgstr "Menambah atau mengurangi indentasi item daftar saat ini."msgid "Indented blockquote for citations."msgstr "Kutipan blok berindentasi untuk mengutip sumber."+#: src/components/settings/LintingSection.tsx+msgid "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+msgstr "Dokumen indeks tidak membawa frontmatter, kecuali dokumen yang ada di akar basis pengetahuan Anda. Dokumen log tidak tercakup — OKF tidak membatasi frontmatter mereka."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+msgstr "Pemeliharaan indeks dihentikan sementara karena atribut Git lainnya mengontrol index.md. Perbarui .gitattributes sehingga jalur index.md yang dicakup menggunakan merge=union, lalu coba lagi."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+msgstr "Pemeliharaan indeks dihentikan sementara karena Open Knowledge tidak dapat mengonfirmasi aturan penggabungan Git yang diperlukan. Centang Git dan .gitattributes, lalu coba lagi."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+msgstr "Pemeliharaan indeks terhenti karena Open Knowledge tidak dapat menjangkau server proyek. Coba lagi saat proyek tersambung kembali."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+msgstr "Pemeliharaan indeks tidak dilakukan karena pengaturan proyek tidak dapat disimpan. Periksa izin file proyek, lalu coba lagi."+#: src/components/settings/SearchSection.tsxmsgid "Indexed {embedded} of {total} pages."msgstr "{embedded} dari {total} halaman terindeks."@@ -6507,6 +6611,10 @@ msgstr "Pasang di semua agen"msgid "Install selected"msgstr "Pasang yang dipilih"+#: src/components/settings/LintingSection.tsx+msgid "Install skill"+msgstr "Instal keterampilan"+#: src/components/SkillPluginBundleBanner.tsxmsgid "Install skills"msgstr "Pasang keterampilan"@@ -6516,6 +6624,7 @@ msgid "Install the gh CLI"msgstr "Pasang CLI gh"#: src/components/settings/AiToolsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ProjectAiToolsSection.tsx#: src/components/SkillEditorActions.tsxmsgid "Installed"@@ -6729,6 +6838,10 @@ msgstr "Jaga proyek ini tetap selaras dengan remote git Anda. Ikuti mengambil pemsgid "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."msgstr "Catat orang dan perusahaan yang bekerja dengan Anda serta pertemuan yang Anda adakan dengan mereka. Cocok untuk mengingat siapa seseorang, dari mana Anda mengenalnya, dan apa yang terakhir Anda bicarakan."+#: src/components/settings/LintingSection.tsx+msgid "Keeps your knowledge base aligned with the Open Knowledge Format."+msgstr "Menjaga basis pengetahuan Anda tetap selaras dengan Open Knowledge Format."+#. placeholder {0}: toName.trim()#: src/components/SkillForkDialog.tsxmsgid "Kept both — \"{0}\" is its own skill now"@@ -7104,6 +7217,14 @@ msgstr "Mencari <0>{lookingForUrl}</0>."msgid "Lost connection to \"{docName}\"."msgstr "Koneksi ke \"{docName}\" terputus."+#: src/components/settings/LintingSection.tsx+msgid "Maintain generated indexes in every folder?"+msgstr "Pertahankan indeks generated di setiap folder?"++#: src/components/settings/LintingSection.tsx+msgid "Maintain index.md"+msgstr "Pertahankan index.md"+#: src/components/SkillInstallMenu.tsxmsgid "make source"msgstr "jadikan sumber"@@ -8248,6 +8369,10 @@ msgstr "OK Desktop"msgid "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."msgstr "Terakhir kali OK menyetel folder ini menjadi {0} — sesuatu di luar OK mengubahnya sejak itu. Keadaan yang ditampilkan adalah apa yang ada di disk sekarang; Symlink/Lepas tautan Anda berikutnya yang menang."+#: src/components/settings/LintingSection.tsx+msgid "OKF agent skill installed"+msgstr "OKF keterampilan agen diinstal"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "On — hovering an external link sends its URL to the destination site to fetch a preview."msgstr "Aktif — mengarahkan kursor ke tautan eksternal mengirim URL-nya ke situs tujuan untuk mengambil pratinjau."@@ -8264,6 +8389,10 @@ msgstr "Pada <0>{address}</0>"msgid "On selected text in <0>{address}</0>"msgstr "Pada teks terpilih di <0>{address}</0>"+#: src/components/settings/LintingSection.tsx+msgid "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+msgstr "Pada indeks root, okf_version ditulis sebagai string yang dikutip seperti \"0.2\". Tanpa tanda kutip, YAML membacanya sebagai angka dan 0.10 diam-diam menjadi 0.1."+#. Next step for a Cursor project MCP row — Cursor leaves project servers disabled#: src/components/settings/ProjectAiToolsSection.tsxmsgid "One more step: enable it in Cursor → Settings → Tools & MCP (Cursor leaves project servers off until you turn them on)."@@ -8486,6 +8615,22 @@ msgstr "Buka di worktree"msgid "Open it there"msgstr "Buka di sana"+#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+msgstr "Open Knowledge membuat dan memelihara file navigasi bernama index.md di setiap folder yang berisi Markdown."++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge Format guidance"+msgstr "Open Knowledge Format bimbingan"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+msgstr "Open Knowledge menyimpan file navigasi bernama index.md di setiap folder yang berisi Markdown, masing-masing mencantumkan dokumen folder tersebut berdasarkan jenis dan tautan ke subfoldernya. Itu menulis ulang file-file ini saat dokumen Anda berubah, dan apa pun yang Anda edit sendiri ke dalamnya akan diganti."++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+msgstr "Open Knowledge menulis ulang file index.md ini seiring perubahan dokumen, sehingga pengeditan manual pada file tersebut diganti."+#. placeholder {0}: item.displayName#. placeholder {1}: item.displayName#. placeholder {2}: item.version@@ -8532,6 +8677,10 @@ msgstr "Buka pengaturan"msgid "Open shared {targetNoun}"msgstr "Buka {targetNoun} yang dibagikan"+#: src/components/settings/LintingSection.tsx+msgid "Open skill"+msgstr "Keterampilan terbuka"+#: src/editor/extensions/JsxComponentView.tsxmsgid "Open source doc: {mirrorSrc}"msgstr "Buka dokumen sumber: {mirrorSrc}"@@ -9368,6 +9517,7 @@ msgid "project"msgstr "proyek"#: src/components/CommandPalette.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ScopeBadge.tsx#: src/lib/skill-scope.tsmsgid "Project"@@ -9639,6 +9789,10 @@ msgstr "Proyek terbaru"msgid "Recently opened"msgstr "Baru saja dibuka"+#: src/components/settings/LintingSection.tsx+msgid "Recommended agent skill"+msgstr "Keterampilan agen yang direkomendasikan"+#: src/components/SyncStatusBadge.tsxmsgid "Reconnect required"msgstr "Perlu menyambung ulang"@@ -10076,6 +10230,10 @@ msgstr "Teliti kepunahan burung yang tidak bisa terbang"msgid "research-note"msgstr "catatan-riset"+#: src/components/settings/LintingSection.tsx+msgid "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+msgstr "File yang dicadangkan diberi nama index.md dan log.md dalam huruf kecil. Pada sistem file peka huruf besar-kecil, Index.md dibaca sebagai dokumen biasa dan kehilangan maknanya."+#: src/components/settings/CustomThemeEditor.tsxmsgid "Reset"msgstr "Setel ulang"@@ -10318,6 +10476,7 @@ msgid "Rule editing is available for the project's root markdownlint config"msgstr "Penyuntingan aturan tersedia untuk konfigurasi markdownlint di akar proyek"#: src/components/LintConfigEditor.tsx+#: src/components/settings/LintingSection.tsxmsgid "Rules"msgstr "Aturan"@@ -11260,6 +11419,10 @@ msgstr "Skill “{conflictName}” tidak dipasang untuk {conflictHosts} — di smsgid "Skill \"{name}\" created"msgstr "Keterampilan \"{name}\" dibuat"+#: src/components/settings/LintingSection.tsx+msgid "Skill already in project"+msgstr "Keterampilan sudah ada dalam proyek"+#: src/components/ExploreSkills.tsxmsgid "Skill discovery powered by <0>skills.sh</0>"msgstr "Penemuan keterampilan ditenagai <0>skills.sh</0>"@@ -11519,6 +11682,10 @@ msgstr "Mulai dari"msgid "Start here: what this is and how it's organized."msgstr "Mulai di sini: apa ini dan bagaimana penataannya."+#: src/components/settings/LintingSection.tsx+msgid "Start maintaining index.md"+msgstr "Mulai pertahankan index.md"+#: src/lib/keyboard-shortcuts.tsmsgid "Start source completion"msgstr "Mulai pelengkapan sumber"@@ -11614,6 +11781,10 @@ msgstr "Berhenti memperbaiki berkas"msgid "Stop fixing. Files already fixed stay fixed."msgstr "Berhenti memperbaiki. Berkas yang sudah diperbaiki tetap terperbaiki."+#: src/components/settings/LintingSection.tsx+msgid "Stop maintaining index.md"+msgstr "Berhenti mempertahankan index.md"+#: src/lib/project-fix-sweep-store.tsmsgid "Stopped fixing. Files already fixed stay fixed."msgstr "Perbaikan dihentikan. Berkas yang sudah diperbaiki tetap terperbaiki."@@ -12117,6 +12288,10 @@ msgstr "Agen tidak berhenti. Hentikan paksa menutup obrolan ini dan keluar darimsgid "The agent's persona, values, and voice."msgstr "Kepribadian, nilai, dan gaya bicara agen."+#: src/components/settings/LintingSection.tsx+msgid "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+msgstr "Kontrak perhitungan yang dibuktikan. Hanya berlaku untuk dokumen yang diketik Attested Computation, dimana OKF memerlukan runtime; konsep biasa tidak terpengaruh."+#: src/components/ProblemsPanel.tsxmsgid "The audit could not be completed. Try again."msgstr "Audit tidak dapat diselesaikan. Coba lagi."@@ -12175,6 +12350,10 @@ msgstr "Rumus <0>c = √(a² + b²)</0> dirender sebaris."msgid "the git exclude file isn't writable"msgstr "berkas exclude git tidak bisa ditulisi"+#: src/components/settings/LintingSection.tsx+msgid "The index files stay in place. Open Knowledge removes only the Git rule it added."+msgstr "File indeks tetap di tempatnya. Open Knowledge hanya menghapus aturan Git yang ditambahkannya."+#: src/lib/locale-load-failure-notice.tsmsgid "The interface is still in the language you were reading. Check your connection, then reload to try again."msgstr "Antarmuka masih dalam bahasa yang tadi Anda baca. Periksa koneksi Anda, lalu muat ulang untuk mencoba lagi."@@ -12211,6 +12390,10 @@ msgstr "Blok properti di bagian atas dokumen ini punya galat format. Beralihlahmsgid "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."msgstr "Properti berubah, tetapi tidak bisa dibandingkan — YAML gagal diurai. Kedua versi ditampilkan apa adanya."+#: src/components/settings/LintingSection.tsx+msgid "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+msgstr "Keluarga asal, kepercayaan, dan siklus hidup: sources, generated, verified, status, dan stale_after. Setiap bidang bersifat opsional, dan ketidakhadiran tidak pernah merupakan kesalahan."+#: src/components/settings/SearchSection.tsxmsgid "The provider is rate-limiting this key. Try again in a moment."msgstr "Penyedianya sedang membatasi laju kunci ini. Coba lagi sebentar."@@ -12248,6 +12431,10 @@ msgstr "Berkas skemanya tidak ada atau gagal dimuat — menambahkan sebuah bidanmsgid "the server responded but server.lock has no port yet"msgstr "server merespons tetapi server.lock belum memiliki port"+#: src/components/settings/LintingSection.tsx+msgid "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+msgstr "Bentuk title, description, resource, dan tags saat Anda menggunakannya. Tidak ada yang diperlukan; mendeklarasikan satu hanya menyematkan tipenya, jadi tags yang ditulis sebagai string yang dipisahkan koma akan ditandai."+#: src/components/SkillInstallMenu.tsxmsgid "The skill's own folder — the source other locations copy or link from"msgstr "Folder milik keterampilan itu sendiri — sumber tempat lokasi lain menyalin atau menaut"@@ -12561,6 +12748,10 @@ msgstr "Ini mungkin makan waktu sebentar. Konten markdown Anda dipertahankan."msgid "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."msgstr "Ini memindahkan <0>{name}</0> dari {0} ke {1}, memindahkan berkasnya di disk dan memasangnya ulang di penyunting Anda pada tingkat {2}."+#: src/components/settings/LintingSection.tsx+msgid "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+msgstr "Yang ini perlu melihat file Anda, bukan hanya dokumen yang terbuka, sehingga muncul saat Anda menjalankan audit proyek, bukan saat Anda mengetik."+#: src/components/SeedDialog.tsxmsgid "This pack is already set up here."msgstr "Paket ini sudah disiapkan di sini."@@ -12924,6 +13115,10 @@ msgstr "Mengubah {0} kembali menjadi direktori nyata yang memuat satu symlink pemsgid "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."msgstr "Mengubah {display} kembali menjadi direktori nyata yang memuat satu symlink per keterampilan untuk setiap keterampilan yang saat ini dilihatnya — tidak ada yang berhenti bekerja, dan sejak itu menu tiap keterampilan yang mengelolanya."+#: src/components/CreatedItemsList.tsx+msgid "Turn it off any time in Settings."+msgstr "Matikan kapan saja di Pengaturan."+#: src/components/NotInSidebarIndicator.tsxmsgid "Turn off Only markdown files"msgstr "Matikan Hanya berkas markdown"@@ -12949,6 +13144,10 @@ msgstr "Nyalakan pencarian semantik?"msgid "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."msgstr "Ubah apa yang Anda baca menjadi artikel yang jelas dan tepercaya. Simpan sebuah sumber, cari tahu maknanya, lalu simpan versi finalnya agar bisa Anda andalkan nanti."+#: src/components/settings/LintingSection.tsx+msgid "Turning it off"+msgstr "Mematikannya"+#: src/components/acp/working-status.tsmsgid "Turning it over…"msgstr "Membolak-balikkannya…"@@ -13639,6 +13838,10 @@ msgstr "Tautan wiki"msgid "Wiki link suggestions"msgstr "Saran tautan wiki"+#: src/components/settings/LintingSection.tsx+msgid "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+msgstr "Tautan wiki seperti [[Page]] — cara yang didukung untuk membuat tautan di sini, tetapi pembaca eksternal tidak menyelesaikan apa pun dan memperlihatkan tanda kurung."+#: src/components/PublishToGitHubDialog.tsxmsgid "Will be created as <0>{sanitizedName}</0>"msgstr "Akan dibuat sebagai <0>{sanitizedName}</0>"diff --git a/packages/app/src/locales/pseudo/messages.json b/packages/app/src/locales/pseudo/messages.jsonindex 7499c990f..239e9693c 100644--- a/packages/app/src/locales/pseudo/messages.json+++ b/packages/app/src/locales/pseudo/messages.json@@ -121,6 +121,9 @@"0ySP5u": ["Ćĥàńĝēś śàvē àũţōḿàţĩćàĺĺŷ ţō ţĥĩś ţĥēḿē."],"0zAhu6": ["ēvēŕŷ ďōć"],"10g8I_": ["Ţũŕń ōƒƒ Ōńĺŷ ḿàŕķďōŵń ƒĩĺēś"],+ "110eEb": [+ "Ōƥēń Ķńōŵĺēďĝē ćŕēàţēś àńď ḿàĩńţàĩńś à ńàvĩĝàţĩōń ƒĩĺē ńàḿēď ĩńďēx.ḿď ĩń ēvēŕŷ ƒōĺďēŕ ţĥàţ ćōńţàĩńś Ḿàŕķďōŵń."+ ],"11ukmX": ["Ŕēńàḿē ƒàĩĺēď: ", ["0"]],"12F9WL": ["(ńō ĩď)"],"151wvk": ["Śĥōŵ śĩďēƀàŕ"],@@ -138,6 +141,9 @@"1GhYxC": ["ōƒ ", ["totalPages"]],"1HBhDS": ["Ćĥēćķĩńĝ ōũţ ƒĩĺēś"],"1J0c0X": ["Śţĩĺĺ ćōũĺďń'ţ ŕēàćĥ ", ["displayName"], " — ţŕŷ ōńē ḿōŕē ţĩḿē?"],+ "1JpLgH": [+ "Ĩń àń ĩńďēx ďōćũḿēńţ: ēńţŕĩēś śĩţ ũńďēŕ à śēćţĩōń ĥēàďĩńĝ àńď ēàćĥ ōńē ćàŕŕĩēś à ĺĩńķ. Ƥŕōśē àŕōũńď ţĥē ĺĩśţś ĩś ƒĩńē."+ ],"1LtA5r": ["Śŷḿĺĩńķś ţĥē śķĩĺĺ ţō ", ["path"]],"1MGRQl": ["Ţēŕḿĩńàĺ śēśśĩōńś"],"1NgrlY": ["Ōţĥēŕ ŵàŷś ţō ĩńśţàĺĺ"],@@ -151,6 +157,7 @@"1XSMhZ": ["Śŵĩţćĥĩńĝ ţō <0>ĺōćàĺ-ōńĺŷ</0> ŵĩĺĺ ŕēƒũśē ũńţĩĺ ţĥēŷ'ŕē ũńţŕàćķēď vĩà<1> ĝĩţ ŕḿ --ćàćĥēď</1>."],+ "1ZXkqM": ["Ţũŕń ĩţ ōƒƒ àńŷ ţĩḿē ĩń Śēţţĩńĝś."],"1ZpfyB": ["Ōƥēń ŵĩţĥ ÀĨ ", ["displayName"], ", ", ["hint"]],"1a6ICf": ["Ƒōĺĺōŵĩńĝ ţĥē àĝēńţ'ś ēďĩţś"],"1bDVu5": ["Ŵōŕķśƥàćē Ćōḿḿàńď Ƥàĺēţţē"],@@ -290,6 +297,8 @@"3o3tur": ["Śţàŕţēŕ ćōńţēńţ"],"3oh0nQ": ["Ńēśţēď .ōķĩĝńōŕē ēŕŕōŕ ĩń ", ["path"]],"3pU8e-": ["Ƥĩń ţàƀ"],+ "3qDsdf": ["Ĩńśţàĺĺ śķĩĺĺ"],+ "3ri_4O": ["Ķēēƥś ŷōũŕ ķńōŵĺēďĝē ƀàśē àĺĩĝńēď ŵĩţĥ ţĥē Ōƥēń Ķńōŵĺēďĝē Ƒōŕḿàţ."],"3s-k7L": [["0",@@ -429,6 +438,9 @@],"5tcmwY": ["Àďď vàĺũē"],"5vAI6Z": ["Ĩţ ďĩďń'ţ ƒĩţ ĩńţō ḿŷ ŵōŕķƒĺōŵ"],+ "5w38tn": [+ "Ĩńďēx ḿàĩńţēńàńćē śţàŷēď ōƒƒ ƀēćàũśē Ōƥēń Ķńōŵĺēďĝē ćōũĺď ńōţ ŕēàćĥ ţĥē ƥŕōĴēćţ śēŕvēŕ. Ţŕŷ àĝàĩń ŵĥēń ţĥē ƥŕōĴēćţ ŕēćōńńēćţś."+ ],"5wV2qQ": ["àńď ḿōŕē"],"5y_9lO": ["Ŵàĩţĩńĝ ƒōŕ àũţĥōŕĩźàţĩōń"],"6-wLTJ": [["behind"], " ƀēĥĩńď ōŕĩĝĩń"],@@ -565,6 +577,7 @@"7d1a0d": ["Ƥũƀĺĩć"],"7dZnmw": ["Ŕēĺēvàńćē"],"7hctf2": ["Ďēśćŕĩƀē ţĥē ƥŕōĴēćţ ŷōũ ŵàńţ ţō ćŕēàţē"],+ "7idx48": ["ŌĶƑ àĝēńţ śķĩĺĺ ĩńśţàĺĺēď"],"7jIIFX": ["Ŷōũ'ŕē àĺĺ śēţ ũƥ!"],"7kb4LU": ["Àƥƥŕōvēď"],"7l15X4": ["ƒàĩĺēď"],@@ -572,6 +585,7 @@"7m3Ade": ["ĩńśţàĺĺś:"],"7qRHf0": ["Ĩńśţàĺĺ ƒōŕ Ćĺàũďē Ćĥàţ & Ćōŵōŕķ"],"7uBlRT": ["Ćōƥŷ ţĥē ƒōćũśēď ƒĩĺē-ţŕēē ĩţēḿ śō Ƥàśţē ćàń ďũƥĺĩćàţē ĩţ."],+ "7wogIQ": [["0", "plural", { "one": ["Ƥĺũĝĩń"], "other": ["Ƥĺũĝĩńś"] }]],"80c4-P": ["Ćōďē ćōƥĩēď ţō ćĺĩƥƀōàŕď"],"81H_23": ["Àďď ƥŕōƥēŕţĩēś"],"851WA-": ["Ţĥĩś ćàń ƀē ćōńƒĩĝũŕēď ĩń Śēţţĩńĝś > ÀĨ ţōōĺś & ĆĹĨ"],@@ -631,6 +645,7 @@"8nWu1k": ["Ēḿƥţŷ ďĩàĝŕàḿ"],"8oWgty": ["Ḿàŕķ ēvēŕŷ ćōḿḿēńţ ţō śēńď"],"8qgfac": ["ḾĆƤ śēŕvēŕś"],+ "8rZ1pk": ["Ēńàƀĺē ", ["id"]],"8ruqQi": ["ßŕōķēń ĩńţēŕńàĺ ĺĩńķś"],"8sMErm": ["Ēńàƀĺē Ƒōĺĺōŵ?"],"8t9CRE": ["Śţàŕţĩńĝ ", ["agentName"], "…"],@@ -814,6 +829,9 @@"BQKHuL": ["Ŕēśţàŕţ ţēŕḿĩńàĺ"],"BQu9Pg": ["Śŷḿĺĩńķ"],"BUyQnq": ["Ćōũĺďń'ţ ŕēśţàŕţ ţĥē śēŕvēŕ. Ţŕŷ `ōķ śţàŕţ` ĩń ţĥĩś ƒōĺďēŕ."],+ "BVkqD9": [+ "Ĩńďēx ḿàĩńţēńàńćē ĩś ƥàũśēď ƀēćàũśē àńōţĥēŕ Ĝĩţ àţţŕĩƀũţē ćōńţŕōĺś ĩńďēx.ḿď. Ũƥďàţē .ĝĩţàţţŕĩƀũţēś śō ţĥē śćōƥēď ĩńďēx.ḿď ƥàţĥś ũśē ḿēŕĝē=ũńĩōń, ţĥēń ţŕŷ àĝàĩń."+ ],"BY-g4_": ["Àďď ƥàţţēŕń"],"Ba4D2x": ["Ţēḿƥĺàţē ĩḿƥōŕţēď"],"Bdha5y": ["Ƥũƀĺĩśĥĩńĝ..."],@@ -832,6 +850,7 @@"Bv5a9_": ["Śēĺēćţĩōń śţàţĩśţĩćś"],"Bx4EXG": ["Àćţĩōńś ƒōŕ ", ["label"]],"By-7Pn": ["Ţōĝĝĺē à ƀũĺĺēţ ĺĩśţ."],+ "ByIOcK": ["Ţĥē ĩńďēx ƒĩĺēś śţàŷ ĩń ƥĺàćē. Ōƥēń Ķńōŵĺēďĝē ŕēḿōvēś ōńĺŷ ţĥē Ĝĩţ ŕũĺē ĩţ àďďēď."],"BymzO4": ["Ďōćũḿēńţ ōũţĺĩńē"],"C-mmmK": ["Ţĥē ḿōďēĺ ĩď ŷōũŕ ēńďƥōĩńţ śēŕvēś. Ĩţś vēćţōŕ śĩźē ĩś ďēţēćţēď àũţōḿàţĩćàĺĺŷ — ćĺēàŕ ţĥē ƒĩēĺď ţō ĝō ƀàćķ ţō ",@@ -873,6 +892,9 @@"<0>~/.ōķ/ƀĩń</0> àńď <1>~/.ōķ/ēńv.śĥ</1> śţàŷ ēĩţĥēŕ ŵàŷ — ţĥē àƥƥ àĺŵàŷś ḿàĩńţàĩńś ţĥēḿ."],"CXTwen": ["Ćàń'ţ śàƒēĺŷ ēďĩţ ţĥĩś ƥŕōĴēćţ ćōńƒĩĝ"],+ "CXcveY": [+ "Ōƥēń Ķńōŵĺēďĝē ḿàĩńţàĩńś à ńàvĩĝàţĩōń ƒĩĺē ńàḿēď ĩńďēx.ḿď ĩń ēvēŕŷ ƒōĺďēŕ ţĥàţ ćōńţàĩńś Ḿàŕķďōŵń, ēàćĥ ĺĩśţĩńĝ ţĥàţ ƒōĺďēŕ'ś ďōćũḿēńţś ƀŷ ţŷƥē àńď ĺĩńķĩńĝ ţō ĩţś śũƀƒōĺďēŕś. Ĩţ ŕēŵŕĩţēś ţĥēśē ƒĩĺēś àś ŷōũŕ ďōćũḿēńţś ćĥàńĝē, àńď àńŷţĥĩńĝ ŷōũ ēďĩţ ĩńţō ţĥēḿ ŷōũŕśēĺƒ ĩś ŕēƥĺàćēď."+ ],"CXj9C-": ["Ńēŵ ƥŕōƥēŕţŷ ńàḿē"],"C_Lyvh": ["Ƒàĩĺēď ţō śàvē ţĥēḿē śēţţĩńĝ"],"C_WGy8": [@@ -896,6 +918,9 @@"Cu6GXQ": ["Ţĥē śōũŕćē ƒōĺďēŕ ĩţśēĺƒ ďōēś ńōţ ḿōvē."],"CvsD6Y": ["vĩà ", ["viaTags"]],"CwOXMT": ["Vàĺũē ƒōŕ ", ["keyName"]],+ "CxCOFx": [+ "Ĩń Ĝĩţ ƥŕōĴēćţś, Ōƥēń Ķńōŵĺēďĝē àďďś à śćōƥēď ŕũĺē ţō ţĥē ŕēƥōśĩţōŕŷ-ŕōōţ .ĝĩţàţţŕĩƀũţēś ƒĩĺē śō ćōńćũŕŕēńţ ĩńďēx ćĥàńĝēś ćōḿƀĩńē."+ ],"CxVk-w": ["Ćōḿḿēńţ ōń ", ["address"]],"D-NlUC": ["Śŷśţēḿ"],"D-Oh1s": ["Ĥōŵ ţō śēţ ũƥ ", ["0"], " (ōƥēńś ĩń ƀŕōŵśēŕ)"],@@ -954,6 +979,9 @@"DhT_PK": ["ŌƥēńĶńōŵĺēďĝē ĩḿƥōŕţēď à śķĩĺĺ"],"DiFKSL": ["Ćōũńţĩńĝ ḿàŕķďōŵń ƒĩĺēś"],"DiZ3pq": ["Ĩćōń ƥĩćķēŕ"],+ "DjNcDy": [+ "Ţĥē śĥàƥēś ōƒ ţĩţĺē, ďēśćŕĩƥţĩōń, ŕēśōũŕćē, àńď ţàĝś ŵĥēń ŷōũ ũśē ţĥēḿ. Ńōńē àŕē ŕēǫũĩŕēď; ďēćĺàŕĩńĝ ōńē ōńĺŷ ƥĩńś ĩţś ţŷƥē, śō ţàĝś ŵŕĩţţēń àś à ćōḿḿà-śēƥàŕàţēď śţŕĩńĝ ĩś ƒĺàĝĝēď."+ ],"DmkTrb": ["Ćōũĺďń’ţ ćŕēàţē ţĥĩś ţĥēḿē. Ţŕŷ àĝàĩń."],"Dnn2XG": ["Àũţōḿàţĩć"],"DpjYd6": ["ĵũḿƥ ţō ţĥē àńćĥōŕēď ţēxţ"],@@ -1168,6 +1196,9 @@"GNkUvW": ["Ǫũēũēď — śēńďś ŵĥēń ţĥĩś ŕũń ƒĩńĩśĥēś"],"GQ3O42": ["Ţŕàśĥ"],"GQDSBN": ["Ĺàŷōũţ ōƥţĩōńś"],+ "GROUfG": [+ "Àńŷ .ḿďx ƒĩĺē. Ţĥē ƒōŕḿàţ ĩś .ḿď-ōńĺŷ, śō à ŕēàďēŕ śćàńńĩńĝ ƒōŕ .ḿď ńēvēŕ ōƥēńś ĩţ — àńď ĩƒ à .ḿď ōƒ ţĥē śàḿē ńàḿē ēxĩśţś, ŕēàďś ţĥàţ ōńē ĩńśţēàď."+ ],"GSYWCm": ["Ĥĩďē ďōćũḿēńţ ƥàńēĺ"],"GUYwCr": ["Ďĩśḿĩśś ńōţĩćē"],"GUZHkL": ["Ḿĩśśĩńĝ ƥàĺēţţē ćōĺōŕś"],@@ -1324,6 +1355,7 @@"IxHMdF": ["Ćōũĺďń'ţ ďēĺēţē ţĥàţ ćōḿḿēńţ."],"IxyZXD": ["Śćŕēēńśĥōţ"],"Izh19j": ["Ŕēàďĩńĝ ƒŕōḿ ", ["tail"]],+ "J0uRhj": ["Ćĥēćķĩńĝ śķĩĺĺ"],"J1XRO3": ["Ţĥēḿē ćōĺōŕś"],"J2Mv98": ["Ńàḿē (ē.ĝ. ", ["login"], ")"],"J2_JuX": ["ńōţĥĩńĝ (", ["0"], " ćàńńōţ ḿàţćĥ à ďōć)"],@@ -1344,6 +1376,7 @@"JHf6qZ": ["ŷōũ@ćōḿƥàńŷ.ćōḿ"],"JJcBCm": [["0"], " ţōţàĺ"],"JK-Ave": ["Ĥĩďē ţĥũḿƀńàĩĺś"],+ "JKXcOi": ["Àĺŕēàďŷ ĩń ƥŕōĴēćţ"],"JL3si7": ["Ũƥďàţĩńĝ"],"JLUTgi": ["Ńō ţàĝś ŷēţ — àũţĥōŕ `#ţàĝńàḿē` ĩń àńŷ ďōć ţō ƥōƥũĺàţē ţĥē ĩńďēx."],"JLzQi_": ["Ćĺōśē ", ["accessibleLabel"]],@@ -1435,6 +1468,9 @@"L-rMC9": ["Ŕēśēţ ţō ďēƒàũĺţ"],"L1BQTH": [["0"], " ĩśń'ţ ĩńśţàĺĺēď ŷēţ — ōƥēńĩńĝ ĩţś ďōŵńĺōàď ƥàĝē."],"L1ZE3M": ["Ďōćũḿēńţ śţàţĩśţĩćś"],+ "L3BcJ4": [+ "Ţĥĩś ōńē ńēēďś ţō śēē ŷōũŕ ƒĩĺēś, ńōţ Ĵũśţ ţĥē ōƥēń ďōćũḿēńţ, śō ĩţ àƥƥēàŕś ŵĥēń ŷōũ ŕũń à ƥŕōĴēćţ àũďĩţ ŕàţĥēŕ ţĥàń ŵĥĩĺē ŷōũ ţŷƥē."+ ],"L3CEC1": ["ţĥĩś ĩţēḿ"],"L3w0_C": ["Ƥŕēśēńţ à ďōćũḿēńţ àś à śĺĩďē ďēćķ ĩń ĩţś ōŵń ŵĩńďōŵ. Àďď <0>śĺĩďēś: ţŕũē</0> ţō à ďōćũḿēńţ'ś ƒŕōńţḿàţţēŕ, ţĥēń ōƥēń ĩţ ŵĩţĥ ţĥē Śĺĩďēv àćţĩōń. Ŕēńďēŕĩńĝ ĩś ĥàńďĺēď ƀŷ ţĥē Śĺĩďēv ĆĹĨ, ŵĥĩćĥ ŌƥēńĶńōŵĺēďĝē ďōēś ńōţ ƀũńďĺē."@@ -1897,6 +1933,12 @@"R6ABfU": ["Ŵōŕķ ďĩŕēćţĺŷ, ńō ƥĺàń śţēƥ"],"R9IDFz": ["Ŕēńàḿēś ţĥē ƒōĺďēŕ ōń ďĩśķ àńď ţĥē ĩď àĝēńţś ũśē ţō ĩńvōķē ĩţ."],"R9dK63": ["Śàḿƥĺē ĩḿàĝē"],+ "RB_g_C": [+ "Ōń ţĥē ŕōōţ ĩńďēx, ōķƒ_vēŕśĩōń ĩś ŵŕĩţţēń àś à ǫũōţēď śţŕĩńĝ ĺĩķē \"0.2\". Ũńǫũōţēď, ŶÀḾĹ ŕēàďś ĩţ àś à ńũḿƀēŕ àńď 0.10 śĩĺēńţĺŷ ƀēćōḿēś 0.1."+ ],+ "RD6H9q": [+ "Ōƥēń Ķńōŵĺēďĝē ŕēŵŕĩţēś ţĥēśē ĩńďēx.ḿď ƒĩĺēś àś ďōćũḿēńţś ćĥàńĝē, śō ḿàńũàĺ ēďĩţś ţō ţĥēḿ àŕē ŕēƥĺàćēď."+ ],"RDjuBN": ["Śēţũƥ"],"RDrXh4": ["Ćōńƒĩĝũŕē ũśēŕ, ƥŕōĴēćţ, àńď ĩńţēĝŕàţĩōń śēţţĩńĝś."],"RG3yW6": ["Ēńţēŕ à ńàḿē ƒōŕ ţĥĩś ţĥēḿē."],@@ -1966,6 +2008,9 @@"SF9qpO": ["Śĥàŕē ŷōũŕ ēḿàĩĺ ƒōŕ ƒōĺĺōŵũƥś"],"SFEWV6": ["Ćōũĺďń'ţ ĺōàď ţĥē ŌƥēńĶńōŵĺēďĝē śķĩĺĺś. Ţŕŷ àĝàĩń."],"SFN6dN": ["Ĥēàďĩńĝ 3"],+ "SIPelo": [+ "Ĩńďēx ḿàĩńţēńàńćē ĩś ƥàũśēď ƀēćàũśē Ōƥēń Ķńōŵĺēďĝē ćōũĺď ńōţ ćōńƒĩŕḿ ţĥē ŕēǫũĩŕēď Ĝĩţ ḿēŕĝē ŕũĺē. Ćĥēćķ Ĝĩţ àńď .ĝĩţàţţŕĩƀũţēś, ţĥēń ţŕŷ àĝàĩń."+ ],"SInSnF": ["Ŕēƒēŕēńćē <0>", ["0"], "</0>"],"SItQRc": ["Ĥōŵ ďō ŷōũ ĺĩķē ŌƥēńĶńōŵĺēďĝē?"],"SOPwPh": ["Ŕēśţōŕē ţō ţĥĩś ēďĩţ"],@@ -2278,6 +2323,7 @@"X7u0xR": [["0"], " ţēḿƥĺàţēś àvàĩĺàƀĺē"],"X8kjQX": ["Ŕē-àũţĥēńţĩćàţē ŵĩţĥ ĜĩţĤũƀ"],"X9VpsP": ["Ĺōàďĩńĝ ƒōĺďēŕ ćōńţēńţś"],+ "XAnapw": ["Ĝĩţ ḿēŕĝē ŕũĺē"],"XAyxsa": ["Ćĥēćķ ōũţ ŕēḿōţē ƀŕàńćĥ"],"XBBZnv": ["Ĺĩńķ ţàŕĝēţ \"", ["shown"], "\" ďōēś ńōţ ŕēśōĺvē ţō àń ēxĩśţĩńĝ ďōćũḿēńţ."],"XBgr2S": ["Ćōƥŷ ĩń"],@@ -2399,6 +2445,9 @@"Y_iImT": ["Ũńŕēśōĺvàƀĺē ƒĩĺē ", ["identity"], ". Ĝō ţō ŕēƒēŕēńćē."],"Y_kL7X": ["Ćũśţōḿĩźē ĥōŵ ţĥē ēďĩţōŕ ĺōōķś àńď ƀēĥàvēś."],"Ya3PlJ": ["Ƥēŕḿĩśśĩōń ŕēǫũĩŕēď"],+ "YaVU2F": [+ "Ĩń Ĝĩţ ƥŕōĴēćţś, Ōƥēń Ķńōŵĺēďĝē àĺśō àďďś à śćōƥēď .ĝĩţàţţŕĩƀũţēś ŕũĺē śō ćōńćũŕŕēńţ ĩńďēx ćĥàńĝēś ćōḿƀĩńē ƀēƒōŕē ţĥē ńēxţ ŕēƀũĩĺď."+ ],"YaeyFh": ["Ƥũĺĺś ḿàŷ ōvēŕŵŕĩţē ũńćōḿḿĩţţēď ēďĩţś ĩń ŷōũŕ ĺōćàĺ ƒĩĺēś."],"Yb82LN": ["ĨĎ: ", ["0"]],"Yea-K5": ["Ŕēśţōŕē ţō ţĥĩś ƥōĩńţ"],@@ -2525,6 +2574,7 @@"_Bix3-": ["Ōććũŕŕēńćēś ōƒ ", ["localizedFirstMessage"]],"_DwR-n": ["Ćŕēàţĩńĝ…"],"_FLBbi": [["sizeText"], " · śēćŕēţś ŕēďàćţēď · ćŕàśĥ ďũḿƥ ńōţ ŕēďàćţēď"],+ "_G7A92": ["Ḿàĩńţàĩń ĩńďēx.ḿď"],"_GRWOJ": ["Ćĥàńĝē ţĥē ēḿƀēďďĩńĝś ƥŕōvĩďēŕ?"],"_HgF9q": ["Śōŕţ ƀŷ"],"_IGfXZ": ["ŌƥēńĶńōŵĺēďĝē ǫũĩţ ũńēxƥēćţēďĺŷ ĺàśţ ţĩḿē."],@@ -2609,10 +2659,12 @@"Ćōũĺďń'ţ ćōńńēćţ ţō ţĥē àĝēńţ śēŕvĩćē. Ḿàķē śũŕē ţĥē ŌƥēńĶńōŵĺēďĝē śēŕvēŕ ĩś ŕũńńĩńĝ àńď ũƥ ţō ďàţē (ŕēśţàŕţ ĩţ ĩƒ ĩţ ŵàś àĺŕēàďŷ ŕũńńĩńĝ), ţĥēń ţŕŷ àĝàĩń."],"aalx4E": ["Ēďĩţĩńĝ ƀŕōķēń ḾĎX śōũŕćē: ", ["reason"]],+ "aatPoi": ["Ĝēńēŕàţēď ƒĩĺēś"],"abiHje": ["Ďēĺēţē śēĺēćţēď ĩţēḿś"],"adsMWO": ["Ŕēśōĺvĩńĝ ďēĺţàś"],"ah_ekO": ["\"", ["name"], "\" ĩś àĺŕēàďŷ ũƥ ţō ďàţē"],"aiArms": ["Ŵē ćōũĺďń'ţ ćĺōńē ţĥĩś ŕēƥōśĩţōŕŷ."],+ "aiOceC": ["Ēńàƀĺē ĩńďēxēś"],"ajHi4O": ["Àũţō-śŷńć ĩś ƥàũśēď — ŷōũ ďōń'ţ ĥàvē ƥēŕḿĩśśĩōń ţō ƥũśĥ ţō ţĥĩś ŕēƥō. Śŵĩţćĥ ţō Ƒōĺĺōŵ ţō ķēēƥ ŕēćēĩvĩńĝ ũƥďàţēś."],@@ -2745,11 +2797,13 @@],"cb-0G0": ["Ćĺēàŕ ćōĺōŕ"],"ccNps_": ["Ōńĺŷ ḿōďĩƒĩēď"],+ "cd3THN": ["Ďōćũḿēńţ śţŕũćţũŕē"],"cd5EXh": ["Ŕēƥōŕţ à ƀũĝ"],"cdm00A": ["Ńō Ĩńćōḿĩńĝ"],"cdmk8A": ["Ũńćōḿḿĩţţēď ćĥàńĝēś"],"cgl-gn": ["Ćōńńēćţēď ţō ĜĩţĤũƀ"],"chL5IG": ["Ćōḿḿũńĩţŷ"],+ "ciozf1": ["Śķĩĺĺ àĺŕēàďŷ ĩń ƥŕōĴēćţ"],"cjtjry": ["Ţŕàvēŕśē ŌƥēńĶńōŵĺēďĝē ńàvĩĝàţĩōń ĥĩśţōŕŷ ƀàćķŵàŕď."],"cklVjM": ["Ţĩḿēĺĩńē"],"clJ3qM": ["Ďōńē."],@@ -2929,6 +2983,7 @@"fbdLmk": ["Ţōĝĝĺē ƀōĺď ƒōŕḿàţţĩńĝ."],"fbsiBw": ["Śōḿēţĥĩńĝ ŵēńţ ŵŕōńĝ śţàŕţĩńĝ ţĥē ţēŕḿĩńàĺ."],"fcgvCA": ["Ćĺàũďē"],+ "fdKQAE": ["Ţũŕńĩńĝ ĩţ ōƒƒ"],"fdeFfN": ["(ƀĩńàŕŷ ƒĩĺē, ńōţ ƥŕēvĩēŵàƀĺē)"],"fevEu0": ["Ƥũĺĺ ĺàţēśţ ćĥàńĝēś"],"ffH3Rt": ["Àďď Ćōḿḿēńţ (Ēńţēŕ)"],@@ -3012,12 +3067,16 @@"gUx34c": ["Ţĥē ĺàńĝũàĝē ŌƥēńĶńōŵĺēďĝē śƥēàķś; Śŷśţēḿ ƒōĺĺōŵś ŷōũŕ ōƥēŕàţĩńĝ śŷśţēḿ. Ŷōũŕ ōŵń ńōţēś śţàŷ ĩń ţĥē ĺàńĝũàĝē ŷōũ ŵŕōţē ţĥēḿ ĩń."],+ "gVMkEr": [+ "Ĩń à ĺōĝ ďōćũḿēńţ: ēńţŕŷ ĥēàďĩńĝś ĺēàď ŵĩţĥ àń ĨŚŌ ŶŶŶŶ-ḾḾ-ĎĎ ďàţē, ńēŵēśţ ƒĩŕśţ. Ĥōŵ ḿàńŷ ţĩţĺēś ŷōũ ũśē, àńď ŵĥēţĥēŕ ēńţŕĩēś àŕē ƀũĺĺēţś, ĩś ũƥ ţō ŷōũ."+ ],"gY7wnY": ["Śĩĝńĩńĝ ĩń ţō ", ["agentName"], "…"],"gYz2ep": ["Ēxƥĩŕēś ĩń ", ["timeLabel"]],"gZElfU": ["Ƒĩxĩńĝ ", ["0"], " ōƒ ", ["1"], " ƒĩĺēś"],"gZiT5e": ["Ŕēƥĺàćē ţĥēśē śŷḿĺĩńķś ŵĩţĥ ĩńďēƥēńďēńţ ćōƥĩēś?"],"gayL_Q": ["Ŕēĺēàśē ƥĺàń"],"gbHcbI": ["Ƒàĩĺēď ţō ďēĺēţē ƥŕōƥēŕţŷ"],+ "gfYI3o": ["Ďĩśàƀĺē ", ["id"]],"gfb-CM": ["Ćōũĺď ńōţ ƒēţćĥ ƀŕàńćĥ — śĩĝń ĩń ţō ĜĩţĤũƀ àńď ţŕŷ àĝàĩń."],"gfdqcY": ["Ćōũĺďń'ţ àƥƥĺŷ ţĥē ćĥàńĝē: ", ["0"]],"gfohmY": ["Ćōńńēćţ ţōōĺś"],@@ -3076,6 +3135,9 @@"hLKfZe": ["Ũśē à ţōķēń ĩńśţēàď"],"hLod4_": ["Ćōńvēŕţ ţō ţēḿƥĺàţē"],"hLy8b1": ["Ũƥďàţēď ţō Vēŕśĩōń ", ["version"]],+ "hPQBsa": [+ "Ŕēśēŕvēď ƒĩĺēś àŕē ńàḿēď ĩńďēx.ḿď àńď ĺōĝ.ḿď ĩń ĺōŵēŕćàśē. Ōń à ćàśē-śēńśĩţĩvē ƒĩĺēśŷśţēḿ, Ĩńďēx.ḿď ĩś ŕēàď àś àń ōŕďĩńàŕŷ ďōćũḿēńţ àńď ĺōśēś ĩţś ḿēàńĩńĝ."+ ],"hQXiDc": ["Śēàŕćĥ ƀŕàńćĥēś..."],"hQjvzi": ["À .źĩƥ ōŕ .śķĩĺĺ àŕćĥĩvē."],"hS0wC4": ["ŌƥēńĶńōŵĺēďĝē ŕēśţōŕēď àń ēàŕĺĩēŕ vēŕśĩōń ōƒ ", ["subject"]],@@ -3211,6 +3273,9 @@"iz1LdD": ["Ćĥàńĝēď ōũţśĩďē ŌĶ śĩńćē ĩţ ĺàśţ ŵŕōţē ĥēŕē — ţĥē śţàţē śĥōŵń ĩś ŵĥàţ'ś ōń ďĩśķ ńōŵ"],+ "j-o6Z2": [+ "Ĩńďēx ḿàĩńţēńàńćē śţàŷēď ōƒƒ ƀēćàũśē ţĥē ƥŕōĴēćţ śēţţĩńĝ ćōũĺď ńōţ ƀē śàvēď. Ćĥēćķ ţĥē ƥŕōĴēćţ ƒĩĺē ƥēŕḿĩśśĩōńś, ţĥēń ţŕŷ àĝàĩń."+ ],"j15ZSH": ["Śēńď ćōḿḿēńţś ţō"],"j2229h": ["Ŕēḿōvĩńĝ ŌƥēńĶńōŵĺēďĝē ƒĩĺēś…"],"j2kt1j": [@@ -3294,6 +3359,7 @@"k4CuuV": ["Ŕēàďŷ-ḿàďē ƒōĺďēŕś àńď ţēḿƥĺàţēś ţō ĝēţ ŷōũ śţàŕţēď ǫũĩćķĺŷ. Śēĺēćţ à ƥàćķ ţō ƥŕēvĩēŵ ŵĥàţ ĝēţś ćŕēàţēď, ţĥēń àďď ĩţ ţō ŷōũŕ ƥŕōĴēćţ."],+ "k5rKNs": ["Ƒŕōńţḿàţţēŕ"],"k7Hoig": ["Ńō ćōńţēńţ ćĥàńĝēś àţ ţĥĩś vēŕśĩōń."],"k8xtrB": ["Ńōţ ŕēǫũĩŕēď ƒōŕ à ĺōćàĺĥōśţ ēńďƥōĩńţ ĺĩķē <0>",@@ -3333,7 +3399,9 @@"kV2YZv": ["Ďōń'ţ śēē <0>Śķĩĺĺś</0>? Ēńàƀĺē <1>Śēţţĩńĝś <2/> Ćàƥàƀĩĺĩţĩēś <3/> Ćōďē ēxēćũţĩōń àńď ƒĩĺē ćŕēàţĩōń</1> ƒĩŕśţ."],+ "kVS5tE": ["Ḿàĩńţàĩń ĝēńēŕàţēď ĩńďēxēś ĩń ēvēŕŷ ƒōĺďēŕ?"],"kVgQUA": ["Ďēĺēţē ţĥĩś ćĥàţ?"],+ "kVzuTI": ["Ŕēćōḿḿēńďēď àĝēńţ śķĩĺĺ"],"kYL1lH": ["Àĝēńţ àćţĩvĩţŷ"],"k_Dqw1": [[@@ -3425,7 +3493,9 @@"lWNpNB": ["Àďď ćũŕśōŕś ōŕ śēĺēćţ ḿàţćĥĩńĝ ōććũŕŕēńćēś ţĥŕōũĝĥ ĆōďēḾĩŕŕōŕ."],"lXKZGw": ["Ĥēàďĩńĝ 1"],"lY27jj": [["0"], "ŷ àĝō"],+ "lY7Unt": ["Ēńàƀĺĩńĝ ĩńďēx ĝēńēŕàţĩōń"],"lZAiSP": ["ßàćķĺĩńķś ŕēśƥōńśē ďĩď ńōţ ḿàţćĥ ēxƥēćţēď śĥàƥē."],+ "lZoQdy": ["Ōƥēń śķĩĺĺ"],"lZvQrY": ["Ũśē ", ["0"], " àś ţĥē ďàŕķ ţĥēḿē"],"l_6JHD": ["Śēàŕćĥ ĩćōńś..."],"l_FAT6": ["Ũśē ĺēţţēŕś, ďĩĝĩţś, <0>-</0> ōŕ <1>_</1> ōńĺŷ."],@@ -3443,6 +3513,7 @@"ljHjfg": ["Ţĥàţ ƀŕàńćĥ ĩś àĺŕēàďŷ ōƥēń ĩń àńōţĥēŕ ŵōŕķţŕēē."],"lkYioO": ["Śĥōŵ ōŕ ĥĩďē ďōćũḿēńţ ƥàńēĺ"],"ll2yNl": ["Ćōńţēńţ ďĩŕēćţōŕŷ"],+ "llXHHh": [["pluginCount", "plural", { "one": ["ƥĺũĝĩń"], "other": ["ƥĺũĝĩńś"] }]],"lmBPt0": ["Ōńĺŷ ēxţēŕńàĺ ĺĩńķś ţŕĩĝĝēŕ à ŕēǫũēśţ. Ĺĩńķś ţō ōţĥēŕ ďōćũḿēńţś ĩń ţĥĩś ƥŕōĴēćţ ƥŕēvĩēŵ ƒŕōḿ ţĥē ĺōćàĺ ĩńďēx àńď ńēvēŕ ĺēàvē ŷōũŕ ćōḿƥũţēŕ."],@@ -3510,6 +3581,9 @@}]],+ "mhnCt3": [+ "Ēvēŕŷ ćōńćēƥţ ďōćũḿēńţ ćàŕŕĩēś à ńōń-ēḿƥţŷ ţŷƥē. Ţĥĩś ĩś ţĥē ŵĥōĺē ōƒ ŌĶƑ'ś ćōńƒōŕḿàńćē ƒĺōōŕ — à ďōćũḿēńţ ŵĩţĥ ōńĺŷ à ţŷƥē ĩś ƒũĺĺŷ ćōńƒōŕḿàńţ."+ ],"mk2poV": ["ē.ĝ. śēŕvēŕ.ţś"],"mlvM8g": ["Ćōũĺďń'ţ ŕē-ƥĺàćē ţĥàţ ćōḿḿēńţ."],"mmpzAq": ["Ŵŕàƥ ĺōńĝ ĺĩńēś ĩń ţĥē ḿàŕķďōŵń śōũŕćē ēďĩţōŕ."],@@ -3773,6 +3847,9 @@"qRZh7J": ["Ĺēţ Ţàƀ ĺēàvē ţĥē śōũŕćē ēďĩţōŕ ĩńśţēàď ōƒ ĩńďēńţĩńĝ."],"qSKu2v": ["Śōũŕćē ńàvĩĝàţĩōń àńď śēĺēćţĩōń"],"qSxaOz": ["Àććēƥţ ţĥēĩŕ ďēĺēţĩōń"],+ "qTT48-": [+ "Ŵĩķĩ-ĺĩńķś ĺĩķē [[Ƥàĝē]] — à śũƥƥōŕţēď ŵàŷ ţō ĺĩńķ ĥēŕē, ƀũţ àń ēxţēŕńàĺ ŕēàďēŕ ŕēśōĺvēś ńōţĥĩńĝ àńď śĥōŵś ţĥē ƀŕàćķēţś."+ ],"qTcVwj": ["ßŕōŵśē ōŕ ũƥĺōàď à śķĩĺĺ ƒōŕ ţĥĩś ƥŕōĴēćţ."],"qTcZZu": ["Ƒàĩĺēď ţō ĺōàď ţàĝś. Ƥŕēśś <0>Ēść</0> àńď ŕē-ōƥēń ţō ŕēţŕŷ."],"qX-ABr": ["Ōŕ ţō ũśē ƀŕōŵśēŕ śĩĝń-ĩń ĩńśţēàď:"],@@ -3823,6 +3900,7 @@"r51jLC": ["Ƒĩĺē śàvēď & Ćĺàũďē Ďēśķţōƥ Àƥƥ ōƥēńēď"],"r6ncaO": ["Ćĺōśē ţàƀ"],"r6y-jM": ["Ŵàŕńĩńĝ"],+ "r7IaYp": ["Ōƥēń Ķńōŵĺēďĝē Ƒōŕḿàţ ĝũĩďàńćē"],"r871ed": ["Ŷōũŕ ķńōŵĺēďĝē ƀàśē ĩś ńōŵ ōń ĜĩţĤũƀ àţ <0>",["ownerLogin"],@@ -3852,6 +3930,9 @@"rZVMkf": ["Vĩśũàĺ ēďĩţōŕ ŕēƥĺàćē ĩńƥũţ ƒōćũśēď"],"radOpL": ["Ĩḿàĝē ", ["identity"], ". Ĝō ţō ŕēƒēŕēńćē."],"rageVb": ["Ćũśţōḿ ĤŢḾĹ ŵĩţĥ à ĺĩvē ƥŕēvĩēŵ ƥàńē (śàńďƀōxēď ĩƒŕàḿē)."],+ "rarziH": [+ "Ĥēĺƥś ćōďĩńĝ àĝēńţś ćĥōōśē ŌĶƑ ďōćũḿēńţ ţŷƥēś, ƥŕēśēŕvē ƥŕōvēńàńćē, àńď àvōĩď ĩńvēńţĩńĝ ũńśũƥƥōŕţēď ḿēţàďàţà."+ ],"rbrHTd": ["Àƥƥŕōvēď — ", ["optionName"]],"rcJmK8": ["Ćōńvēŕţ ĺōćàţĩōńś ţō ćōƥĩēś"],"rdU729": ["Ĺàŷōũţ"],@@ -3902,6 +3983,7 @@"sER-bs": ["Ƒĩĺēś"],"sFhaTJ": ["Ďĩśàḿƀĩĝũàţēś śĩḿĩĺàŕĺŷ-ńàḿēď ţēḿƥĺàţēś ĩń ţĥē ḿēńũ."],"sGZLfB": ["Ƒàĩĺēď ţō ƒēţćĥ ŕēƥōśĩţōŕĩēś"],+ "sHDllh": ["Śţōƥ ḿàĩńţàĩńĩńĝ ĩńďēx.ḿď"],"sICrVf": ["Ŕēśţōŕēď ţō ţĥē vēŕśĩōń ƒŕōḿ ", ["0"]],"sIGbBZ": ["Ćōńvēŕţ śēĺēćţĩōń ţō ƒōōţńōţē"],"sIxSSP": ["Ŕēśōĺvē ćōńƒĺĩćţ ĩń ŷōũŕ ţēŕḿĩńàĺ"],@@ -3915,6 +3997,7 @@"sOxZaS": ["Ƒàĩĺēď ţō ĺōàď ĝŕàƥĥ"],"sQoLn0": ["Ǫũĩţ"],"sR0I-f": ["Ćōĺĺàƥśē àĺĺ ƒĩĺēś"],+ "sSRndh": ["Śţàŕţ ḿàĩńţàĩńĩńĝ ĩńďēx.ḿď"],"sW5OjU": ["ŕēǫũĩŕēď"],"sZ2IOu": ["Ţĥĩś ",@@ -3929,6 +4012,9 @@"saIASg": ["Śēćōńď ĩţēḿ"],"saYiIO": ["Ƥàţĥ ćàńńōţ ćōńţàĩń ńũĺĺ ƀŷţēś"],"scu3wk": ["Ḿōďēĺ"],+ "scyoP9": [+ "Ĩńďēx ďōćũḿēńţś ćàŕŕŷ ńō ƒŕōńţḿàţţēŕ, ēxćēƥţ ţĥē ōńē àţ ŷōũŕ ķńōŵĺēďĝē ƀàśē'ś ŕōōţ. Ĺōĝ ďōćũḿēńţś àŕē ńōţ ćōvēŕēď — ŌĶƑ ďōēś ńōţ ćōńśţŕàĩń ţĥēĩŕ ƒŕōńţḿàţţēŕ."+ ],"se-tU0": ["Ćōũĺď ńōţ ƒĩx ", ["0"], " ōƒ ", ["total"], " ƒĩĺēś."],"seeS6l": ["Śēţũƥ ŌƥēńĶńōŵĺēďĝē ĩń ţĥĩś ƒōĺďēŕ?"],"sgmRY8": ["Śķĩƥƥēď ďōŵńĺōàďĩńĝ ", ["0"], "."],@@ -3979,6 +4065,9 @@"tHKQ6j": ["Ŕēńàḿĩńĝ"],"tKlWWY": ["ĒḿōĴĩ"],"tLX6LY": ["ŌƥēńĶńōŵĺēďĝē ŵŕōţē à ďōćũḿēńţ"],+ "tM5uzl": [+ "Ţĥē ƥŕōvēńàńćē, ţŕũśţ, àńď ĺĩƒēćŷćĺē ƒàḿĩĺĩēś: śōũŕćēś, ĝēńēŕàţēď, vēŕĩƒĩēď, śţàţũś, àńď śţàĺē_àƒţēŕ. Ēvēŕŷ ƒĩēĺď ĩś ōƥţĩōńàĺ, àńď àƀśēńćē ĩś ńēvēŕ àń ēŕŕōŕ."+ ],"tN5WTS": ["Ţĥē ƥŕōvĩďēŕ ŕēĴēćţēď ţĥē ŕēǫũēśţ. Ćĥēćķ ţĥē ÀƤĨ ķēŷ àńď ţĥē ḿōďēĺ ĩď."],"tP5DDk": ["Àƥƥĺŷ ĺĩńķ"],"tUvUfp": ["Ũśē à ƒōĺďēŕ ŷōũ àĺŕēàďŷ ĥàvē."],@@ -4040,6 +4129,9 @@"uGaIIS": ["Ćĥēćķ ōũţ ŵōŕķţŕēē"],"uH_S-u": [["loadErrorTitle"], ": ", ["message"]],"uJfwF8": ["Àĺŕēàďŷ ĩńśţàĺĺēď — ńōţĥĩńĝ ńēŵ ţō ĩḿƥōŕţ."],+ "uK2peg": [+ "Ćĥēćķś ŷōũŕ ƥŕōĴēćţ àĝàĩńśţ ţĥē Ōƥēń Ķńōŵĺēďĝē Ƒōŕḿàţ. Ţũŕń ĩţ ōƒƒ àńŷ ţĩḿē ĩń Śēţţĩńĝś."+ ],"uKRYiW": ["Śŷńć śţàţũś ũńàvàĩĺàƀĺē — śēŕvēŕ ēŕŕōŕ."],"uL_Wx8": ["Ţĥē ţēŕḿĩńàĺ śţōƥƥēď ũńēxƥēćţēďĺŷ."],"uM6jnS": ["Ŕēśţōŕē ƒàĩĺēď"],@@ -4096,6 +4188,9 @@"uyOQ4e": ["Ţĥēḿē ćōƥĩēď àś ƀàśē16 ŶÀḾĹ"],"uynXup": [["tokens", "plural", { "one": ["ţōķēń"], "other": ["ţōķēńś"] }]],"v-h2hx": ["Ďēĺēţē ", ["targetGitPath"]],+ "v15iQB": [+ "Ţĥē àţţēśţēď-ćōḿƥũţàţĩōń ćōńţŕàćţ. Ōńĺŷ àƥƥĺĩēś ţō ďōćũḿēńţś ţŷƥēď Àţţēśţēď Ćōḿƥũţàţĩōń, ŵĥēŕē ŌĶƑ ŕēǫũĩŕēś à ŕũńţĩḿē; ōŕďĩńàŕŷ ćōńćēƥţś àŕē ũńàƒƒēćţēď."+ ],"v2ZW0K": ["Ēńàƀĺē ţēŕḿĩńàĺ"],"v2a04T": ["ḿàŕķďōŵńĺĩńţ ŕũĺēś"],"v41fCm": ["Ƒĩĺē ńōţ ƒōũńď"],diff --git a/packages/app/src/locales/pseudo/messages.po b/packages/app/src/locales/pseudo/messages.poindex 89e52c239..cbbdfe937 100644--- a/packages/app/src/locales/pseudo/messages.po+++ b/packages/app/src/locales/pseudo/messages.po@@ -263,6 +263,11 @@ msgstr ""msgid "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"msgstr ""+#. placeholder {0}: pluginRows.length+#: src/components/CreatedItemsList.tsx+msgid "{0, plural, one {Plugin} other {Plugins}}"+msgstr ""+#. placeholder {0}: editorList.hiddenCount#: src/components/McpConsentDialogBody.tsxmsgid "{0, plural, one {Show # more tool} other {Show # more tools}}"@@ -629,7 +634,9 @@ msgstr ""msgid "{docName} is {0}. OpenKnowledge currently opens files up to {1}."msgstr ""+#. placeholder {0}: OKF_RULE_IDS.length#. placeholder {0}: entries.length+#: src/components/settings/LintingSection.tsx#: src/components/settings/markdownlint-rule-browser.tsxmsgid "{enabledCount}/{0} on"msgstr ""@@ -792,6 +799,10 @@ msgstr ""msgid "{phase} — {pct}%"msgstr ""+#: src/components/CreatedItemsList.tsx+msgid "{pluginCount, plural, one {plugin} other {plugins}}"+msgstr ""+#: src/components/PropertyDisclosure.tsxmsgid "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"msgstr ""@@ -1543,6 +1554,10 @@ msgstr ""msgid "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Already in project"+msgstr ""+#: src/components/SkillPluginBundleDialog.tsxmsgid "Already installed — nothing new to import."msgstr ""@@ -1588,6 +1603,10 @@ msgstr ""msgid "any"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+msgstr ""+#. placeholder {0}: summary.name#: src/components/settings/LintingSection.tsxmsgid "any doc named {0}"@@ -2148,6 +2167,7 @@ msgstr ""#: src/components/ReportBugDialogBody.tsx#: src/components/SeedDialog.tsx#: src/components/settings/LinkPreviewsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/SavedThemesTiles.tsx#: src/components/settings/SearchSection.tsx#: src/components/ShareBranchSwitchDialog.tsx@@ -2288,6 +2308,10 @@ msgstr ""msgid "Checking sign-in status"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Checking skill"+msgstr ""+#: src/components/ImportSkillForm.tsxmsgid "Checking source"msgstr ""@@ -2304,6 +2328,10 @@ msgstr ""msgid "Checklist with checkboxes."msgstr ""+#: src/components/CreatedItemsList.tsx+msgid "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+msgstr ""+#: src/components/ImportSkillForm.tsxmsgid "Choose a skill archive"msgstr ""@@ -4300,6 +4328,10 @@ msgstr ""msgid "Disable {file}"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Disable {id}"+msgstr ""+#: src/components/settings/LinkPreviewsSection.tsxmsgid "Disable external link previews"msgstr ""@@ -4402,6 +4434,10 @@ msgstr ""msgid "Document statistics"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Document structure"+msgstr ""+#: src/components/empty-state/use-create-suggestions.tsmsgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."msgstr ""@@ -4793,6 +4829,10 @@ msgstr ""msgid "Enable {file}"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Enable {id}"+msgstr ""+#: src/components/AutoSyncOnboardingDialog.tsx#: src/components/EnableSyncConfirmDialog.tsx#: src/components/share-receive-miss-content.tsx@@ -4817,6 +4857,10 @@ msgstr ""msgid "Enable git auto-sync?"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Enable indexes"+msgstr ""+#: src/components/ProblemsPanel.tsxmsgid "Enable plugins"msgstr ""@@ -4845,6 +4889,10 @@ msgstr ""msgid "Enable Themes"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Enabling index generation"+msgstr ""+#: src/components/ActivityModeContent.tsxmsgid "Ended"msgstr ""@@ -4915,6 +4963,10 @@ msgstr ""msgid "Escape"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+msgstr ""+#: src/components/settings/LintingSection.tsxmsgid "every doc"msgstr ""@@ -5690,6 +5742,10 @@ msgstr ""msgid "From the {0} plugin"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Frontmatter"+msgstr ""+#: src/components/TemplateForm.tsxmsgid "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."msgstr ""@@ -5732,6 +5788,10 @@ msgstr ""msgid "General"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Generated files"+msgstr ""+#: src/components/TerminalCliMissingBanner.tsxmsgid "Get {displayName}"msgstr ""@@ -5765,6 +5825,10 @@ msgstr ""msgid "Git identity isn't set — commits use a default author. Set yours so teammates see your name."msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Git merge rule"+msgstr ""+#: src/components/ShareBranchSwitchDialog.tsxmsgid "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."msgstr ""@@ -5919,7 +5983,7 @@ msgstr ""msgid "Headings"msgstr ""-#: src/components/AutoSyncEnableWarning.tsx+#: src/components/DisclosureWarning.tsx#: src/editor/slash-command/component-items.tsxmsgid "Heads up"msgstr ""@@ -5941,6 +6005,10 @@ msgstr ""msgid "Help"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+msgstr ""+#. Subtext for the open-knowledge-discovery skill row#. Subtext for the open-knowledge-discovery skill row#: src/components/McpConsentDialogBody.tsx@@ -6273,10 +6341,18 @@ msgstr ""msgid "Importing"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+msgstr ""+#: src/components/SeedDialog.tsxmsgid "In a subfolder"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+msgstr ""+#: src/components/empty-state/CreatePromptComposer.tsx#: src/components/handoff/AgentSplitButton.tsx#: src/components/handoff/OpenInAgentContextSubmenu.tsx@@ -6295,6 +6371,14 @@ msgstr ""msgid "In app (beta)"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+msgstr ""++#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+msgstr ""+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "In the Claude Desktop App"msgstr ""@@ -6319,6 +6403,26 @@ msgstr ""msgid "Indented blockquote for citations."msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+msgstr ""++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+msgstr ""++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+msgstr ""++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+msgstr ""++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+msgstr ""+#: src/components/settings/SearchSection.tsxmsgid "Indexed {embedded} of {total} pages."msgstr ""@@ -6507,6 +6611,10 @@ msgstr ""msgid "Install selected"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Install skill"+msgstr ""+#: src/components/SkillPluginBundleBanner.tsxmsgid "Install skills"msgstr ""@@ -6516,6 +6624,7 @@ msgid "Install the gh CLI"msgstr ""#: src/components/settings/AiToolsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ProjectAiToolsSection.tsx#: src/components/SkillEditorActions.tsxmsgid "Installed"@@ -6729,6 +6838,10 @@ msgstr ""msgid "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Keeps your knowledge base aligned with the Open Knowledge Format."+msgstr ""+#. placeholder {0}: toName.trim()#: src/components/SkillForkDialog.tsxmsgid "Kept both — \"{0}\" is its own skill now"@@ -7104,6 +7217,14 @@ msgstr ""msgid "Lost connection to \"{docName}\"."msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Maintain generated indexes in every folder?"+msgstr ""++#: src/components/settings/LintingSection.tsx+msgid "Maintain index.md"+msgstr ""+#: src/components/SkillInstallMenu.tsxmsgid "make source"msgstr ""@@ -8248,6 +8369,10 @@ msgstr ""msgid "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "OKF agent skill installed"+msgstr ""+#: src/components/settings/LinkPreviewsSection.tsxmsgid "On — hovering an external link sends its URL to the destination site to fetch a preview."msgstr ""@@ -8264,6 +8389,10 @@ msgstr ""msgid "On selected text in <0>{address}</0>"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+msgstr ""+#. Next step for a Cursor project MCP row — Cursor leaves project servers disabled#: src/components/settings/ProjectAiToolsSection.tsxmsgid "One more step: enable it in Cursor → Settings → Tools & MCP (Cursor leaves project servers off until you turn them on)."@@ -8486,6 +8615,22 @@ msgstr ""msgid "Open it there"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+msgstr ""++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge Format guidance"+msgstr ""++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+msgstr ""++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+msgstr ""+#. placeholder {0}: item.displayName#. placeholder {1}: item.displayName#. placeholder {2}: item.version@@ -8532,6 +8677,10 @@ msgstr ""msgid "Open shared {targetNoun}"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Open skill"+msgstr ""+#: src/editor/extensions/JsxComponentView.tsxmsgid "Open source doc: {mirrorSrc}"msgstr ""@@ -9368,6 +9517,7 @@ msgid "project"msgstr ""#: src/components/CommandPalette.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ScopeBadge.tsx#: src/lib/skill-scope.tsmsgid "Project"@@ -9639,6 +9789,10 @@ msgstr ""msgid "Recently opened"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Recommended agent skill"+msgstr ""+#: src/components/SyncStatusBadge.tsxmsgid "Reconnect required"msgstr ""@@ -10076,6 +10230,10 @@ msgstr ""msgid "research-note"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+msgstr ""+#: src/components/settings/CustomThemeEditor.tsxmsgid "Reset"msgstr ""@@ -10318,6 +10476,7 @@ msgid "Rule editing is available for the project's root markdownlint config"msgstr ""#: src/components/LintConfigEditor.tsx+#: src/components/settings/LintingSection.tsxmsgid "Rules"msgstr ""@@ -11260,6 +11419,10 @@ msgstr ""msgid "Skill \"{name}\" created"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Skill already in project"+msgstr ""+#: src/components/ExploreSkills.tsxmsgid "Skill discovery powered by <0>skills.sh</0>"msgstr ""@@ -11519,6 +11682,10 @@ msgstr ""msgid "Start here: what this is and how it's organized."msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Start maintaining index.md"+msgstr ""+#: src/lib/keyboard-shortcuts.tsmsgid "Start source completion"msgstr ""@@ -11614,6 +11781,10 @@ msgstr ""msgid "Stop fixing. Files already fixed stay fixed."msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Stop maintaining index.md"+msgstr ""+#: src/lib/project-fix-sweep-store.tsmsgid "Stopped fixing. Files already fixed stay fixed."msgstr ""@@ -12117,6 +12288,10 @@ msgstr ""msgid "The agent's persona, values, and voice."msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+msgstr ""+#: src/components/ProblemsPanel.tsxmsgid "The audit could not be completed. Try again."msgstr ""@@ -12175,6 +12350,10 @@ msgstr ""msgid "the git exclude file isn't writable"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "The index files stay in place. Open Knowledge removes only the Git rule it added."+msgstr ""+#: src/lib/locale-load-failure-notice.tsmsgid "The interface is still in the language you were reading. Check your connection, then reload to try again."msgstr ""@@ -12211,6 +12390,10 @@ msgstr ""msgid "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+msgstr ""+#: src/components/settings/SearchSection.tsxmsgid "The provider is rate-limiting this key. Try again in a moment."msgstr ""@@ -12248,6 +12431,10 @@ msgstr ""msgid "the server responded but server.lock has no port yet"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+msgstr ""+#: src/components/SkillInstallMenu.tsxmsgid "The skill's own folder — the source other locations copy or link from"msgstr ""@@ -12561,6 +12748,10 @@ msgstr ""msgid "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+msgstr ""+#: src/components/SeedDialog.tsxmsgid "This pack is already set up here."msgstr ""@@ -12924,6 +13115,10 @@ msgstr ""msgid "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."msgstr ""+#: src/components/CreatedItemsList.tsx+msgid "Turn it off any time in Settings."+msgstr ""+#: src/components/NotInSidebarIndicator.tsxmsgid "Turn off Only markdown files"msgstr ""@@ -12949,6 +13144,10 @@ msgstr ""msgid "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Turning it off"+msgstr ""+#: src/components/acp/working-status.tsmsgid "Turning it over…"msgstr ""@@ -13639,6 +13838,10 @@ msgstr ""msgid "Wiki link suggestions"msgstr ""+#: src/components/settings/LintingSection.tsx+msgid "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+msgstr ""+#: src/components/PublishToGitHubDialog.tsxmsgid "Will be created as <0>{sanitizedName}</0>"msgstr ""diff --git a/packages/app/src/locales/pt-BR/messages.json b/packages/app/src/locales/pt-BR/messages.jsonindex 0b0134b58..addbbf96d 100644--- a/packages/app/src/locales/pt-BR/messages.json+++ b/packages/app/src/locales/pt-BR/messages.json@@ -135,6 +135,9 @@"0ySP5u": ["As alterações são salvas automaticamente neste tema."],"0zAhu6": ["todos os documentos"],"10g8I_": ["Desligar Somente arquivos markdown"],+ "110eEb": [+ "Open Knowledge cria e mantém um arquivo de navegação denominado index.md em cada pasta que contém Markdown."+ ],"11ukmX": ["Falha ao renomear: ", ["0"]],"12F9WL": ["(sem id)"],"151wvk": ["Mostrar a barra lateral"],@@ -156,6 +159,9 @@"1GhYxC": ["de ", ["totalPages"]],"1HBhDS": ["Extraindo arquivos"],"1J0c0X": ["Ainda não foi possível acessar ", ["displayName"], ". Tentar mais uma vez?"],+ "1JpLgH": [+ "Em um documento de índice: as entradas ficam sob o título de uma seção e cada uma carrega um link. A prosa em torno das listas está bem."+ ],"1LtA5r": ["Cria um link simbólico da habilidade para ", ["path"]],"1MGRQl": ["Sessões de terminal"],"1NgrlY": ["Outras formas de instalar"],@@ -169,6 +175,7 @@"1XSMhZ": ["Mudar para <0>somente local</0> será recusado até que eles deixem de ser rastreados com<1> git rm --cached</1>."],+ "1ZXkqM": ["Desligue-o a qualquer momento nas Configurações."],"1ZpfyB": ["Abrir com a IA ", ["displayName"], ", ", ["hint"]],"1a6ICf": ["Acompanhando as edições do agente"],"1bDVu5": ["Paleta de comandos do espaço de trabalho"],@@ -335,6 +342,8 @@"3o3tur": ["Conteúdo inicial"],"3oh0nQ": ["Erro no .okignore aninhado em ", ["path"]],"3pU8e-": ["Fixar aba"],+ "3qDsdf": ["Instalar habilidade"],+ "3ri_4O": ["Mantém sua base de conhecimento alinhada ao Open Knowledge Format."],"3s-k7L": [["0",@@ -510,6 +519,9 @@],"5tcmwY": ["Adicionar valor"],"5vAI6Z": ["Não encaixou no meu jeito de trabalhar"],+ "5w38tn": [+ "A manutenção do índice permaneceu desativada porque Open Knowledge não conseguiu acessar o servidor do projeto. Tente novamente quando o projeto for reconectado."+ ],"5wV2qQ": ["e mais"],"5y_9lO": ["Aguardando a autorização"],"6-wLTJ": [["behind"], " atrás de origin"],@@ -667,6 +679,7 @@"7d1a0d": ["Público"],"7dZnmw": ["Relevância"],"7hctf2": ["Descreva o projeto que você quer criar"],+ "7idx48": ["OKF habilidade do agente instalada"],"7jIIFX": ["Está tudo pronto!"],"7kb4LU": ["Aprovado"],"7l15X4": ["falhou"],@@ -674,6 +687,7 @@"7m3Ade": ["instalações:"],"7qRHf0": ["Instalar para o Claude Chat e Cowork"],"7uBlRT": ["Copia o item em foco na árvore de arquivos para que Colar possa duplicá-lo."],+ "7wogIQ": [["0", "plural", { "one": ["Plugin"], "many": ["Plugins"], "other": ["Plugins"] }]],"80c4-P": ["Código copiado para a área de transferência"],"81H_23": ["Adicionar propriedades"],"851WA-": ["Isto pode ser configurado em Configurações > Ferramentas de IA e CLI"],@@ -739,6 +753,7 @@"8nWu1k": ["Diagrama vazio"],"8oWgty": ["Marcar todos os comentários para enviar"],"8qgfac": ["Servidores MCP"],+ "8rZ1pk": ["Habilitar ", ["id"]],"8ruqQi": ["Links internos quebrados"],"8sMErm": ["Ativar Acompanhar?"],"8t9CRE": ["Iniciando ", ["agentName"], "…"],@@ -947,6 +962,9 @@"BQKHuL": ["Reiniciar o terminal"],"BQu9Pg": ["Link simbólico"],"BUyQnq": ["Não deu para reiniciar o servidor. Tente `ok start` nesta pasta."],+ "BVkqD9": [+ "A manutenção do índice está pausada porque outro atributo Git controla index.md. Atualize .gitattributes para que os caminhos index.md com escopo usem merge=union e tente novamente."+ ],"BY-g4_": ["Adicionar padrão"],"Ba4D2x": ["Modelo importado"],"Bdha5y": ["Publicando..."],@@ -965,6 +983,9 @@"Bv5a9_": ["Estatísticas da seleção"],"Bx4EXG": ["Ações de ", ["label"]],"By-7Pn": ["Liga ou desliga uma lista com marcadores."],+ "ByIOcK": [+ "Os arquivos de índice permanecem no lugar. Open Knowledge remove apenas a regra Git adicionada."+ ],"BymzO4": ["Estrutura do documento"],"C-mmmK": ["O id do modelo que seu endpoint serve. O tamanho do vector é detectado automaticamente — esvazie o campo para voltar a ",@@ -1012,6 +1033,9 @@"<0>~/.ok/bin</0> e <1>~/.ok/env.sh</1> permanecem de qualquer forma — o app sempre os mantém."],"CXTwen": ["Não é seguro editar a configuração deste projeto"],+ "CXcveY": [+ "Open Knowledge mantém um arquivo de navegação denominado index.md em cada pasta que contém Markdown, cada um listando os documentos dessa pasta por tipo e vinculando-os às suas subpastas. Ele reescreve esses arquivos à medida que seus documentos são alterados e tudo o que você mesmo edita neles é substituído."+ ],"CXj9C-": ["Nome da nova propriedade"],"C_Lyvh": ["Falha ao salvar a configuração de tema"],"C_WGy8": [@@ -1037,6 +1061,9 @@"Cu6GXQ": ["A pasta de origem em si não se move."],"CvsD6Y": ["via ", ["viaTags"]],"CwOXMT": ["Valor de ", ["keyName"]],+ "CxCOFx": [+ "Em projetos Git, o Open Knowledge adiciona uma regra com escopo ao arquivo .gitattributes na raiz do repositório para combinar alterações simultâneas nos índices."+ ],"CxVk-w": ["Comentar em ", ["address"]],"D-NlUC": ["Sistema"],"D-Oh1s": ["Como configurar ", ["0"], " (abre no navegador)"],@@ -1109,6 +1136,9 @@"DhT_PK": ["OpenKnowledge importou uma habilidade"],"DiFKSL": ["Contando arquivos markdown"],"DiZ3pq": ["Seletor de ícones"],+ "DjNcDy": [+ "As formas de title, description, resource e tags quando você as usa. Nenhum é obrigatório; declarar um apenas fixa seu tipo, então tags escrito como uma string separada por vírgula é sinalizado."+ ],"DmkTrb": ["Não foi possível criar este tema. Tente novamente."],"Dnn2XG": ["Automático"],"DpjYd6": ["Ir para o texto ancorado"],@@ -1347,6 +1377,9 @@"GNkUvW": ["Na fila — será enviado quando esta execução terminar"],"GQ3O42": ["Lixo"],"GQDSBN": ["Opções de layout"],+ "GROUfG": [+ "Qualquer arquivo .mdx. O formato é apenas .md, portanto, um leitor que procura .md nunca o abre - e se existir um .md com o mesmo nome, ele o lê."+ ],"GSYWCm": ["Ocultar o painel do documento"],"GUYwCr": ["Dispensar o aviso"],"GUZHkL": ["Faltam cores na paleta"],@@ -1537,6 +1570,7 @@"IxHMdF": ["Não deu para excluir esse comentário."],"IxyZXD": ["Captura de tela"],"Izh19j": ["Lendo de ", ["tail"]],+ "J0uRhj": ["Verificando habilidade"],"J1XRO3": ["Cores do tema"],"J2Mv98": ["Nome (ex.: ", ["login"], ")"],"J2_JuX": ["nada (", ["0"], " não pode corresponder a um documento)"],@@ -1563,6 +1597,7 @@"JHf6qZ": ["[email protected]"],"JJcBCm": [["0"], " no total"],"JK-Ave": ["Ocultar as miniaturas"],+ "JKXcOi": ["Já em projeto"],"JL3si7": ["Atualizando"],"JLUTgi": ["Ainda não há tags — escreva `#nomedatag` em qualquer documento para preencher o índice."@@ -1662,6 +1697,9 @@"L-rMC9": ["Redefinir para o padrão"],"L1BQTH": [["0"], " ainda não está instalado — abrindo sua página de download."],"L1ZE3M": ["Estatísticas do documento"],+ "L3BcJ4": [+ "Este precisa ver seus arquivos, não apenas o documento aberto, para que apareça quando você executa uma auditoria de projeto, e não enquanto você digita."+ ],"L3CEC1": ["este item"],"L3w0_C": ["Apresente um documento como slides em uma janela própria. Adicione <0>slides: true</0> ao frontmatter de um documento e abra-o com a ação do Slidev. A renderização é feita pela CLI do Slidev, que o OpenKnowledge não inclui."@@ -2162,6 +2200,12 @@"R6ABfU": ["Trabalhar diretamente, sem etapa de planejamento"],"R9IDFz": ["Renomeia a pasta no disco e o id que os agentes usam para invocá-la."],"R9dK63": ["Imagem de exemplo"],+ "RB_g_C": [+ "No índice raiz, okf_version é escrito como uma string entre aspas, como \"0.2\". Sem aspas, YAML lê-o como um número e 0.10 silenciosamente se torna 0.1."+ ],+ "RD6H9q": [+ "Open Knowledge reescreve esses arquivos index.md conforme os documentos são alterados, portanto, as edições manuais neles são substituídas."+ ],"RDjuBN": ["Configuração"],"RDrXh4": ["Configure as opções de usuário, de projeto e de integrações."],"RG3yW6": ["Insira um nome para este tema."],@@ -2231,6 +2275,9 @@"SF9qpO": ["Compartilhe seu e-mail para retorno"],"SFEWV6": ["Não foi possível carregar as habilidades do OpenKnowledge. Tente de novo."],"SFN6dN": ["Título 3"],+ "SIPelo": [+ "A manutenção do índice foi pausada porque Open Knowledge não pôde confirmar a regra de mesclagem Git necessária. Verifique Git e .gitattributes e tente novamente."+ ],"SInSnF": ["Referência <0>", ["0"], "</0>"],"SItQRc": ["O que você acha do OpenKnowledge?"],"SOPwPh": ["Restaurar até esta edição"],@@ -2607,6 +2654,7 @@"X7u0xR": [["0"], " modelos disponíveis"],"X8kjQX": ["Autenticar de novo no GitHub"],"X9VpsP": ["Carregando o conteúdo da pasta"],+ "XAnapw": ["Git regra de mesclagem"],"XAyxsa": ["Extrair ramo remoto"],"XBBZnv": ["O destino do link \"", ["shown"], "\" não corresponde a um documento existente."],"XBgr2S": ["Copiar para cá"],@@ -2739,6 +2787,9 @@"Y_iImT": ["Não foi possível resolver o arquivo ", ["identity"], ". Ir para a referência."],"Y_kL7X": ["Personalize a aparência e o comportamento do editor."],"Ya3PlJ": ["Permissão necessária"],+ "YaVU2F": [+ "Em projetos Git, Open Knowledge também adiciona uma regra .gitattributes com escopo definido para que as alterações de índice simultâneas sejam combinadas antes da próxima reconstrução."+ ],"YaeyFh": ["O pull pode sobrescrever edições sem commit nos seus arquivos locais."],"Yb82LN": ["ID: ", ["0"]],"Yea-K5": ["Restaurar até este ponto"],@@ -2880,6 +2931,7 @@"_Bix3-": ["Ocorrências de ", ["localizedFirstMessage"]],"_DwR-n": ["Criando…"],"_FLBbi": [["sizeText"], " · segredos ocultados · despejo de falha sem ocultação"],+ "_G7A92": ["Manter index.md"],"_GRWOJ": ["Trocar o provedor de embeddings?"],"_HgF9q": ["Ordenar por"],"_IGfXZ": ["Da última vez o OpenKnowledge fechou de forma inesperada."],@@ -2970,10 +3022,12 @@"Não deu para conectar ao serviço de agentes. Confira se o servidor do OpenKnowledge está rodando e atualizado (reinicie se já estava rodando) e tente de novo."],"aalx4E": ["Editando código MDX quebrado: ", ["reason"]],+ "aatPoi": ["Arquivos gerados"],"abiHje": ["Excluir os itens selecionados"],"adsMWO": ["Resolvendo deltas"],"ah_ekO": ["\"", ["name"], "\" já está atualizado"],"aiArms": ["Não foi possível clonar este repositório."],+ "aiOceC": ["Habilitar índices"],"ajHi4O": ["A sincronização automática está pausada — você não tem permissão para enviar a este repositório. Mude para Acompanhar e continue recebendo atualizações."],@@ -3136,11 +3190,13 @@],"cb-0G0": ["Limpar cor"],"ccNps_": ["Somente os modificados"],+ "cd3THN": ["Estrutura do documento"],"cd5EXh": ["Relatar um erro"],"cdm00A": ["Sem entrada"],"cdmk8A": ["Alterações sem commit"],"cgl-gn": ["Conectado ao GitHub"],"chL5IG": ["Comunidade"],+ "ciozf1": ["Habilidade já em projeto"],"cjtjry": ["Volta pelo histórico de navegação do OpenKnowledge."],"cklVjM": ["Linha do tempo"],"clJ3qM": ["Concluído."],@@ -3359,6 +3415,7 @@"fbdLmk": ["Liga ou desliga o negrito."],"fbsiBw": ["Algo deu errado ao iniciar o terminal."],"fcgvCA": ["Claude"],+ "fdKQAE": ["Desligando"],"fdeFfN": ["(arquivo binário, sem pré-visualização)"],"fevEu0": ["Trazer as últimas alterações"],"ffH3Rt": ["Adicionar comentário (Enter)"],@@ -3453,12 +3510,16 @@"gUx34c": ["O idioma que o OpenKnowledge fala; Sistema acompanha o do seu sistema operacional. Suas anotações continuam no idioma em que você as escreveu."],+ "gVMkEr": [+ "Em um documento de registro: os cabeçalhos de entrada levam a uma data ISO YYYY-MM-DD, o mais recente primeiro. Quantos titles você usa e se as entradas são marcadores depende de você."+ ],"gY7wnY": ["Fazendo login em ", ["agentName"], "…"],"gYz2ep": ["Expira em ", ["timeLabel"]],"gZElfU": ["Corrigindo ", ["0"], " de ", ["1"], " arquivos"],"gZiT5e": ["Substituir estes links simbólicos por cópias independentes?"],"gayL_Q": ["Plano de lançamento"],"gbHcbI": ["Falha ao excluir a propriedade"],+ "gfYI3o": ["Desativar ", ["id"]],"gfb-CM": ["Não foi possível obter o ramo — entre no GitHub e tente de novo."],"gfdqcY": ["Não deu para aplicar a alteração: ", ["0"]],"gfohmY": ["Conectar ferramentas"],@@ -3519,6 +3580,9 @@"hLKfZe": ["Usar um token em vez disso"],"hLod4_": ["Converter em modelo"],"hLy8b1": ["Atualizado para a versão ", ["version"]],+ "hPQBsa": [+ "Os arquivos reservados são nomeados index.md e log.md em letras minúsculas. Em um sistema de arquivos que diferencia maiúsculas de minúsculas, Index.md é lido como um documento comum e perde seu significado."+ ],"hQXiDc": ["Buscar ramos..."],"hQjvzi": ["Um arquivo .zip ou .skill."],"hS0wC4": ["OpenKnowledge restaurou uma versão anterior de ", ["subject"]],@@ -3672,6 +3736,9 @@"iz1LdD": ["Alterado fora do OK desde a última vez que ele escreveu aqui — o estado exibido é o que está no disco agora"],+ "j-o6Z2": [+ "A manutenção do índice permaneceu desativada porque não foi possível salvar a configuração do projeto. Verifique as permissões do arquivo do projeto e tente novamente."+ ],"j15ZSH": ["Enviar os comentários para"],"j2229h": ["Removendo os arquivos do OpenKnowledge…"],"j2kt1j": [@@ -3757,6 +3824,7 @@"k4CuuV": ["Pastas e modelos prontos para você começar rápido. Selecione um pacote para ver o que será criado e depois acrescente-o ao seu projeto."],+ "k5rKNs": ["frontmatter"],"k7Hoig": ["Nenhuma alteração de conteúdo nesta versão."],"k8xtrB": ["Não é necessária para um endpoint de localhost como <0>",@@ -3796,7 +3864,9 @@"kV2YZv": ["Não vê <0>Habilidades</0>? Ative antes <1>Configurações <2/> Recursos <3/> Execução de código e criação de arquivos</1>."],+ "kVS5tE": ["Manter índices generated em todas as pastas?"],"kVgQUA": ["Excluir este chat?"],+ "kVzuTI": ["Habilidade recomendada do agente"],"kYL1lH": ["Atividade do agente"],"k_Dqw1": [[@@ -3899,7 +3969,9 @@"lWNpNB": ["Adicione cursores ou selecione ocorrências correspondentes pelo CodeMirror."],"lXKZGw": ["Título 1"],"lY27jj": ["há ", ["0"], " anos"],+ "lY7Unt": ["Habilitando a geração de índice"],"lZAiSP": ["A resposta de retrolinks não tinha o formato esperado."],+ "lZoQdy": ["Habilidade aberta"],"lZvQrY": ["Usar ", ["0"], " como tema escuro"],"l_6JHD": ["Pesquisar ícones..."],"l_FAT6": ["Use apenas letras, dígitos, <0>-</0> ou <1>_</1>."],@@ -3919,6 +3991,9 @@"ljHjfg": ["Esse ramo já está aberto em outro worktree."],"lkYioO": ["Mostrar ou ocultar o painel do documento"],"ll2yNl": ["Diretório de conteúdo"],+ "llXHHh": [+ ["pluginCount", "plural", { "one": ["plugin"], "many": ["plugins"], "other": ["plugins"] }]+ ],"lmBPt0": ["Só os links externos geram uma requisição. Os links para outros documentos deste projeto são pré-visualizados pelo índice local e nunca saem do seu computador."],@@ -4003,6 +4078,9 @@}]],+ "mhnCt3": [+ "Todo documento conceitual carrega um tipo não vazio. Este é todo o piso de conformidade de OKF - um documento com apenas um tipo é totalmente compatível."+ ],"mk2poV": ["ex.: server.ts"],"mlvM8g": ["Não deu para reposicionar esse comentário."],"mmpzAq": ["Quebra as linhas longas no editor de código markdown."],@@ -4281,6 +4359,9 @@"qRZh7J": ["Deixar o Tab sair do editor de código em vez de recuar."],"qSKu2v": ["Navegação e seleção no código"],"qSxaOz": ["Aceitar a exclusão deles"],+ "qTT48-": [+ "Links Wiki como [[Page]] — uma forma suportada de vincular aqui, mas um leitor externo não resolve nada e mostra os colchetes."+ ],"qTcVwj": ["Procure ou envie uma habilidade para este projeto."],"qTcZZu": ["Falha ao carregar as tags. Pressione <0>Esc</0> e abra de novo para tentar outra vez."@@ -4340,6 +4421,7 @@"r51jLC": ["Arquivo salvo e app Claude Desktop aberto"],"r6ncaO": ["Fechar aba"],"r6y-jM": ["Aviso"],+ "r7IaYp": ["Open Knowledge Format orientação"],"r871ed": ["Sua base de conhecimento já está no GitHub, em <0>",["ownerLogin"],@@ -4369,6 +4451,9 @@"rZVMkf": ["Campo de substituição do editor visual em foco"],"radOpL": ["Imagem ", ["identity"], ". Ir para a referência."],"rageVb": ["HTML personalizado com painel de pré-visualização ao vivo (iframe isolado)."],+ "rarziH": [+ "Ajuda os agentes de codificação a escolher tipos de documentos OKF, preservar a proveniência e evitar a invenção de metadados não suportados."+ ],"rbrHTd": ["Aprovado — ", ["optionName"]],"rcJmK8": ["Converter os locais em cópias"],"rdU729": ["Layout"],@@ -4427,6 +4512,7 @@"sER-bs": ["Arquivos"],"sFhaTJ": ["Distingue modelos com nomes parecidos no menu."],"sGZLfB": ["Falha ao obter os repositórios"],+ "sHDllh": ["Pare de manter index.md"],"sICrVf": ["A versão de ", ["0"], " foi restaurada"],"sIGbBZ": ["Converter a seleção em nota de rodapé"],"sIxSSP": ["Resolva o conflito no seu terminal"],@@ -4440,6 +4526,7 @@"sOxZaS": ["Falha ao carregar o grafo"],"sQoLn0": ["Sair"],"sR0I-f": ["Recolher todos os arquivos"],+ "sSRndh": ["Comece a manter index.md"],"sW5OjU": ["obrigatório"],"sZ2IOu": ["Este ",@@ -4454,6 +4541,9 @@"saIASg": ["Segundo item"],"saYiIO": ["O caminho não pode conter bytes nulos"],"scu3wk": ["Modelo"],+ "scyoP9": [+ "Os documentos de índice não carregam frontmatter, exceto aquele na raiz da sua base de conhecimento. Os documentos de log não são cobertos — OKF não restringe seu frontmatter."+ ],"se-tU0": ["Não foi possível corrigir ", ["0"], " de ", ["total"], " arquivos."],"seeS6l": ["Configurar o OpenKnowledge nesta pasta?"],"sgmRY8": ["O download de ", ["0"], " foi pulado."],@@ -4514,6 +4604,9 @@"tHKQ6j": ["Renomeando"],"tKlWWY": ["Emoji"],"tLX6LY": ["OpenKnowledge escreveu um documento"],+ "tM5uzl": [+ "As famílias de origem, confiança e ciclo de vida: sources, generated, verified, status e stale_after. Cada campo é opcional e a ausência nunca é um erro."+ ],"tN5WTS": ["O provedor recusou a requisição. Verifique a chave de API e o id do modelo."],"tP5DDk": ["Aplicar link"],"tUvUfp": ["Use uma pasta que você já tem."],@@ -4582,6 +4675,9 @@"uGaIIS": ["Extrair worktree"],"uH_S-u": [["loadErrorTitle"], ": ", ["message"]],"uJfwF8": ["Já instalado — nada novo para importar."],+ "uK2peg": [+ "Verifica seu projeto em relação ao Open Knowledge Format. Desligue-o a qualquer momento nas Configurações."+ ],"uKRYiW": ["Status de sincronização indisponível — erro do servidor."],"uL_Wx8": ["O terminal parou de forma inesperada."],"uM6jnS": ["Falha ao restaurar"],@@ -4643,6 +4739,9 @@"uyOQ4e": ["Tema copiado como YAML base16"],"uynXup": [["tokens", "plural", { "one": ["token"], "many": ["tokens"], "other": ["tokens"] }]],"v-h2hx": ["Excluir ", ["targetGitPath"]],+ "v15iQB": [+ "O contrato de computação atestada. Aplica-se apenas a documentos digitados Attested Computation, onde OKF requer um runtime; conceitos comuns não são afetados."+ ],"v2ZW0K": ["Ativar o terminal"],"v2a04T": ["Regras do markdownlint"],"v41fCm": ["Arquivo não encontrado"],diff --git a/packages/app/src/locales/pt-BR/messages.po b/packages/app/src/locales/pt-BR/messages.poindex 46c85150f..5f744d129 100644--- a/packages/app/src/locales/pt-BR/messages.po+++ b/packages/app/src/locales/pt-BR/messages.po@@ -263,6 +263,11 @@ msgstr "{0, plural, one {No momento, corresponde a {1} de {2} documento.} many {msgid "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"msgstr "{0, plural, one {Nenhum problema em # documento.} many {Nenhum problema em # documentos.} other {Nenhum problema em # documentos.}}"+#. placeholder {0}: pluginRows.length+#: src/components/CreatedItemsList.tsx+msgid "{0, plural, one {Plugin} other {Plugins}}"+msgstr "{0, plural, one {Plugin} many {Plugins} other {Plugins}}"+#. placeholder {0}: editorList.hiddenCount#: src/components/McpConsentDialogBody.tsxmsgid "{0, plural, one {Show # more tool} other {Show # more tools}}"@@ -629,7 +634,9 @@ msgstr "CLI do {displayName}, {hint}"msgid "{docName} is {0}. OpenKnowledge currently opens files up to {1}."msgstr "{docName} ocupa {0}. Por enquanto, o OpenKnowledge abre arquivos de até {1}."+#. placeholder {0}: OKF_RULE_IDS.length#. placeholder {0}: entries.length+#: src/components/settings/LintingSection.tsx#: src/components/settings/markdownlint-rule-browser.tsxmsgid "{enabledCount}/{0} on"msgstr "{enabledCount}/{0} ativos"@@ -792,6 +799,10 @@ msgstr "{percent}% usado (restam {left}%)"msgid "{phase} — {pct}%"msgstr "{phase} — {pct}%"+#: src/components/CreatedItemsList.tsx+msgid "{pluginCount, plural, one {plugin} other {plugins}}"+msgstr "{pluginCount, plural, one {plugin} many {plugins} other {plugins}}"+#: src/components/PropertyDisclosure.tsxmsgid "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"msgstr "{problemCount, plural, one {# propriedade não corresponde ao esquema} many {# propriedades não correspondem ao esquema} other {# propriedades não correspondem ao esquema}}"@@ -1543,6 +1554,10 @@ msgstr "Já coberta por uma pasta principal selecionada"msgid "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."msgstr "Já tem um repositório git? Adicione-o com <0>git remote add origin <url></0> na pasta deste projeto. Esta página se atualiza sozinha assim que um remoto for detectado."+#: src/components/settings/LintingSection.tsx+msgid "Already in project"+msgstr "Já em projeto"+#: src/components/SkillPluginBundleDialog.tsxmsgid "Already installed — nothing new to import."msgstr "Já instalado — nada novo para importar."@@ -1588,6 +1603,10 @@ msgstr "Outra operação de sincronização está em andamento. Tente de novo emmsgid "any"msgstr "qualquer"+#: src/components/settings/LintingSection.tsx+msgid "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+msgstr "Qualquer arquivo .mdx. O formato é apenas .md, portanto, um leitor que procura .md nunca o abre - e se existir um .md com o mesmo nome, ele o lê."+#. placeholder {0}: summary.name#: src/components/settings/LintingSection.tsxmsgid "any doc named {0}"@@ -2148,6 +2167,7 @@ msgstr "Não é possível compartilhar este caminho."#: src/components/ReportBugDialogBody.tsx#: src/components/SeedDialog.tsx#: src/components/settings/LinkPreviewsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/SavedThemesTiles.tsx#: src/components/settings/SearchSection.tsx#: src/components/ShareBranchSwitchDialog.tsx@@ -2288,6 +2308,10 @@ msgstr "Extraindo arquivos"msgid "Checking sign-in status"msgstr "Verificando o estado da sessão"+#: src/components/settings/LintingSection.tsx+msgid "Checking skill"+msgstr "Verificando habilidade"+#: src/components/ImportSkillForm.tsxmsgid "Checking source"msgstr "Verificando a fonte"@@ -2304,6 +2328,10 @@ msgstr "Verificando..."msgid "Checklist with checkboxes."msgstr "Lista de verificação com caixas de seleção."+#: src/components/CreatedItemsList.tsx+msgid "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+msgstr "Verifica seu projeto em relação ao Open Knowledge Format. Desligue-o a qualquer momento nas Configurações."+#: src/components/ImportSkillForm.tsxmsgid "Choose a skill archive"msgstr "Escolha um arquivo de habilidade"@@ -4300,6 +4328,10 @@ msgstr "Desativar {0}"msgid "Disable {file}"msgstr "Desativar {file}"+#: src/components/settings/LintingSection.tsx+msgid "Disable {id}"+msgstr "Desativar {id}"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "Disable external link previews"msgstr "Desativar a pré-visualização de links externos"@@ -4402,6 +4434,10 @@ msgstr "Painéis do documento"msgid "Document statistics"msgstr "Estatísticas do documento"+#: src/components/settings/LintingSection.tsx+msgid "Document structure"+msgstr "Estrutura do documento"+#: src/components/empty-state/use-create-suggestions.tsmsgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."msgstr "Documente a arquitetura deste repositório: crie uma página geral que aponte para uma página por módulo principal descrevendo suas responsabilidades e seus pontos de entrada."@@ -4793,6 +4829,10 @@ msgstr "Ativar a CLI do {displayName}"msgid "Enable {file}"msgstr "Ativar {file}"+#: src/components/settings/LintingSection.tsx+msgid "Enable {id}"+msgstr "Habilitar {id}"+#: src/components/AutoSyncOnboardingDialog.tsx#: src/components/EnableSyncConfirmDialog.tsx#: src/components/share-receive-miss-content.tsx@@ -4817,6 +4857,10 @@ msgstr "Ativar Acompanhar?"msgid "Enable git auto-sync?"msgstr "Ativar a sincronização automática do git?"+#: src/components/settings/LintingSection.tsx+msgid "Enable indexes"+msgstr "Habilitar índices"+#: src/components/ProblemsPanel.tsxmsgid "Enable plugins"msgstr "Ativar os plugins"@@ -4845,6 +4889,10 @@ msgstr "Ativar o terminal neste projeto"msgid "Enable Themes"msgstr "Ativar os temas"+#: src/components/settings/LintingSection.tsx+msgid "Enabling index generation"+msgstr "Habilitando a geração de índice"+#: src/components/ActivityModeContent.tsxmsgid "Ended"msgstr "Encerrado"@@ -4915,6 +4963,10 @@ msgstr "Erro:"msgid "Escape"msgstr "Esc"+#: src/components/settings/LintingSection.tsx+msgid "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+msgstr "Todo documento conceitual carrega um tipo não vazio. Este é todo o piso de conformidade de OKF - um documento com apenas um tipo é totalmente compatível."+#: src/components/settings/LintingSection.tsxmsgid "every doc"msgstr "todos os documentos"@@ -5690,6 +5742,10 @@ msgstr "A partir de um modelo"msgid "From the {0} plugin"msgstr "Do plugin {0}"+#: src/components/settings/LintingSection.tsx+msgid "Frontmatter"+msgstr "frontmatter"+#: src/components/TemplateForm.tsxmsgid "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."msgstr "O frontmatter com que começa cada documento criado a partir deste modelo. Os valores são YAML — uma lista é <0>[a, b]</0>; <1>{{date}}</1> é preenchido na criação."@@ -5732,6 +5788,10 @@ msgstr "Fim de jogo · pressione espaço para jogar de novo"msgid "General"msgstr "Geral"+#: src/components/settings/LintingSection.tsx+msgid "Generated files"+msgstr "Arquivos gerados"+#: src/components/TerminalCliMissingBanner.tsxmsgid "Get {displayName}"msgstr "Obter {displayName}"@@ -5765,6 +5825,10 @@ msgstr "a configuração do git não está disponível"msgid "Git identity isn't set — commits use a default author. Set yours so teammates see your name."msgstr "Sua identidade do git não está definida — os commits usam um autor padrão. Defina a sua para que os colegas vejam seu nome."+#: src/components/settings/LintingSection.tsx+msgid "Git merge rule"+msgstr "Git regra de mesclagem"+#: src/components/ShareBranchSwitchDialog.tsxmsgid "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."msgstr "O git precisa de {tool} para este repositório, mas ele não está instalado nem foi encontrado. Instale-o e tente de novo."@@ -5919,7 +5983,7 @@ msgstr "slug-do-titulo"msgid "Headings"msgstr "Títulos"-#: src/components/AutoSyncEnableWarning.tsx+#: src/components/DisclosureWarning.tsx#: src/editor/slash-command/component-items.tsxmsgid "Heads up"msgstr "Atenção"@@ -5941,6 +6005,10 @@ msgstr "Olá, mundo!"msgid "Help"msgstr "Ajuda"+#: src/components/settings/LintingSection.tsx+msgid "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+msgstr "Ajuda os agentes de codificação a escolher tipos de documentos OKF, preservar a proveniência e evitar a invenção de metadados não suportados."+#. Subtext for the open-knowledge-discovery skill row#. Subtext for the open-knowledge-discovery skill row#: src/components/McpConsentDialogBody.tsx@@ -6273,10 +6341,18 @@ msgstr "Importado como \"{0}\" — o nome \"{1}\" já estava em uso."msgid "Importing"msgstr "Importando"+#: src/components/settings/LintingSection.tsx+msgid "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+msgstr "Em um documento de registro: os cabeçalhos de entrada levam a uma data ISO YYYY-MM-DD, o mais recente primeiro. Quantos titles você usa e se as entradas são marcadores depende de você."+#: src/components/SeedDialog.tsxmsgid "In a subfolder"msgstr "Em uma subpasta"+#: src/components/settings/LintingSection.tsx+msgid "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+msgstr "Em um documento de índice: as entradas ficam sob o título de uma seção e cada uma carrega um link. A prosa em torno das listas está bem."+#: src/components/empty-state/CreatePromptComposer.tsx#: src/components/handoff/AgentSplitButton.tsx#: src/components/handoff/OpenInAgentContextSubmenu.tsx@@ -6295,6 +6371,14 @@ msgstr "No app"msgid "In app (beta)"msgstr "No app (beta)"+#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+msgstr "Em projetos Git, o Open Knowledge adiciona uma regra com escopo ao arquivo .gitattributes na raiz do repositório para combinar alterações simultâneas nos índices."++#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+msgstr "Em projetos Git, Open Knowledge também adiciona uma regra .gitattributes com escopo definido para que as alterações de índice simultâneas sejam combinadas antes da próxima reconstrução."+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "In the Claude Desktop App"msgstr "No app Claude Desktop"@@ -6319,6 +6403,26 @@ msgstr "Aumenta ou diminui o recuo do item de lista atual."msgid "Indented blockquote for citations."msgstr "Citação em bloco recuada para citar fontes."+#: src/components/settings/LintingSection.tsx+msgid "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+msgstr "Os documentos de índice não carregam frontmatter, exceto aquele na raiz da sua base de conhecimento. Os documentos de log não são cobertos — OKF não restringe seu frontmatter."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+msgstr "A manutenção do índice está pausada porque outro atributo Git controla index.md. Atualize .gitattributes para que os caminhos index.md com escopo usem merge=union e tente novamente."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+msgstr "A manutenção do índice foi pausada porque Open Knowledge não pôde confirmar a regra de mesclagem Git necessária. Verifique Git e .gitattributes e tente novamente."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+msgstr "A manutenção do índice permaneceu desativada porque Open Knowledge não conseguiu acessar o servidor do projeto. Tente novamente quando o projeto for reconectado."++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+msgstr "A manutenção do índice permaneceu desativada porque não foi possível salvar a configuração do projeto. Verifique as permissões do arquivo do projeto e tente novamente."+#: src/components/settings/SearchSection.tsxmsgid "Indexed {embedded} of {total} pages."msgstr "{embedded} de {total} páginas indexadas."@@ -6507,6 +6611,10 @@ msgstr "Instalar em todos os agentes"msgid "Install selected"msgstr "Instalar os selecionados"+#: src/components/settings/LintingSection.tsx+msgid "Install skill"+msgstr "Instalar habilidade"+#: src/components/SkillPluginBundleBanner.tsxmsgid "Install skills"msgstr "Instalar habilidades"@@ -6516,6 +6624,7 @@ msgid "Install the gh CLI"msgstr "Instalar a CLI gh"#: src/components/settings/AiToolsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ProjectAiToolsSection.tsx#: src/components/SkillEditorActions.tsxmsgid "Installed"@@ -6729,6 +6838,10 @@ msgstr "Mantenha este projeto em sincronia com seu remoto do git. Acompanhar busmsgid "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."msgstr "Acompanhe as pessoas e empresas com quem você trabalha e as reuniões que tem com elas. Bom para lembrar quem é alguém, de onde você a conhece e sobre o que vocês falaram da última vez."+#: src/components/settings/LintingSection.tsx+msgid "Keeps your knowledge base aligned with the Open Knowledge Format."+msgstr "Mantém sua base de conhecimento alinhada ao Open Knowledge Format."+#. placeholder {0}: toName.trim()#: src/components/SkillForkDialog.tsxmsgid "Kept both — \"{0}\" is its own skill now"@@ -7104,6 +7217,14 @@ msgstr "Procurando <0>{lookingForUrl}</0>."msgid "Lost connection to \"{docName}\"."msgstr "A conexão com \"{docName}\" foi perdida."+#: src/components/settings/LintingSection.tsx+msgid "Maintain generated indexes in every folder?"+msgstr "Manter índices generated em todas as pastas?"++#: src/components/settings/LintingSection.tsx+msgid "Maintain index.md"+msgstr "Manter index.md"+#: src/components/SkillInstallMenu.tsxmsgid "make source"msgstr "tornar fonte"@@ -8248,6 +8369,10 @@ msgstr "OK Desktop"msgid "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."msgstr "Da última vez o OK deixou esta pasta como {0} — algo fora do OK mudou isso desde então. O estado exibido é o que está no disco agora; o seu próximo Vincular/Desvincular prevalece."+#: src/components/settings/LintingSection.tsx+msgid "OKF agent skill installed"+msgstr "OKF habilidade do agente instalada"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "On — hovering an external link sends its URL to the destination site to fetch a preview."msgstr "Ligada — passar o cursor sobre um link externo envia a URL dele ao site de destino para buscar uma pré-visualização."@@ -8264,6 +8389,10 @@ msgstr "Em <0>{address}</0>"msgid "On selected text in <0>{address}</0>"msgstr "Sobre o texto selecionado em <0>{address}</0>"+#: src/components/settings/LintingSection.tsx+msgid "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+msgstr "No índice raiz, okf_version é escrito como uma string entre aspas, como \"0.2\". Sem aspas, YAML lê-o como um número e 0.10 silenciosamente se torna 0.1."+#. Next step for a Cursor project MCP row — Cursor leaves project servers disabled#: src/components/settings/ProjectAiToolsSection.tsxmsgid "One more step: enable it in Cursor → Settings → Tools & MCP (Cursor leaves project servers off until you turn them on)."@@ -8486,6 +8615,22 @@ msgstr "Abrir em um worktree"msgid "Open it there"msgstr "Abrir por lá"+#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+msgstr "Open Knowledge cria e mantém um arquivo de navegação denominado index.md em cada pasta que contém Markdown."++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge Format guidance"+msgstr "Open Knowledge Format orientação"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+msgstr "Open Knowledge mantém um arquivo de navegação denominado index.md em cada pasta que contém Markdown, cada um listando os documentos dessa pasta por tipo e vinculando-os às suas subpastas. Ele reescreve esses arquivos à medida que seus documentos são alterados e tudo o que você mesmo edita neles é substituído."++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+msgstr "Open Knowledge reescreve esses arquivos index.md conforme os documentos são alterados, portanto, as edições manuais neles são substituídas."+#. placeholder {0}: item.displayName#. placeholder {1}: item.displayName#. placeholder {2}: item.version@@ -8532,6 +8677,10 @@ msgstr "Abrir as configurações"msgid "Open shared {targetNoun}"msgstr "Abrir {targetNoun} compartilhado"+#: src/components/settings/LintingSection.tsx+msgid "Open skill"+msgstr "Habilidade aberta"+#: src/editor/extensions/JsxComponentView.tsxmsgid "Open source doc: {mirrorSrc}"msgstr "Abrir o documento de origem: {mirrorSrc}"@@ -9368,6 +9517,7 @@ msgid "project"msgstr "projeto"#: src/components/CommandPalette.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ScopeBadge.tsx#: src/lib/skill-scope.tsmsgid "Project"@@ -9639,6 +9789,10 @@ msgstr "Projeto recente"msgid "Recently opened"msgstr "Abertos recentemente"+#: src/components/settings/LintingSection.tsx+msgid "Recommended agent skill"+msgstr "Habilidade recomendada do agente"+#: src/components/SyncStatusBadge.tsxmsgid "Reconnect required"msgstr "É preciso reconectar"@@ -10076,6 +10230,10 @@ msgstr "Pesquisar a extinção das aves que não voam"msgid "research-note"msgstr "nota-de-pesquisa"+#: src/components/settings/LintingSection.tsx+msgid "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+msgstr "Os arquivos reservados são nomeados index.md e log.md em letras minúsculas. Em um sistema de arquivos que diferencia maiúsculas de minúsculas, Index.md é lido como um documento comum e perde seu significado."+#: src/components/settings/CustomThemeEditor.tsxmsgid "Reset"msgstr "Redefinir"@@ -10318,6 +10476,7 @@ msgid "Rule editing is available for the project's root markdownlint config"msgstr "A edição de regras está disponível para a configuração raiz do markdownlint do projeto"#: src/components/LintConfigEditor.tsx+#: src/components/settings/LintingSection.tsxmsgid "Rules"msgstr "Regras"@@ -11260,6 +11419,10 @@ msgstr "A skill “{conflictName}” não foi instalada para {conflictHosts} —msgid "Skill \"{name}\" created"msgstr "Habilidade \"{name}\" criada"+#: src/components/settings/LintingSection.tsx+msgid "Skill already in project"+msgstr "Habilidade já em projeto"+#: src/components/ExploreSkills.tsxmsgid "Skill discovery powered by <0>skills.sh</0>"msgstr "Descoberta de habilidades por <0>skills.sh</0>"@@ -11519,6 +11682,10 @@ msgstr "Começar a partir de"msgid "Start here: what this is and how it's organized."msgstr "Comece por aqui: o que é isto e como está organizado."+#: src/components/settings/LintingSection.tsx+msgid "Start maintaining index.md"+msgstr "Comece a manter index.md"+#: src/lib/keyboard-shortcuts.tsmsgid "Start source completion"msgstr "Iniciar o autocompletar do código"@@ -11614,6 +11781,10 @@ msgstr "Parar de corrigir arquivos"msgid "Stop fixing. Files already fixed stay fixed."msgstr "Para de corrigir. Os arquivos já corrigidos continuam corrigidos."+#: src/components/settings/LintingSection.tsx+msgid "Stop maintaining index.md"+msgstr "Pare de manter index.md"+#: src/lib/project-fix-sweep-store.tsmsgid "Stopped fixing. Files already fixed stay fixed."msgstr "A correção parou. Os arquivos já corrigidos continuam corrigidos."@@ -12117,6 +12288,10 @@ msgstr "O agente não está parando. A parada forçada fecha este chat e encerramsgid "The agent's persona, values, and voice."msgstr "A personalidade, os valores e a voz do agente."+#: src/components/settings/LintingSection.tsx+msgid "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+msgstr "O contrato de computação atestada. Aplica-se apenas a documentos digitados Attested Computation, onde OKF requer um runtime; conceitos comuns não são afetados."+#: src/components/ProblemsPanel.tsxmsgid "The audit could not be completed. Try again."msgstr "Não foi possível concluir a auditoria. Tente de novo."@@ -12175,6 +12350,10 @@ msgstr "A fórmula <0>c = √(a² + b²)</0> é renderizada em linha."msgid "the git exclude file isn't writable"msgstr "o arquivo de exclusão do git não permite escrita"+#: src/components/settings/LintingSection.tsx+msgid "The index files stay in place. Open Knowledge removes only the Git rule it added."+msgstr "Os arquivos de índice permanecem no lugar. Open Knowledge remove apenas a regra Git adicionada."+#: src/lib/locale-load-failure-notice.tsmsgid "The interface is still in the language you were reading. Check your connection, then reload to try again."msgstr "A interface continua no idioma que você estava lendo. Verifique sua conexão e recarregue para tentar de novo."@@ -12211,6 +12390,10 @@ msgstr "O bloco de propriedades no topo deste documento tem um erro de formataçmsgid "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."msgstr "As propriedades mudaram, mas não foi possível compará-las — o YAML não pôde ser analisado. As duas versões são exibidas como foram escritas."+#: src/components/settings/LintingSection.tsx+msgid "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+msgstr "As famílias de origem, confiança e ciclo de vida: sources, generated, verified, status e stale_after. Cada campo é opcional e a ausência nunca é um erro."+#: src/components/settings/SearchSection.tsxmsgid "The provider is rate-limiting this key. Try again in a moment."msgstr "O provedor está limitando a frequência desta chave. Tente de novo em instantes."@@ -12248,6 +12431,10 @@ msgstr "O arquivo de esquema não existe ou falhou ao carregar — adicionar ummsgid "the server responded but server.lock has no port yet"msgstr "o servidor respondeu, mas o server.lock ainda não tem porta"+#: src/components/settings/LintingSection.tsx+msgid "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+msgstr "As formas de title, description, resource e tags quando você as usa. Nenhum é obrigatório; declarar um apenas fixa seu tipo, então tags escrito como uma string separada por vírgula é sinalizado."+#: src/components/SkillInstallMenu.tsxmsgid "The skill's own folder — the source other locations copy or link from"msgstr "A pasta própria da habilidade — a fonte de onde os outros locais copiam ou para onde apontam"@@ -12561,6 +12748,10 @@ msgstr "Isto pode demorar um pouco. Seu conteúdo markdown é preservado."msgid "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."msgstr "Isto move <0>{name}</0> de {0} para {1}, realocando os arquivos dela no disco e reinstalando-a nos seus editores no nível {2}."+#: src/components/settings/LintingSection.tsx+msgid "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+msgstr "Este precisa ver seus arquivos, não apenas o documento aberto, para que apareça quando você executa uma auditoria de projeto, e não enquanto você digita."+#: src/components/SeedDialog.tsxmsgid "This pack is already set up here."msgstr "Este pacote já está configurado aqui."@@ -12924,6 +13115,10 @@ msgstr "Transforma {0} de volta em um diretório real com um link simbólico pormsgid "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."msgstr "Transforma {display} de volta em um diretório real com um link simbólico por habilidade para cada uma que ele enxerga agora — nada para de funcionar, e daí em diante o menu de cada habilidade cuida dela."+#: src/components/CreatedItemsList.tsx+msgid "Turn it off any time in Settings."+msgstr "Desligue-o a qualquer momento nas Configurações."+#: src/components/NotInSidebarIndicator.tsxmsgid "Turn off Only markdown files"msgstr "Desligar Somente arquivos markdown"@@ -12949,6 +13144,10 @@ msgstr "Ligar a busca semântica?"msgid "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."msgstr "Transforme o que você lê em artigos claros e confiáveis. Salve uma fonte, descubra o que ela significa e guarde a versão final para poder se apoiar nela depois."+#: src/components/settings/LintingSection.tsx+msgid "Turning it off"+msgstr "Desligando"+#: src/components/acp/working-status.tsmsgid "Turning it over…"msgstr "Remoendo…"@@ -13639,6 +13838,10 @@ msgstr "Link wiki"msgid "Wiki link suggestions"msgstr "Sugestões de link wiki"+#: src/components/settings/LintingSection.tsx+msgid "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+msgstr "Links Wiki como [[Page]] — uma forma suportada de vincular aqui, mas um leitor externo não resolve nada e mostra os colchetes."+#: src/components/PublishToGitHubDialog.tsxmsgid "Will be created as <0>{sanitizedName}</0>"msgstr "Será criado como <0>{sanitizedName}</0>"diff --git a/packages/app/src/locales/ur/messages.json b/packages/app/src/locales/ur/messages.jsonindex b3b415b3e..4430b2252 100644--- a/packages/app/src/locales/ur/messages.json+++ b/packages/app/src/locales/ur/messages.json@@ -119,6 +119,9 @@"0ySP5u": ["تبدیلیاں خودکار طور پر اس تھیم میں محفوظ ہو جاتی ہیں۔"],"0zAhu6": ["ہر دستاویز"],"10g8I_": ["«صرف Markdown فائلیں» بند کریں"],+ "110eEb": [+ "Open Knowledge ہر فولڈر میں index.md نامی نیویگیشن فائل بناتا اور برقرار رکھتا ہے جس میں Markdown ہوتا ہے۔"+ ],"11ukmX": ["نام بدلنا ناکام: ", ["0"]],"12F9WL": ["(کوئی شناخت نہیں)"],"151wvk": ["سائیڈ بار دکھائیں"],@@ -136,6 +139,9 @@"1GhYxC": [["totalPages"], " میں سے"],"1HBhDS": ["فائلیں چیک آؤٹ کی جا رہی ہیں"],"1J0c0X": [["displayName"], " تک اب بھی رسائی نہیں ہو سکی۔ ایک بار اور کوشش کریں؟"],+ "1JpLgH": [+ "انڈیکس دستاویز میں: اندراجات ایک سیکشن کی سرخی کے نیچے بیٹھتے ہیں اور ہر ایک میں ایک لنک ہوتا ہے۔ فہرستوں کے ارد گرد نثر ٹھیک ہے."+ ],"1LtA5r": ["مہارت کو ", ["path"], " سے سِم لنک کرتا ہے"],"1MGRQl": ["ٹرمینل کے سیشنز"],"1NgrlY": ["انسٹال کرنے کے دیگر طریقے"],@@ -149,6 +155,7 @@"1XSMhZ": ["<0>local-only</0> پر بدلنا اس وقت تک انکار کرے گا جب تک انہیں<1> git rm --cached</1> سے غیر ٹریک شدہ نہ کیا جائے۔"],+ "1ZXkqM": ["اسے کسی بھی وقت ترتیبات میں بند کریں۔"],"1ZpfyB": ["AI ", ["displayName"], " کے ساتھ کھولیں، ", ["hint"]],"1a6ICf": ["ایجنٹ کی ترامیم کی پیروی جاری ہے"],"1bDVu5": ["ورک اسپیس کمانڈ پیلیٹ"],@@ -289,6 +296,8 @@"3o3tur": ["ابتدائی مواد"],"3oh0nQ": [["path"], " میں نیسٹڈ .okignore کی خرابی"],"3pU8e-": ["ٹیب پن کریں"],+ "3qDsdf": ["مہارت کو انسٹال کریں۔"],+ "3ri_4O": ["آپ کے علمی ذخیرے کو Open Knowledge Format کے مطابق رکھتا ہے۔"],"3s-k7L": [["0", "plural", { "one": ["#", " مزید ٹول دکھائیں"], "other": ["#", " مزید ٹولز دکھائیں"] }]],@@ -437,6 +446,9 @@],"5tcmwY": ["قدر شامل کریں"],"5vAI6Z": ["یہ میرے ورک فلو میں فٹ نہیں بیٹھا"],+ "5w38tn": [+ "انڈیکس کی دیکھ بھال بند رہی کیونکہ Open Knowledge پروجیکٹ سرور تک نہیں پہنچ سکا۔ جب پروجیکٹ دوبارہ جڑ جائے تو دوبارہ کوشش کریں۔"+ ],"5wV2qQ": ["اور مزید"],"5y_9lO": ["اجازت کا انتظار ہے"],"6-wLTJ": [["behind"], " origin سے پیچھے"],@@ -573,6 +585,7 @@"7d1a0d": ["عوامی"],"7dZnmw": ["مطابقت"],"7hctf2": ["جو پروجیکٹ آپ بنانا چاہتے ہیں اسے بیان کریں"],+ "7idx48": ["OKF ایجنٹ کی مہارت انسٹال ہوگئی"],"7jIIFX": ["آپ کا سب کچھ تیار ہے!"],"7kb4LU": ["منظور شدہ"],"7l15X4": ["ناکام"],@@ -580,6 +593,7 @@"7m3Ade": ["تنصیبات:"],"7qRHf0": ["Claude Chat اور Cowork کے لیے نصب کریں"],"7uBlRT": ["فوکس شدہ فائل ٹری آئٹم نقل کریں تاکہ «چسپاں» اس کی نقل بنا سکے۔"],+ "7wogIQ": [["0", "plural", { "one": ["پلگ اِن"], "other": ["پلگ اِنز"] }]],"80c4-P": ["کوڈ کلپ بورڈ پر نقل ہو گیا"],"81H_23": ["خصوصیات شامل کریں"],"851WA-": ["یہ ترتیبات > AI ٹولز اور CLI میں مقرر کیا جا سکتا ہے"],@@ -639,6 +653,7 @@"8nWu1k": ["خالی خاکہ"],"8oWgty": ["بھیجنے کے لیے تمام تبصرے منتخب کریں"],"8qgfac": ["MCP سرورز"],+ "8rZ1pk": [["id"], " کو فعال کریں"],"8ruqQi": ["ٹوٹے ہوئے داخلی لنکس"],"8sMErm": ["پیروی فعال کریں؟"],"8t9CRE": [["agentName"], " شروع کیا جا رہا ہے…"],@@ -814,6 +829,9 @@"BQKHuL": ["ٹرمینل دوبارہ چلائیں"],"BQu9Pg": ["سِم لنک"],"BUyQnq": ["سرور دوبارہ نہیں چل سکا۔ اس فولڈر میں `ok start` آزمائیں۔"],+ "BVkqD9": [+ "انڈیکس کی دیکھ بھال موقوف ہے کیونکہ ایک اور Git وصف کنٹرول کرتا ہے index.md۔ .gitattributes کو اپ ڈیٹ کریں تاکہ دائرہ کار والے index.md راستے merge=union استعمال کریں، پھر دوبارہ کوشش کریں۔"+ ],"BY-g4_": ["پیٹرن شامل کریں"],"Ba4D2x": ["ٹیمپلیٹ درآمد ہو گیا"],"Bdha5y": ["شائع کیا جا رہا ہے..."],@@ -832,6 +850,9 @@"Bv5a9_": ["انتخاب کے اعداد و شمار"],"Bx4EXG": [["label"], " کے لیے اعمال"],"By-7Pn": ["بلٹ فہرست بدلیں۔"],+ "ByIOcK": [+ "انڈیکس فائلیں اپنی جگہ پر رہتی ہیں۔ Open Knowledge صرف اس Git اصول کو ہٹاتا ہے جو اس نے شامل کیا ہے۔"+ ],"BymzO4": ["دستاویز کا خاکہ"],"C-mmmK": ["وہ ماڈل شناخت جو آپ کا اینڈ پوائنٹ فراہم کرتا ہے۔ اس کا ویکٹر حجم خودکار طور پر معلوم ہو جاتا ہے — ",@@ -873,6 +894,9 @@"<0>~/.ok/bin</0> اور <1>~/.ok/env.sh</1> دونوں صورتوں میں رہتے ہیں — ایپ ہمیشہ ان کی دیکھ بھال کرتی ہے۔"],"CXTwen": ["اس پروجیکٹ کی کنفیگ محفوظ طریقے سے ترمیم نہیں کی جا سکتی"],+ "CXcveY": [+ "Open Knowledge ہر فولڈر میں index.md نامی ایک نیویگیشن فائل کو برقرار رکھتا ہے جس میں Markdown ہوتا ہے، ہر ایک فولڈر کے دستاویزات کو ٹائپ اور اس کے ذیلی فولڈرز سے لنک کرکے درج کرتا ہے۔ یہ ان فائلوں کو دوبارہ لکھتا ہے جیسے آپ کی دستاویزات تبدیل ہوتی ہیں، اور جو کچھ بھی آپ خود ان میں ترمیم کرتے ہیں اسے تبدیل کر دیا جاتا ہے۔"+ ],"CXj9C-": ["نئی خصوصیت کا نام"],"C_Lyvh": ["تھیم کی ترتیب محفوظ نہیں ہو سکی"],"C_WGy8": [@@ -896,6 +920,9 @@"Cu6GXQ": ["ماخذ فولڈر خود نہیں ہلتا۔"],"CvsD6Y": [["viaTags"], " کے ذریعے"],"CwOXMT": [["keyName"], " کی قدر"],+ "CxCOFx": [+ "Git پروجیکٹس میں، Open Knowledge ریپوزٹری کی روٹ .gitattributes فائل میں محدود دائرۂ کار کا اصول شامل کرتا ہے تاکہ بیک وقت انڈیکس کی تبدیلیاں یکجا ہو سکیں۔"+ ],"CxVk-w": [["address"], " پر تبصرہ"],"D-NlUC": ["سسٹم"],"D-Oh1s": [["0"], " کیسے ترتیب دیں (براؤزر میں کھلتا ہے)"],@@ -958,6 +985,9 @@"DhT_PK": ["OpenKnowledge نے ایک اسکل درآمد کی"],"DiFKSL": ["Markdown فائلیں شمار کی جا رہی ہیں"],"DiZ3pq": ["آئیکن منتخب کنندہ"],+ "DjNcDy": [+ "title، description، resource، اور tags کی شکلیں جب آپ انہیں استعمال کرتے ہیں۔ کسی کی ضرورت نہیں ہے؛ صرف ایک کا اعلان کرنا اس کی قسم کو پن کرتا ہے، لہذا tags کوما سے الگ کردہ سٹرنگ کے طور پر لکھا جاتا ہے۔"+ ],"DmkTrb": ["یہ تھیم بنائی نہیں جا سکی۔ دوبارہ کوشش کریں۔"],"Dnn2XG": ["خودکار"],"DpjYd6": ["لنگر انداز متن پر جائیں"],@@ -1180,6 +1210,9 @@"GNkUvW": ["قطار میں — یہ عمل مکمل ہونے پر بھیجا جائے گا"],"GQ3O42": ["ردی"],"GQDSBN": ["خاکہ بندی کے آپشنز"],+ "GROUfG": [+ "کوئی بھی .mdx فائل۔ فارمیٹ صرف .md ہے، لہذا .md کے لئے اسکین کرنے والا ریڈر اسے کبھی نہیں کھولتا ہے — اور اگر اسی نام کا .md موجود ہے تو اس کی بجائے اسے پڑھتا ہے۔"+ ],"GSYWCm": ["دستاویز کا پینل چھپائیں"],"GUYwCr": ["اطلاع برخاست کریں"],"GUZHkL": ["پیلیٹ کے رنگ غائب ہیں"],@@ -1342,6 +1375,7 @@"IxHMdF": ["وہ تبصرہ حذف نہیں ہو سکا۔"],"IxyZXD": ["اسکرین شاٹ"],"Izh19j": [["tail"], " سے پڑھ رہا ہے"],+ "J0uRhj": ["جانچ پڑتال کی مہارت"],"J1XRO3": ["تھیم کے رنگ"],"J2Mv98": ["نام (مثلاً ", ["login"], ")"],"J2_JuX": ["کچھ نہیں (", ["0"], " کسی دستاویز سے مماثل نہیں ہو سکتا)"],@@ -1364,6 +1398,7 @@"JHf6qZ": ["[email protected]"],"JJcBCm": ["کل ", ["0"]],"JK-Ave": ["تھمب نیلز چھپائیں"],+ "JKXcOi": ["پہلے ہی پروجیکٹ میں ہے۔"],"JL3si7": ["تازہ کیا جا رہا ہے"],"JLUTgi": ["ابھی کوئی ٹیگ نہیں — اشاریہ بھرنے کے لیے کسی بھی دستاویز میں `#tagname` لکھیں۔"],"JLzQi_": [["accessibleLabel"], " بند کریں"],@@ -1463,6 +1498,9 @@"L-rMC9": ["طے شدہ پر واپس کریں"],"L1BQTH": [["0"], " ابھی نصب نہیں ہے — اس کا ڈاؤن لوڈ صفحہ کھولا جا رہا ہے۔"],"L1ZE3M": ["دستاویز کے اعداد و شمار"],+ "L3BcJ4": [+ "اس کو آپ کی فائلوں کو دیکھنے کی ضرورت ہے، نہ صرف کھلی دستاویز، لہذا یہ تب ظاہر ہوتا ہے جب آپ ٹائپ کرتے وقت کے بجائے پروجیکٹ آڈٹ چلاتے ہیں۔"+ ],"L3CEC1": ["یہ آئٹم"],"L3w0_C": ["کسی دستاویز کو الگ ونڈو میں سلائیڈ ڈیک کے طور پر پیش کریں۔ دستاویز کے frontmatter میں <0>slides: true</0> شامل کریں، پھر اسے Slidev ایکشن سے کھولیں۔ رینڈرنگ Slidev CLI کرتا ہے، جو OpenKnowledge میں شامل نہیں۔"@@ -1939,6 +1977,12 @@"R6ABfU": ["براہ راست کام کریں، منصوبہ بندی کے مرحلے کے بغیر"],"R9IDFz": ["ڈسک پر فولڈر اور وہ شناخت بدلتا ہے جو ایجنٹس اسے بلانے کے لیے استعمال کرتے ہیں۔"],"R9dK63": ["نمونہ تصویر"],+ "RB_g_C": [+ "روٹ انڈیکس پر، okf_version کو \"0.2\" کی طرح کوٹڈ سٹرنگ کے طور پر لکھا جاتا ہے۔ بغیر حوالہ، YAML اسے ایک نمبر کے طور پر پڑھتا ہے اور 0.10 خاموشی سے 0.1 بن جاتا ہے۔"+ ],+ "RD6H9q": [+ "Open Knowledge ان index.md فائلوں کو دوبارہ لکھتا ہے جیسے ہی دستاویزات میں تبدیلی آتی ہے، لہذا ان میں دستی ترامیم تبدیل کردی جاتی ہیں۔"+ ],"RDjuBN": ["سیٹ اپ"],"RDrXh4": ["صارف، پروجیکٹ اور انضمام کی ترتیبات مقرر کریں۔"],"RG3yW6": ["اس تھیم کے لیے نام درج کریں۔"],@@ -2008,6 +2052,9 @@"SF9qpO": ["رابطے کے لیے اپنا ای میل شیئر کریں"],"SFEWV6": ["OpenKnowledge مہارتیں لوڈ نہیں ہو سکیں۔ دوبارہ کوشش کریں۔"],"SFN6dN": ["عنوان 3"],+ "SIPelo": [+ "انڈیکس کی دیکھ بھال موقوف ہے کیونکہ Open Knowledge مطلوبہ Git انضمام کے اصول کی تصدیق نہیں کر سکا۔ Git اور .gitattributes کو چیک کریں، پھر دوبارہ کوشش کریں۔"+ ],"SInSnF": ["حوالہ <0>", ["0"], "</0>"],"SItQRc": ["OpenKnowledge آپ کو کیسا لگا؟"],"SOPwPh": ["اس ترمیم پر بحال کریں"],@@ -2338,6 +2385,7 @@"X7u0xR": [["0"], " ٹیمپلیٹس دستیاب"],"X8kjQX": ["GitHub سے دوبارہ توثیق کریں"],"X9VpsP": ["فولڈر کا مواد لوڈ ہو رہا ہے"],+ "XAnapw": ["Git ضم کرنے کا اصول"],"XAyxsa": ["ریموٹ برانچ چیک آؤٹ کریں"],"XBBZnv": ["لنک کا ہدف \"", ["shown"], "\" کسی موجودہ دستاویز کی طرف اشارہ نہیں کرتا۔"],"XBgr2S": ["یہاں کاپی کریں"],@@ -2459,6 +2507,9 @@"Y_iImT": ["ناقابلِ حل فائل ", ["identity"], "۔ حوالہ پر جائیں۔"],"Y_kL7X": ["ایڈیٹر کی شکل اور رویہ اپنی مرضی کے مطابق بنائیں۔"],"Ya3PlJ": ["اجازت درکار ہے"],+ "YaVU2F": [+ "Git پروجیکٹس میں، Open Knowledge ایک دائرہ کار .gitattributes قاعدہ بھی شامل کرتا ہے تاکہ اگلی دوبارہ تعمیر سے پہلے ہم آہنگ انڈیکس کی تبدیلیاں یکجا ہوجائیں۔"+ ],"YaeyFh": ["کھینچنے سے آپ کی مقامی فائلوں میں غیر کمٹ شدہ ترامیم مٹ سکتی ہیں۔"],"Yb82LN": ["ID: ", ["0"]],"Yea-K5": ["اس نقطے پر بحال کریں"],@@ -2584,6 +2635,7 @@"_Bix3-": [["localizedFirstMessage"], " کے واقعات"],"_DwR-n": ["بنائی جا رہی ہے…"],"_FLBbi": [["sizeText"], " · رازداری کی معلومات چھپا دی گئیں · کریش ڈمپ نہیں چھپایا گیا"],+ "_G7A92": ["برقرار رکھیں index.md"],"_GRWOJ": ["ایمبیڈنگز فراہم کنندہ بدلیں؟"],"_HgF9q": ["ترتیب کا معیار"],"_IGfXZ": ["پچھلی بار OpenKnowledge غیر متوقع طور پر بند ہو گیا تھا۔"],@@ -2668,10 +2720,12 @@"ایجنٹ سروس سے رابطہ نہیں ہو سکا۔ یقینی بنائیں کہ OpenKnowledge سرور چل رہا ہے اور تازہ ترین ہے (اگر پہلے سے چل رہا تھا تو اسے دوبارہ چلائیں)، پھر دوبارہ کوشش کریں۔"],"aalx4E": ["ٹوٹے ہوئے MDX سورس میں ترمیم: ", ["reason"]],+ "aatPoi": ["تیار کردہ فائلیں۔"],"abiHje": ["منتخب آئٹمز حذف کریں"],"adsMWO": ["ڈیلٹا حل کیے جا رہے ہیں"],"ah_ekO": ["«", ["name"], "» پہلے ہی تازہ ترین ہے"],"aiArms": ["ہم یہ ریپازٹری کلون نہیں کر سکے۔"],+ "aiOceC": ["اشاریہ جات کو فعال کریں۔"],"ajHi4O": ["خودکار مطابقت پذیری روکی گئی ہے — آپ کو اس ریپو میں پُش کرنے کی اجازت نہیں۔ اپ ڈیٹس ملتی رہیں اس کے لیے «پیروی» پر جائیں۔"],@@ -2816,11 +2870,13 @@],"cb-0G0": ["رنگ ہٹائیں"],"ccNps_": ["صرف ترمیم شدہ"],+ "cd3THN": ["دستاویز کا ڈھانچہ"],"cd5EXh": ["بگ رپورٹ کریں"],"cdm00A": ["کوئی آنے والا نہیں"],"cdmk8A": ["غیر کمٹ شدہ تبدیلیاں"],"cgl-gn": ["GitHub سے منسلک"],"chL5IG": ["کمیونٹی"],+ "ciozf1": ["پروجیکٹ میں پہلے سے ہی مہارت"],"cjtjry": ["OpenKnowledge کی نیویگیشن تاریخ میں پیچھے جائیں۔"],"cklVjM": ["ٹائم لائن"],"clJ3qM": ["مکمل۔"],@@ -3002,6 +3058,7 @@"fbdLmk": ["جلی فارمیٹنگ بدلیں۔"],"fbsiBw": ["ٹرمینل شروع کرتے ہوئے کچھ غلط ہو گیا۔"],"fcgvCA": ["Claude"],+ "fdKQAE": ["اسے آف کرنا"],"fdeFfN": ["(بائنری فائل، پیش منظر ممکن نہیں)"],"fevEu0": ["تازہ ترین تبدیلیاں کھینچیں"],"ffH3Rt": ["تبصرہ شامل کریں (Enter)"],@@ -3080,12 +3137,16 @@"gUx34c": ["وہ زبان جو OpenKnowledge بولتا ہے؛ سسٹم آپ کے آپریٹنگ سسٹم کی پیروی کرتا ہے۔ آپ کے اپنے نوٹس اسی زبان میں رہیں گے جس میں آپ نے لکھے تھے۔"],+ "gVMkEr": [+ "لاگ دستاویز میں: اندراج کی سرخیاں ISO YYYY-MM-DD تاریخ کے ساتھ لیڈ کرتی ہیں، سب سے پہلے۔ آپ کتنے title استعمال کرتے ہیں، اور آیا اندراجات گولیاں ہیں، یہ آپ پر منحصر ہے۔"+ ],"gY7wnY": [["agentName"], " میں سائن اِن کیا جا رہا ہے…"],"gYz2ep": [["timeLabel"], " میں میعاد ختم"],"gZElfU": [["1"], " میں سے ", ["0"], " فائلیں ٹھیک کی جا رہی ہیں"],"gZiT5e": ["کیا ان سِم لنکس کو خودمختار نقول سے بدل دیا جائے؟"],"gayL_Q": ["ریلیز کا منصوبہ"],"gbHcbI": ["خصوصیت حذف نہیں ہو سکی"],+ "gfYI3o": [["id"], " کو غیر فعال کریں"],"gfb-CM": ["برانچ نہیں لائی جا سکی — GitHub میں سائن اِن کریں اور دوبارہ کوشش کریں۔"],"gfdqcY": ["تبدیلی لاگو نہیں ہو سکی: ", ["0"]],"gfohmY": ["ٹولز منسلک کریں"],@@ -3143,6 +3204,9 @@"hLKfZe": ["اس کے بجائے ٹوکن استعمال کریں"],"hLod4_": ["ٹیمپلیٹ میں بدلیں"],"hLy8b1": ["ورژن ", ["version"], " پر تازہ ہو گیا"],+ "hPQBsa": [+ "محفوظ فائلوں کو چھوٹے حروف میں index.md اور log.md کا نام دیا گیا ہے۔ کیس حساس فائل سسٹم پر، Index.md کو ایک عام دستاویز کے طور پر پڑھا جاتا ہے اور اس کا مطلب کھو جاتا ہے۔"+ ],"hQXiDc": ["برانچیں تلاش کریں..."],"hQjvzi": ["ایک .zip یا .skill آرکائیو۔"],"hS0wC4": ["OpenKnowledge نے ", ["subject"], " کا پچھلا ورژن بحال کیا"],@@ -3283,6 +3347,9 @@"iz1LdD": ["آخری بار یہاں لکھنے کے بعد OK سے باہر تبدیل ہوا — دکھائی گئی حالت وہی ہے جو اب ڈسک پر ہے"],+ "j-o6Z2": [+ "انڈیکس کی دیکھ بھال بند رہی کیونکہ پروجیکٹ کی ترتیب کو محفوظ نہیں کیا جا سکا۔ پروجیکٹ فائل کی اجازتوں کو چیک کریں، پھر دوبارہ کوشش کریں۔"+ ],"j15ZSH": ["تبصرے یہاں بھیجیں"],"j2229h": ["OpenKnowledge کی فائلیں ہٹائی جا رہی ہیں…"],"j2kt1j": [@@ -3370,6 +3437,7 @@"k4CuuV": ["جلد شروع کرنے کے لیے تیار شدہ فولڈرز اور ٹیمپلیٹس۔ کیا بنے گا اس کا پیش منظر دیکھنے کے لیے کوئی پیک منتخب کریں، پھر اسے اپنے پروجیکٹ میں شامل کریں۔"],+ "k5rKNs": ["frontmatter"],"k7Hoig": ["اس ورژن میں مواد کی کوئی تبدیلی نہیں۔"],"k8xtrB": ["<0>",@@ -3409,7 +3477,9 @@"kV2YZv": ["<0>مہارتیں</0> نظر نہیں آ رہیں؟ پہلے <1>ترتیبات <2/> صلاحیتیں <3/> کوڈ کا اجرا اور فائل سازی</1> فعال کریں۔"],+ "kVS5tE": ["ہر فولڈر میں generated اشاریہ جات کو برقرار رکھیں؟"],"kVgQUA": ["یہ چیٹ حذف کریں؟"],+ "kVzuTI": ["تجویز کردہ ایجنٹ کی مہارت"],"kYL1lH": ["ایجنٹ کی سرگرمی"],"k_Dqw1": [[@@ -3505,7 +3575,9 @@"lWNpNB": ["CodeMirror کے ذریعے کرسر شامل کریں یا مماثل مواقع منتخب کریں۔"],"lXKZGw": ["عنوان 1"],"lY27jj": [["0"], " سال پہلے"],+ "lY7Unt": ["انڈیکس جنریشن کو فعال کرنا"],"lZAiSP": ["بیک لنکس کا جواب متوقع ساخت سے میل نہیں کھایا۔"],+ "lZoQdy": ["کھلی مہارت"],"lZvQrY": [["0"], " کو تاریک تھیم کے طور پر استعمال کریں"],"l_6JHD": ["آئیکن تلاش کریں..."],"l_FAT6": ["صرف حروف، ہندسے، <0>-</0> یا <1>_</1> استعمال کریں۔"],@@ -3523,6 +3595,7 @@"ljHjfg": ["وہ برانچ پہلے سے کسی اور ورک ٹری میں کھلی ہے۔"],"lkYioO": ["دستاویز کا پینل دکھائیں یا چھپائیں"],"ll2yNl": ["مواد کی ڈائریکٹری"],+ "llXHHh": [["pluginCount", "plural", { "one": ["پلگ اِن"], "other": ["پلگ اِنز"] }]],"lmBPt0": ["صرف بیرونی لنکس درخواست بھیجتے ہیں۔ اس پروجیکٹ کی دیگر دستاویزات کے لنکس مقامی اشاریے سے پیش منظر دکھاتے ہیں اور کبھی آپ کے کمپیوٹر سے باہر نہیں جاتے۔"],@@ -3597,6 +3670,9 @@}]],+ "mhnCt3": [+ "ہر تصوراتی دستاویز میں ایک غیر خالی قسم ہوتی ہے۔ یہ OKF کا پورا کنفارمنس فلور ہے — صرف ایک قسم کے ساتھ ایک دستاویز مکمل طور پر موافق ہے۔"+ ],"mk2poV": ["مثلاً server.ts"],"mlvM8g": ["وہ تبصرہ دوبارہ نہیں رکھا جا سکا۔"],"mmpzAq": ["Markdown سورس ایڈیٹر میں لمبی سطریں لپیٹیں۔"],@@ -3857,6 +3933,9 @@"qRZh7J": ["Tab کو سورس ایڈیٹر سے باہر نکلنے دیں، اندروں کھسکانے کے بجائے۔"],"qSKu2v": ["سورس میں نیویگیشن اور انتخاب"],"qSxaOz": ["ان کا حذف قبول کریں"],+ "qTT48-": [+ "وکی لنکس جیسے [[Page]] — یہاں لنک کرنے کا ایک معاون طریقہ ہے، لیکن ایک بیرونی ریڈر کچھ بھی حل نہیں کرتا اور بریکٹ دکھاتا ہے۔"+ ],"qTcVwj": ["اس پروجیکٹ کے لیے مہارت براؤز کریں یا اپ لوڈ کریں۔"],"qTcZZu": ["ٹیگز لوڈ نہیں ہو سکے۔ دوبارہ کوشش کے لیے <0>Esc</0> دبائیں اور دوبارہ کھولیں۔"],"qX-ABr": ["یا اس کے بجائے براؤزر سے سائن اِن کرنے کے لیے:"],@@ -3899,6 +3978,7 @@"r51jLC": ["فائل محفوظ ہو گئی اور Claude Desktop App کھل گیا"],"r6ncaO": ["ٹیب بند کریں"],"r6y-jM": ["انتباہ"],+ "r7IaYp": ["Open Knowledge Format رہنمائی"],"r871ed": ["آپ کا نالج بیس اب GitHub پر <0>", ["ownerLogin"], "/", ["repoName"], "</0> پر ہے۔"],"rDOuNw": ["ٹیمپلیٹ درآمد نہیں ہو سکا"],"rENNI6": ["شیئر URL درست نہیں۔"],@@ -3922,6 +4002,9 @@"rZVMkf": ["بصری ایڈیٹر کا تبدیلی اِن پٹ فوکس میں ہے"],"radOpL": ["تصویر ", ["identity"], "۔ حوالہ پر جائیں۔"],"rageVb": ["براہِ راست پیش منظر کے پین کے ساتھ حسبِ ضرورت HTML (سینڈ باکسڈ iframe)۔"],+ "rarziH": [+ "کوڈنگ ایجنٹوں کو OKF دستاویز کی اقسام کا انتخاب کرنے، اصل کو محفوظ رکھنے، اور غیر تعاون یافتہ میٹا ڈیٹا ایجاد کرنے سے بچنے میں مدد کرتا ہے۔"+ ],"rbrHTd": ["منظور شدہ — ", ["optionName"]],"rcJmK8": ["مقامات کو نقول میں بدلیں"],"rdU729": ["خاکہ بندی"],@@ -3972,6 +4055,7 @@"sER-bs": ["فائلیں"],"sFhaTJ": ["مینو میں ملتے جلتے ناموں والے ٹیمپلیٹس کو الگ پہچانتا ہے۔"],"sGZLfB": ["ریپوزٹریز حاصل نہیں ہو سکیں"],+ "sHDllh": ["برقرار رکھنا بند کریں index.md"],"sICrVf": [["0"], " کے ورژن پر بحال کر دیا گیا"],"sIGbBZ": ["انتخاب کو فٹ نوٹ میں بدلیں"],"sIxSSP": ["اپنے ٹرمینل میں تصادم حل کریں"],@@ -3985,6 +4069,7 @@"sOxZaS": ["گراف لوڈ نہیں ہو سکا"],"sQoLn0": ["باہر نکلیں"],"sR0I-f": ["سب فائلیں سکیڑیں"],+ "sSRndh": ["index.md کو برقرار رکھنا شروع کریں"],"sW5OjU": ["لازمی"],"sZ2IOu": ["یہ ",@@ -3999,6 +4084,9 @@"saIASg": ["دوسرا آئٹم"],"saYiIO": ["راستے میں null بائٹس نہیں ہو سکتے"],"scu3wk": ["ماڈل"],+ "scyoP9": [+ "انڈیکس دستاویزات میں کوئی frontmatter نہیں ہے، سوائے آپ کے علم کی بنیاد پر موجود دستاویز کے۔ لاگ دستاویزات کا احاطہ نہیں کیا گیا ہے — OKF ان کے frontmatter کو محدود نہیں کرتا ہے۔"+ ],"se-tU0": [["total"], " میں سے ", ["0"], " فائلیں درست نہیں کی جا سکیں۔"],"seeS6l": ["اس فولڈر میں OpenKnowledge ترتیب دیں؟"],"sgmRY8": [["0"], " کا ڈاؤن لوڈ چھوڑ دیا گیا۔"],@@ -4051,6 +4139,9 @@"tHKQ6j": ["نام بدلا جا رہا ہے"],"tKlWWY": ["ایموجی"],"tLX6LY": ["OpenKnowledge نے ایک دستاویز لکھی"],+ "tM5uzl": [+ "اصل، اعتماد، اور لائف سائیکل فیملیز: sources، generated، verified، status، اور stale_after۔ ہر فیلڈ اختیاری ہے، اور غیر موجودگی کبھی بھی غلطی نہیں ہوتی۔"+ ],"tN5WTS": ["فراہم کنندہ نے درخواست مسترد کر دی۔ API کلید اور ماڈل شناخت دیکھیں۔"],"tP5DDk": ["لنک لاگو کریں"],"tUvUfp": ["کوئی ایسا فولڈر استعمال کریں جو آپ کے پاس پہلے سے ہے۔"],@@ -4108,6 +4199,9 @@"uGaIIS": ["ورک ٹری چیک آؤٹ کریں"],"uH_S-u": [["loadErrorTitle"], ": ", ["message"]],"uJfwF8": ["پہلے سے نصب ہے — درآمد کرنے کو کچھ نیا نہیں۔"],+ "uK2peg": [+ "آپ کے پروجیکٹ کو Open Knowledge Format کے خلاف چیک کرتا ہے۔ اسے کسی بھی وقت ترتیبات میں بند کریں۔"+ ],"uKRYiW": ["مطابقت پذیری کی حالت دستیاب نہیں — سرور کی خرابی۔"],"uL_Wx8": ["ٹرمینل غیر متوقع طور پر رک گیا۔"],"uM6jnS": ["بحالی ناکام"],@@ -4160,6 +4254,9 @@"uyOQ4e": ["تھیم base16 YAML کے طور پر کاپی ہو گئی"],"uynXup": [["tokens", "plural", { "one": ["ٹوکن"], "other": ["ٹوکنز"] }]],"v-h2hx": [["targetGitPath"], " حذف کریں"],+ "v15iQB": [+ "تصدیق شدہ حساب کا معاہدہ۔ صرف Attested Computation ٹائپ شدہ دستاویزات پر لاگو ہوتا ہے، جہاں OKF کو runtime کی ضرورت ہوتی ہے؛ عام تصورات متاثر نہیں ہوتے ہیں۔"+ ],"v2ZW0K": ["ٹرمینل فعال کریں"],"v2a04T": ["markdownlint کے قواعد"],"v41fCm": ["فائل نہیں ملی"],diff --git a/packages/app/src/locales/ur/messages.po b/packages/app/src/locales/ur/messages.poindex f440a4829..845474cd8 100644--- a/packages/app/src/locales/ur/messages.po+++ b/packages/app/src/locales/ur/messages.po@@ -263,6 +263,11 @@ msgstr "{0, plural, one {ابھی {2} میں سے {1} دستاویز مماثلmsgid "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"msgstr "{0, plural, one {# دستاویز میں کوئی مسئلہ نہیں۔} other {# دستاویزات میں کوئی مسئلہ نہیں۔}}"+#. placeholder {0}: pluginRows.length+#: src/components/CreatedItemsList.tsx+msgid "{0, plural, one {Plugin} other {Plugins}}"+msgstr "{0, plural, one {پلگ اِن} other {پلگ اِنز}}"+#. placeholder {0}: editorList.hiddenCount#: src/components/McpConsentDialogBody.tsxmsgid "{0, plural, one {Show # more tool} other {Show # more tools}}"@@ -629,7 +634,9 @@ msgstr "{displayName} CLI، {hint}"msgid "{docName} is {0}. OpenKnowledge currently opens files up to {1}."msgstr "{docName} کا حجم {0} ہے۔ OpenKnowledge فی الحال {1} تک کی فائلیں کھولتا ہے۔"+#. placeholder {0}: OKF_RULE_IDS.length#. placeholder {0}: entries.length+#: src/components/settings/LintingSection.tsx#: src/components/settings/markdownlint-rule-browser.tsxmsgid "{enabledCount}/{0} on"msgstr "{enabledCount}/{0} فعال"@@ -792,6 +799,10 @@ msgstr "{percent}% استعمال شدہ ({left}% باقی)"msgid "{phase} — {pct}%"msgstr "{phase} — {pct}%"+#: src/components/CreatedItemsList.tsx+msgid "{pluginCount, plural, one {plugin} other {plugins}}"+msgstr "{pluginCount, plural, one {پلگ اِن} other {پلگ اِنز}}"+#: src/components/PropertyDisclosure.tsxmsgid "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"msgstr "{problemCount, plural, one {# خصوصیت اسکیما سے میل نہیں کھاتی} other {# خصوصیات اسکیما سے میل نہیں کھاتیں}}"@@ -1547,6 +1558,10 @@ msgstr "پہلے سے منتخب کردہ پیرنٹ فولڈر میں شاملmsgid "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."msgstr "پہلے سے git ریپازٹری موجود ہے؟ اس پروجیکٹ کے فولڈر میں <0>git remote add origin <url></0> سے شامل کریں۔ ریموٹ کا پتا چلتے ہی یہ صفحہ خودکار طور پر تازہ ہو جاتا ہے۔"+#: src/components/settings/LintingSection.tsx+msgid "Already in project"+msgstr "پہلے ہی پروجیکٹ میں ہے۔"+#: src/components/SkillPluginBundleDialog.tsxmsgid "Already installed — nothing new to import."msgstr "پہلے سے نصب ہے — درآمد کرنے کو کچھ نیا نہیں۔"@@ -1592,6 +1607,10 @@ msgstr "ایک اور مطابقت پذیری جاری ہے۔ تھوڑی دیرmsgid "any"msgstr "کوئی بھی"+#: src/components/settings/LintingSection.tsx+msgid "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+msgstr "کوئی بھی .mdx فائل۔ فارمیٹ صرف .md ہے، لہذا .md کے لئے اسکین کرنے والا ریڈر اسے کبھی نہیں کھولتا ہے — اور اگر اسی نام کا .md موجود ہے تو اس کی بجائے اسے پڑھتا ہے۔"+#. placeholder {0}: summary.name#: src/components/settings/LintingSection.tsxmsgid "any doc named {0}"@@ -2152,6 +2171,7 @@ msgstr "یہ راستہ شیئر نہیں کیا جا سکتا۔"#: src/components/ReportBugDialogBody.tsx#: src/components/SeedDialog.tsx#: src/components/settings/LinkPreviewsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/SavedThemesTiles.tsx#: src/components/settings/SearchSection.tsx#: src/components/ShareBranchSwitchDialog.tsx@@ -2292,6 +2312,10 @@ msgstr "فائلیں چیک آؤٹ کی جا رہی ہیں"msgid "Checking sign-in status"msgstr "سائن اِن کی حالت جانچی جا رہی ہے"+#: src/components/settings/LintingSection.tsx+msgid "Checking skill"+msgstr "جانچ پڑتال کی مہارت"+#: src/components/ImportSkillForm.tsxmsgid "Checking source"msgstr "ماخذ جانچا جا رہا ہے"@@ -2308,6 +2332,10 @@ msgstr "جانچا جا رہا ہے..."msgid "Checklist with checkboxes."msgstr "چیک باکسز کے ساتھ چیک لسٹ۔"+#: src/components/CreatedItemsList.tsx+msgid "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+msgstr "آپ کے پروجیکٹ کو Open Knowledge Format کے خلاف چیک کرتا ہے۔ اسے کسی بھی وقت ترتیبات میں بند کریں۔"+#: src/components/ImportSkillForm.tsxmsgid "Choose a skill archive"msgstr "مہارت کا آرکائیو منتخب کریں"@@ -4304,6 +4332,10 @@ msgstr "{0} بند کریں"msgid "Disable {file}"msgstr "{file} بند کریں"+#: src/components/settings/LintingSection.tsx+msgid "Disable {id}"+msgstr "{id} کو غیر فعال کریں"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "Disable external link previews"msgstr "بیرونی لنکس کے پیش منظر بند کریں"@@ -4406,6 +4438,10 @@ msgstr "دستاویز کے پینلز"msgid "Document statistics"msgstr "دستاویز کے اعداد و شمار"+#: src/components/settings/LintingSection.tsx+msgid "Document structure"+msgstr "دستاویز کا ڈھانچہ"+#: src/components/empty-state/use-create-suggestions.tsmsgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."msgstr "اس ریپو کے ڈھانچے کی دستاویز بنائیں: ایک جائزہ صفحہ بنائیں جو ہر بڑے ماڈیول کے صفحے سے جڑا ہو اور اس کی ذمہ داریاں اور داخلی نقاط بیان کرے۔"@@ -4797,6 +4833,10 @@ msgstr "{displayName} CLI فعال کریں"msgid "Enable {file}"msgstr "{file} فعال کریں"+#: src/components/settings/LintingSection.tsx+msgid "Enable {id}"+msgstr "{id} کو فعال کریں"+#: src/components/AutoSyncOnboardingDialog.tsx#: src/components/EnableSyncConfirmDialog.tsx#: src/components/share-receive-miss-content.tsx@@ -4821,6 +4861,10 @@ msgstr "پیروی فعال کریں؟"msgid "Enable git auto-sync?"msgstr "git کی خودکار مطابقت پذیری فعال کریں؟"+#: src/components/settings/LintingSection.tsx+msgid "Enable indexes"+msgstr "اشاریہ جات کو فعال کریں۔"+#: src/components/ProblemsPanel.tsxmsgid "Enable plugins"msgstr "پلگ اِنز فعال کریں"@@ -4849,6 +4893,10 @@ msgstr "اس پروجیکٹ کے لیے ٹرمینل فعال کریں"msgid "Enable Themes"msgstr "تھیمز فعال کریں"+#: src/components/settings/LintingSection.tsx+msgid "Enabling index generation"+msgstr "انڈیکس جنریشن کو فعال کرنا"+#: src/components/ActivityModeContent.tsxmsgid "Ended"msgstr "ختم ہو گیا"@@ -4919,6 +4967,10 @@ msgstr "خرابی:"msgid "Escape"msgstr "Escape"+#: src/components/settings/LintingSection.tsx+msgid "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+msgstr "ہر تصوراتی دستاویز میں ایک غیر خالی قسم ہوتی ہے۔ یہ OKF کا پورا کنفارمنس فلور ہے — صرف ایک قسم کے ساتھ ایک دستاویز مکمل طور پر موافق ہے۔"+#: src/components/settings/LintingSection.tsxmsgid "every doc"msgstr "ہر دستاویز"@@ -5694,6 +5746,10 @@ msgstr "ٹیمپلیٹ سے"msgid "From the {0} plugin"msgstr "{0} پلگ اِن سے"+#: src/components/settings/LintingSection.tsx+msgid "Frontmatter"+msgstr "frontmatter"+#: src/components/TemplateForm.tsxmsgid "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."msgstr "وہ frontmatter جس سے اس ٹیمپلیٹ سے بننے والی ہر دستاویز شروع ہوتی ہے۔ اقدار YAML میں ہیں — فہرست یوں لکھی جاتی ہے <0>[a, b]</0>؛ اور <1>{{date}}</1> بناتے وقت بھر جاتا ہے۔"@@ -5736,6 +5792,10 @@ msgstr "کھیل ختم · دوبارہ کھیلنے کے لیے اسپیس دبmsgid "General"msgstr "عمومی"+#: src/components/settings/LintingSection.tsx+msgid "Generated files"+msgstr "تیار کردہ فائلیں۔"+#: src/components/TerminalCliMissingBanner.tsxmsgid "Get {displayName}"msgstr "{displayName} حاصل کریں"@@ -5769,6 +5829,10 @@ msgstr "git کی کنفیگریشن دستیاب نہیں"msgid "Git identity isn't set — commits use a default author. Set yours so teammates see your name."msgstr "Git کی شناخت مقرر نہیں — کمٹس طے شدہ مصنف استعمال کرتے ہیں۔ اپنی شناخت مقرر کریں تاکہ ساتھی آپ کا نام دیکھیں۔"+#: src/components/settings/LintingSection.tsx+msgid "Git merge rule"+msgstr "Git ضم کرنے کا اصول"+#: src/components/ShareBranchSwitchDialog.tsxmsgid "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."msgstr "اس ریپازٹری کے لیے Git کو {tool} درکار ہے، مگر یہ نصب نہیں ہے یا نہیں مل سکا۔ اسے نصب کریں، پھر دوبارہ کوشش کریں۔"@@ -5923,7 +5987,7 @@ msgstr "heading-slug"msgid "Headings"msgstr "عنوانات"-#: src/components/AutoSyncEnableWarning.tsx+#: src/components/DisclosureWarning.tsx#: src/editor/slash-command/component-items.tsxmsgid "Heads up"msgstr "خیال رہے"@@ -5945,6 +6009,10 @@ msgstr "سلام، دنیا!"msgid "Help"msgstr "مدد"+#: src/components/settings/LintingSection.tsx+msgid "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+msgstr "کوڈنگ ایجنٹوں کو OKF دستاویز کی اقسام کا انتخاب کرنے، اصل کو محفوظ رکھنے، اور غیر تعاون یافتہ میٹا ڈیٹا ایجاد کرنے سے بچنے میں مدد کرتا ہے۔"+#. Subtext for the open-knowledge-discovery skill row#. Subtext for the open-knowledge-discovery skill row#: src/components/McpConsentDialogBody.tsx@@ -6277,10 +6345,18 @@ msgstr "«{0}» کے نام سے درآمد ہوا — نام «{1}» پہلےmsgid "Importing"msgstr "درآمد کیا جا رہا ہے"+#: src/components/settings/LintingSection.tsx+msgid "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+msgstr "لاگ دستاویز میں: اندراج کی سرخیاں ISO YYYY-MM-DD تاریخ کے ساتھ لیڈ کرتی ہیں، سب سے پہلے۔ آپ کتنے title استعمال کرتے ہیں، اور آیا اندراجات گولیاں ہیں، یہ آپ پر منحصر ہے۔"+#: src/components/SeedDialog.tsxmsgid "In a subfolder"msgstr "ذیلی فولڈر میں"+#: src/components/settings/LintingSection.tsx+msgid "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+msgstr "انڈیکس دستاویز میں: اندراجات ایک سیکشن کی سرخی کے نیچے بیٹھتے ہیں اور ہر ایک میں ایک لنک ہوتا ہے۔ فہرستوں کے ارد گرد نثر ٹھیک ہے."+#: src/components/empty-state/CreatePromptComposer.tsx#: src/components/handoff/AgentSplitButton.tsx#: src/components/handoff/OpenInAgentContextSubmenu.tsx@@ -6299,6 +6375,14 @@ msgstr "ایپ میں"msgid "In app (beta)"msgstr "ایپ میں (بیٹا)"+#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+msgstr "Git پروجیکٹس میں، Open Knowledge ریپوزٹری کی روٹ .gitattributes فائل میں محدود دائرۂ کار کا اصول شامل کرتا ہے تاکہ بیک وقت انڈیکس کی تبدیلیاں یکجا ہو سکیں۔"++#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+msgstr "Git پروجیکٹس میں، Open Knowledge ایک دائرہ کار .gitattributes قاعدہ بھی شامل کرتا ہے تاکہ اگلی دوبارہ تعمیر سے پہلے ہم آہنگ انڈیکس کی تبدیلیاں یکجا ہوجائیں۔"+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "In the Claude Desktop App"msgstr "Claude Desktop App میں"@@ -6323,6 +6407,26 @@ msgstr "موجودہ فہرست آئٹم کی اندروں یا باہر کی جmsgid "Indented blockquote for citations."msgstr "حوالوں کے لیے اندر کی طرف کھسکا ہوا اقتباس۔"+#: src/components/settings/LintingSection.tsx+msgid "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+msgstr "انڈیکس دستاویزات میں کوئی frontmatter نہیں ہے، سوائے آپ کے علم کی بنیاد پر موجود دستاویز کے۔ لاگ دستاویزات کا احاطہ نہیں کیا گیا ہے — OKF ان کے frontmatter کو محدود نہیں کرتا ہے۔"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+msgstr "انڈیکس کی دیکھ بھال موقوف ہے کیونکہ ایک اور Git وصف کنٹرول کرتا ہے index.md۔ .gitattributes کو اپ ڈیٹ کریں تاکہ دائرہ کار والے index.md راستے merge=union استعمال کریں، پھر دوبارہ کوشش کریں۔"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+msgstr "انڈیکس کی دیکھ بھال موقوف ہے کیونکہ Open Knowledge مطلوبہ Git انضمام کے اصول کی تصدیق نہیں کر سکا۔ Git اور .gitattributes کو چیک کریں، پھر دوبارہ کوشش کریں۔"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+msgstr "انڈیکس کی دیکھ بھال بند رہی کیونکہ Open Knowledge پروجیکٹ سرور تک نہیں پہنچ سکا۔ جب پروجیکٹ دوبارہ جڑ جائے تو دوبارہ کوشش کریں۔"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+msgstr "انڈیکس کی دیکھ بھال بند رہی کیونکہ پروجیکٹ کی ترتیب کو محفوظ نہیں کیا جا سکا۔ پروجیکٹ فائل کی اجازتوں کو چیک کریں، پھر دوبارہ کوشش کریں۔"+#: src/components/settings/SearchSection.tsxmsgid "Indexed {embedded} of {total} pages."msgstr "{total} میں سے {embedded} صفحات اشاریہ بند ہو گئے۔"@@ -6511,6 +6615,10 @@ msgstr "تمام ایجنٹس پر نصب کریں"msgid "Install selected"msgstr "منتخب نصب کریں"+#: src/components/settings/LintingSection.tsx+msgid "Install skill"+msgstr "مہارت کو انسٹال کریں۔"+#: src/components/SkillPluginBundleBanner.tsxmsgid "Install skills"msgstr "مہارتیں نصب کریں"@@ -6520,6 +6628,7 @@ msgid "Install the gh CLI"msgstr "gh CLI نصب کریں"#: src/components/settings/AiToolsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ProjectAiToolsSection.tsx#: src/components/SkillEditorActions.tsxmsgid "Installed"@@ -6733,6 +6842,10 @@ msgstr "اس پروجیکٹ کو اپنے git ریموٹ کے ساتھ ہم آہmsgid "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."msgstr "ان لوگوں اور کمپنیوں کا حساب رکھیں جن کے ساتھ آپ کام کرتے ہیں اور ان کے ساتھ ہونے والی ملاقاتوں کا۔ یہ یاد رکھنے کے لیے مفید کہ کوئی کون ہے، آپ اسے کیسے جانتے ہیں، اور آخری بار کس بارے میں بات ہوئی تھی۔"+#: src/components/settings/LintingSection.tsx+msgid "Keeps your knowledge base aligned with the Open Knowledge Format."+msgstr "آپ کے علمی ذخیرے کو Open Knowledge Format کے مطابق رکھتا ہے۔"+#. placeholder {0}: toName.trim()#: src/components/SkillForkDialog.tsxmsgid "Kept both — \"{0}\" is its own skill now"@@ -7108,6 +7221,14 @@ msgstr "<0>{lookingForUrl}</0> تلاش کیا جا رہا ہے۔"msgid "Lost connection to \"{docName}\"."msgstr "«{docName}» سے رابطہ ختم ہو گیا۔"+#: src/components/settings/LintingSection.tsx+msgid "Maintain generated indexes in every folder?"+msgstr "ہر فولڈر میں generated اشاریہ جات کو برقرار رکھیں؟"++#: src/components/settings/LintingSection.tsx+msgid "Maintain index.md"+msgstr "برقرار رکھیں index.md"+#: src/components/SkillInstallMenu.tsxmsgid "make source"msgstr "ماخذ بنائیں"@@ -8252,6 +8373,10 @@ msgstr "OK Desktop"msgid "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."msgstr "OK نے آخری بار اس فولڈر کو {0} مقرر کیا تھا — اس کے بعد OK سے باہر کسی چیز نے اسے بدل دیا۔ دکھائی گئی حالت وہی ہے جو اب ڈسک پر ہے؛ آپ کا اگلا سِم لنک یا لنک ختم کرنا فیصلہ کن ہو گا۔"+#: src/components/settings/LintingSection.tsx+msgid "OKF agent skill installed"+msgstr "OKF ایجنٹ کی مہارت انسٹال ہوگئی"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "On — hovering an external link sends its URL to the destination site to fetch a preview."msgstr "فعال — بیرونی لنک پر ماؤس لے جانے سے اس کا URL پیش منظر لانے کے لیے منزل کی سائٹ کو بھیجا جاتا ہے۔"@@ -8268,6 +8393,10 @@ msgstr "<0>{address}</0> پر"msgid "On selected text in <0>{address}</0>"msgstr "<0>{address}</0> میں منتخب متن پر"+#: src/components/settings/LintingSection.tsx+msgid "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+msgstr "روٹ انڈیکس پر، okf_version کو \"0.2\" کی طرح کوٹڈ سٹرنگ کے طور پر لکھا جاتا ہے۔ بغیر حوالہ، YAML اسے ایک نمبر کے طور پر پڑھتا ہے اور 0.10 خاموشی سے 0.1 بن جاتا ہے۔"+#. Next step for a Cursor project MCP row — Cursor leaves project servers disabled#: src/components/settings/ProjectAiToolsSection.tsxmsgid "One more step: enable it in Cursor → Settings → Tools & MCP (Cursor leaves project servers off until you turn them on)."@@ -8490,6 +8619,22 @@ msgstr "ورک ٹری میں کھولیں"msgid "Open it there"msgstr "اسے وہیں کھولیں"+#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+msgstr "Open Knowledge ہر فولڈر میں index.md نامی نیویگیشن فائل بناتا اور برقرار رکھتا ہے جس میں Markdown ہوتا ہے۔"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge Format guidance"+msgstr "Open Knowledge Format رہنمائی"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+msgstr "Open Knowledge ہر فولڈر میں index.md نامی ایک نیویگیشن فائل کو برقرار رکھتا ہے جس میں Markdown ہوتا ہے، ہر ایک فولڈر کے دستاویزات کو ٹائپ اور اس کے ذیلی فولڈرز سے لنک کرکے درج کرتا ہے۔ یہ ان فائلوں کو دوبارہ لکھتا ہے جیسے آپ کی دستاویزات تبدیل ہوتی ہیں، اور جو کچھ بھی آپ خود ان میں ترمیم کرتے ہیں اسے تبدیل کر دیا جاتا ہے۔"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+msgstr "Open Knowledge ان index.md فائلوں کو دوبارہ لکھتا ہے جیسے ہی دستاویزات میں تبدیلی آتی ہے، لہذا ان میں دستی ترامیم تبدیل کردی جاتی ہیں۔"+#. placeholder {0}: item.displayName#. placeholder {1}: item.displayName#. placeholder {2}: item.version@@ -8536,6 +8681,10 @@ msgstr "ترتیبات کھولیں"msgid "Open shared {targetNoun}"msgstr "مشترکہ {targetNoun} کھولیں"+#: src/components/settings/LintingSection.tsx+msgid "Open skill"+msgstr "کھلی مہارت"+#: src/editor/extensions/JsxComponentView.tsxmsgid "Open source doc: {mirrorSrc}"msgstr "ماخذ کی دستاویز کھولیں: {mirrorSrc}"@@ -9372,6 +9521,7 @@ msgid "project"msgstr "پروجیکٹ"#: src/components/CommandPalette.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ScopeBadge.tsx#: src/lib/skill-scope.tsmsgid "Project"@@ -9643,6 +9793,10 @@ msgstr "حالیہ پروجیکٹ"msgid "Recently opened"msgstr "حال ہی میں کھولے گئے"+#: src/components/settings/LintingSection.tsx+msgid "Recommended agent skill"+msgstr "تجویز کردہ ایجنٹ کی مہارت"+#: src/components/SyncStatusBadge.tsxmsgid "Reconnect required"msgstr "دوبارہ منسلک ہونا ضروری ہے"@@ -10080,6 +10234,10 @@ msgstr "اڑنے سے قاصر پرندوں کے خاتمے پر تحقیق کرmsgid "research-note"msgstr "research-note"+#: src/components/settings/LintingSection.tsx+msgid "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+msgstr "محفوظ فائلوں کو چھوٹے حروف میں index.md اور log.md کا نام دیا گیا ہے۔ کیس حساس فائل سسٹم پر، Index.md کو ایک عام دستاویز کے طور پر پڑھا جاتا ہے اور اس کا مطلب کھو جاتا ہے۔"+#: src/components/settings/CustomThemeEditor.tsxmsgid "Reset"msgstr "دوبارہ ترتیب دیں"@@ -10322,6 +10480,7 @@ msgid "Rule editing is available for the project's root markdownlint config"msgstr "قاعدے کی ترمیم پروجیکٹ کی جڑ والی markdownlint کنفیگ کے لیے دستیاب ہے"#: src/components/LintConfigEditor.tsx+#: src/components/settings/LintingSection.tsxmsgid "Rules"msgstr "قواعد"@@ -11264,6 +11423,10 @@ msgstr "{conflictHosts} کے لیے اسکل «{conflictName}» انسٹال نmsgid "Skill \"{name}\" created"msgstr "مہارت «{name}» بن گئی"+#: src/components/settings/LintingSection.tsx+msgid "Skill already in project"+msgstr "پروجیکٹ میں پہلے سے ہی مہارت"+#: src/components/ExploreSkills.tsxmsgid "Skill discovery powered by <0>skills.sh</0>"msgstr "مہارتوں کی دریافت <0>skills.sh</0> سے تقویت یافتہ"@@ -11523,6 +11686,10 @@ msgstr "یہاں سے شروع کریں"msgid "Start here: what this is and how it's organized."msgstr "یہاں سے شروع کریں: یہ کیا ہے اور کیسے منظم ہے۔"+#: src/components/settings/LintingSection.tsx+msgid "Start maintaining index.md"+msgstr "index.md کو برقرار رکھنا شروع کریں"+#: src/lib/keyboard-shortcuts.tsmsgid "Start source completion"msgstr "سورس کی تکمیل شروع کریں"@@ -11618,6 +11785,10 @@ msgstr "فائلیں ٹھیک کرنا روکیں"msgid "Stop fixing. Files already fixed stay fixed."msgstr "ٹھیک کرنا روکیں۔ جو فائلیں پہلے ہی ٹھیک ہو چکی ہیں وہ ٹھیک ہی رہیں گی۔"+#: src/components/settings/LintingSection.tsx+msgid "Stop maintaining index.md"+msgstr "برقرار رکھنا بند کریں index.md"+#: src/lib/project-fix-sweep-store.tsmsgid "Stopped fixing. Files already fixed stay fixed."msgstr "ٹھیک کرنا رک گیا۔ جو فائلیں پہلے ہی ٹھیک ہو چکی ہیں وہ ٹھیک ہی رہیں گی۔"@@ -12121,6 +12292,10 @@ msgstr "ایجنٹ رک نہیں رہا۔ زبردستی روکنے سے یہ چmsgid "The agent's persona, values, and voice."msgstr "ایجنٹ کی شخصیت، اقدار اور لہجہ۔"+#: src/components/settings/LintingSection.tsx+msgid "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+msgstr "تصدیق شدہ حساب کا معاہدہ۔ صرف Attested Computation ٹائپ شدہ دستاویزات پر لاگو ہوتا ہے، جہاں OKF کو runtime کی ضرورت ہوتی ہے؛ عام تصورات متاثر نہیں ہوتے ہیں۔"+#: src/components/ProblemsPanel.tsxmsgid "The audit could not be completed. Try again."msgstr "آڈٹ مکمل نہیں ہو سکا۔ دوبارہ کوشش کریں۔"@@ -12179,6 +12354,10 @@ msgstr "فارمولا <0>c = √(a² + b²)</0> اِن لائن رینڈر ہوmsgid "the git exclude file isn't writable"msgstr "git کی exclude فائل قابلِ تحریر نہیں"+#: src/components/settings/LintingSection.tsx+msgid "The index files stay in place. Open Knowledge removes only the Git rule it added."+msgstr "انڈیکس فائلیں اپنی جگہ پر رہتی ہیں۔ Open Knowledge صرف اس Git اصول کو ہٹاتا ہے جو اس نے شامل کیا ہے۔"+#: src/lib/locale-load-failure-notice.tsmsgid "The interface is still in the language you were reading. Check your connection, then reload to try again."msgstr "انٹرفیس اب بھی اسی زبان میں ہے جو آپ پڑھ رہے تھے۔ اپنا کنکشن دیکھیں، پھر دوبارہ کوشش کے لیے ری لوڈ کریں۔"@@ -12215,6 +12394,10 @@ msgstr "اس دستاویز کے اوپر خصوصیات کے بلاک میں فmsgid "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."msgstr "خصوصیات تبدیل ہوئیں، مگر ان کا موازنہ نہیں ہو سکا — YAML پارس نہیں ہوا۔ دونوں ورژن جیسے لکھے گئے تھے ویسے ہی دکھائے جا رہے ہیں۔"+#: src/components/settings/LintingSection.tsx+msgid "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+msgstr "اصل، اعتماد، اور لائف سائیکل فیملیز: sources، generated، verified، status، اور stale_after۔ ہر فیلڈ اختیاری ہے، اور غیر موجودگی کبھی بھی غلطی نہیں ہوتی۔"+#: src/components/settings/SearchSection.tsxmsgid "The provider is rate-limiting this key. Try again in a moment."msgstr "فراہم کنندہ اس کلید کی شرح محدود کر رہا ہے۔ تھوڑی دیر بعد دوبارہ کوشش کریں۔"@@ -12252,6 +12435,10 @@ msgstr "اسکیما فائل موجود نہیں یا لوڈ نہیں ہو سکmsgid "the server responded but server.lock has no port yet"msgstr "سرور نے جواب دیا مگر server.lock میں ابھی کوئی پورٹ نہیں"+#: src/components/settings/LintingSection.tsx+msgid "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+msgstr "title، description، resource، اور tags کی شکلیں جب آپ انہیں استعمال کرتے ہیں۔ کسی کی ضرورت نہیں ہے؛ صرف ایک کا اعلان کرنا اس کی قسم کو پن کرتا ہے، لہذا tags کوما سے الگ کردہ سٹرنگ کے طور پر لکھا جاتا ہے۔"+#: src/components/SkillInstallMenu.tsxmsgid "The skill's own folder — the source other locations copy or link from"msgstr "مہارت کا اپنا فولڈر — وہ ماخذ جس سے دیگر مقامات نقل کرتے یا جڑتے ہیں"@@ -12565,6 +12752,10 @@ msgstr "اس میں تھوڑا وقت لگ سکتا ہے۔ آپ کا Markdown مmsgid "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."msgstr "یہ <0>{name}</0> کو {0} سے {1} پر منتقل کرتا ہے، ڈسک پر اس کی فائلوں کی جگہ بدلتا ہے اور اسے آپ کے ایڈیٹرز میں {2} سطح پر دوبارہ نصب کرتا ہے۔"+#: src/components/settings/LintingSection.tsx+msgid "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+msgstr "اس کو آپ کی فائلوں کو دیکھنے کی ضرورت ہے، نہ صرف کھلی دستاویز، لہذا یہ تب ظاہر ہوتا ہے جب آپ ٹائپ کرتے وقت کے بجائے پروجیکٹ آڈٹ چلاتے ہیں۔"+#: src/components/SeedDialog.tsxmsgid "This pack is already set up here."msgstr "یہ پیک یہاں پہلے سے ترتیب دیا جا چکا ہے۔"@@ -12928,6 +13119,10 @@ msgstr "{0} کو دوبارہ ایک حقیقی ڈائریکٹری بنا دیںmsgid "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."msgstr "{display} کو دوبارہ ایک حقیقی ڈائریکٹری بنا دیں جس میں اس وقت نظر آنے والی ہر مہارت کے لیے الگ سِم لنک ہو — کچھ بھی کام کرنا بند نہیں کرتا، اور وہاں سے ہر مہارت کا مینو اسے سنبھالتا ہے۔"+#: src/components/CreatedItemsList.tsx+msgid "Turn it off any time in Settings."+msgstr "اسے کسی بھی وقت ترتیبات میں بند کریں۔"+#: src/components/NotInSidebarIndicator.tsxmsgid "Turn off Only markdown files"msgstr "«صرف Markdown فائلیں» بند کریں"@@ -12953,6 +13148,10 @@ msgstr "معنوی تلاش فعال کریں؟"msgid "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."msgstr "جو کچھ آپ پڑھتے ہیں اسے واضح، قابلِ اعتماد مضامین میں بدلیں۔ کوئی ماخذ محفوظ کریں، اس کا مطلب سمجھیں، پھر حتمی ورژن رکھیں تاکہ بعد میں اس پر بھروسہ کر سکیں۔"+#: src/components/settings/LintingSection.tsx+msgid "Turning it off"+msgstr "اسے آف کرنا"+#: src/components/acp/working-status.tsmsgid "Turning it over…"msgstr "ہر پہلو سے دیکھا جا رہا ہے…"@@ -13643,6 +13842,10 @@ msgstr "وکی لنک"msgid "Wiki link suggestions"msgstr "وکی لنک کی تجاویز"+#: src/components/settings/LintingSection.tsx+msgid "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+msgstr "وکی لنکس جیسے [[Page]] — یہاں لنک کرنے کا ایک معاون طریقہ ہے، لیکن ایک بیرونی ریڈر کچھ بھی حل نہیں کرتا اور بریکٹ دکھاتا ہے۔"+#: src/components/PublishToGitHubDialog.tsxmsgid "Will be created as <0>{sanitizedName}</0>"msgstr "<0>{sanitizedName}</0> کے نام سے بنے گا"diff --git a/packages/app/src/locales/zh-Hans/messages.json b/packages/app/src/locales/zh-Hans/messages.jsonindex d07841ed3..9b563f3e0 100644--- a/packages/app/src/locales/zh-Hans/messages.json+++ b/packages/app/src/locales/zh-Hans/messages.json@@ -110,6 +110,7 @@"0ySP5u": ["更改会自动保存到此主题。"],"0zAhu6": ["所有文档"],"10g8I_": ["关闭「只显示 markdown 文件」"],+ "110eEb": ["Open Knowledge 在包含 Markdown 的每个文件夹中创建并维护名为 index.md 的导航文件。"],"11ukmX": ["重命名失败:", ["0"]],"12F9WL": ["(无 id)"],"151wvk": ["显示侧边栏"],@@ -127,6 +128,7 @@"1GhYxC": ["共 ", ["totalPages"]],"1HBhDS": ["正在检出文件"],"1J0c0X": ["仍然无法连接 ", ["displayName"], "。要再试一次吗?"],+ "1JpLgH": ["在索引文档中:条目位于节标题下,每个条目都带有一个链接。围绕列表的散文很好。"],"1LtA5r": ["把技能符号链接到 ", ["path"]],"1MGRQl": ["终端会话"],"1NgrlY": ["其他安装方式"],@@ -138,6 +140,7 @@"1V17kO": ["正在加载两个版本"],"1VpfKR": ["为这个项目创建一个技能。"],"1XSMhZ": ["在用<1> git rm --cached</1> 取消跟踪之前,切换到<0>仅本地</0>会被拒绝。"],+ "1ZXkqM": ["随时在“设置”中将其关闭。"],"1ZpfyB": ["用 AI ", ["displayName"], " 打开,", ["hint"]],"1a6ICf": ["正在跟随智能体的编辑"],"1bDVu5": ["工作区命令面板"],@@ -264,6 +267,8 @@"3o3tur": ["初始内容"],"3oh0nQ": [["path"], " 中嵌套的 .okignore 有错误"],"3pU8e-": ["固定标签页"],+ "3qDsdf": ["安装技巧"],+ "3ri_4O": ["让您的知识库与 Open Knowledge Format 保持一致。"],"3s-k7L": [["0", "plural", { "other": ["再显示 ", "#", " 个工具"] }]],"3uSzeS": ["图像可以来自任何地方 · 非图像文件必须位于工作区中"],"3v62tp": ["skills.sh 上的热门"],@@ -395,6 +400,7 @@"5ss1kT": ["你在这台电脑上生成的报告。可以重新发送、显示文件,或删除不再需要的报告。"],"5tcmwY": ["添加值"],"5vAI6Z": ["它不适合我的工作流程"],+ "5w38tn": ["索引维护停止,因为 Open Knowledge 无法到达项目服务器。当项目重新连接时重试。"],"5wV2qQ": ["以及更多"],"5y_9lO": ["正在等待授权"],"6-wLTJ": ["比 origin 落后 ", ["behind"], " 个"],@@ -514,6 +520,7 @@"7d1a0d": ["公开"],"7dZnmw": ["相关度"],"7hctf2": ["描述你想创建的项目"],+ "7idx48": ["OKF 代理技能已安装"],"7jIIFX": ["全都设置好了!"],"7kb4LU": ["已批准"],"7l15X4": ["失败"],@@ -521,6 +528,7 @@"7m3Ade": ["安装量:"],"7qRHf0": ["为 Claude Chat 和 Cowork 安装"],"7uBlRT": ["复制文件树中当前聚焦的项目,以便用「粘贴」创建副本。"],+ "7wogIQ": [["0", "plural", { "other": ["插件"] }]],"80c4-P": ["代码已复制到剪贴板"],"81H_23": ["添加属性"],"851WA-": ["这可以在「设置 > AI 工具与 CLI」中配置"],@@ -565,6 +573,7 @@"8nWu1k": ["空图示"],"8oWgty": ["勾选全部评论以发送"],"8qgfac": ["MCP 服务器"],+ "8rZ1pk": ["启用 ", ["id"]],"8ruqQi": ["失效的内部链接"],"8sMErm": ["要启用「跟随」吗?"],"8t9CRE": ["正在启动 ", ["agentName"], "…"],@@ -715,6 +724,9 @@"BQKHuL": ["重启终端"],"BQu9Pg": ["符号链接"],"BUyQnq": ["无法重启服务器。请在这个文件夹中尝试 `ok start`。"],+ "BVkqD9": [+ "索引维护已暂停,因为另一个 Git 属性控制 index.md。更新 .gitattributes 以便作用域 index.md 路径使用 merge=union,然后重试。"+ ],"BY-g4_": ["添加模式"],"Ba4D2x": ["模板已导入"],"Bdha5y": ["正在发布…"],@@ -731,6 +743,7 @@"Bv5a9_": ["选区统计"],"Bx4EXG": [["label"], " 的操作"],"By-7Pn": ["切换无序列表。"],+ "ByIOcK": ["索引文件保留在原处。 Open Knowledge 仅删除它添加的 Git 规则。"],"BymzO4": ["文档大纲"],"C-mmmK": ["你的端点提供的模型 id。它的向量维度会自动检测——清空该字段即可恢复为 ",@@ -768,6 +781,9 @@"CWjM1r": ["直接位于 ", ["0"], "/ 中的文档"],"CWzc2T": ["无论如何 <0>~/.ok/bin</0> 和 <1>~/.ok/env.sh</1> 都会保留——应用始终会维护它们。"],"CXTwen": ["无法安全地编辑这个项目的配置"],+ "CXcveY": [+ "Open Knowledge 在包含 Markdown 的每个文件夹中维护一个名为 index.md 的导航文件,每个文件夹按类型列出该文件夹的文档并链接到其子文件夹。当您的文档发生更改时,它会重写这些文件,并且您自己编辑到其中的任何内容都会被替换。"+ ],"CXj9C-": ["新属性名"],"C_Lyvh": ["保存主题设置失败"],"C_WGy8": [@@ -791,6 +807,9 @@"Cu6GXQ": ["来源文件夹本身不会移动。"],"CvsD6Y": ["通过 ", ["viaTags"]],"CwOXMT": [["keyName"], " 的值"],+ "CxCOFx": [+ "在 Git 项目中,Open Knowledge 会在仓库根目录的 .gitattributes 文件中添加一条限定范围的规则,以便合并并发的索引更改。"+ ],"CxVk-w": ["对 ", ["address"], " 发表评论"],"D-NlUC": ["跟随系统"],"D-Oh1s": ["如何设置 ", ["0"], "(在浏览器中打开)"],@@ -849,6 +868,9 @@"DhT_PK": ["OpenKnowledge 导入了一个技能"],"DiFKSL": ["正在统计 markdown 文件"],"DiZ3pq": ["图标选择器"],+ "DjNcDy": [+ "使用 title、description、resource 和 tags 时的形状。不需要;声明一个仅固定其类型,因此标记为以逗号分隔的字符串形式编写的 tags 。"+ ],"DmkTrb": ["无法创建此主题。请重试。"],"Dnn2XG": ["自动"],"DpjYd6": ["跳到锚定的文本"],@@ -1032,6 +1054,9 @@"GNkUvW": ["已排队——本次运行结束后发送"],"GQ3O42": ["废纸篓"],"GQDSBN": ["布局选项"],+ "GROUfG": [+ "任何 .mdx 文件。该格式仅限 .md,因此扫描 .md 的阅读器永远不会打开它 - 如果存在同名的 .md,则会读取该文件。"+ ],"GSYWCm": ["隐藏文档面板"],"GUYwCr": ["忽略此提示"],"GUZHkL": ["缺少调色板颜色"],@@ -1165,6 +1190,7 @@"IxHMdF": ["无法删除那条评论。"],"IxyZXD": ["截图"],"Izh19j": ["从 ", ["tail"], " 读取"],+ "J0uRhj": ["检查技能"],"J1XRO3": ["主题颜色"],"J2Mv98": ["名称(例如 ", ["login"], ")"],"J2_JuX": ["无(", ["0"], " 无法匹配任何文档)"],@@ -1183,6 +1209,7 @@"JHf6qZ": ["[email protected]"],"JJcBCm": ["共 ", ["0"], " 个"],"JK-Ave": ["隐藏缩略图"],+ "JKXcOi": ["已经在项目中"],"JL3si7": ["正在更新"],"JLUTgi": ["还没有标签——在任意文档中写下 `#tagname` 即可填充索引。"],"JLzQi_": ["关闭 ", ["accessibleLabel"]],@@ -1266,6 +1293,9 @@"L-rMC9": ["重置为默认值"],"L1BQTH": [["0"], " 尚未安装——正在打开它的下载页面。"],"L1ZE3M": ["文档统计"],+ "L3BcJ4": [+ "这个需要查看您的文件,而不仅仅是打开的文档,因此它会在您运行项目审核时出现,而不是在您键入时出现。"+ ],"L3CEC1": ["这个项目"],"L3w0_C": ["在独立窗口中将文档演示为幻灯片。在文档的 frontmatter 中添加 <0>slides: true</0>,然后通过 Slidev 操作打开它。渲染由 Slidev CLI 完成,OpenKnowledge 不捆绑它。"@@ -1673,6 +1703,12 @@"R6ABfU": ["直接工作,不先制定计划"],"R9IDFz": ["会重命名磁盘上的文件夹,以及智能体调用它时使用的 id。"],"R9dK63": ["示例图片"],+ "RB_g_C": [+ "在根索引上,okf_version 被写为带引号的字符串,如 \"0.2\"。不加引号,YAML 将其读取为数字,0.10 默默地变成 0.1。"+ ],+ "RD6H9q": [+ "当文档更改时,Open Knowledge 会重写这些 index.md 文件,因此对它们的手动编辑将被替换。"+ ],"RDjuBN": ["设置"],"RDrXh4": ["配置用户、项目和集成相关的设置。"],"RG3yW6": ["输入此主题的名称。"],@@ -1740,6 +1776,9 @@"SF9qpO": ["留下你的邮箱以便我们跟进"],"SFEWV6": ["无法加载 OpenKnowledge 技能。请重试。"],"SFN6dN": ["三级标题"],+ "SIPelo": [+ "索引维护已暂停,因为 Open Knowledge 无法确认所需的 Git 合并规则。检查 Git 和 .gitattributes,然后重试。"+ ],"SInSnF": ["参考 <0>", ["0"], "</0>"],"SItQRc": ["你觉得 OpenKnowledge 怎么样?"],"SOPwPh": ["恢复到这次编辑"],@@ -2026,6 +2065,7 @@"X7u0xR": ["有 ", ["0"], " 个模板可用"],"X8kjQX": ["重新通过 GitHub 认证"],"X9VpsP": ["正在加载文件夹内容"],+ "XAnapw": ["Git 合并规则"],"XAyxsa": ["检出远程分支"],"XBBZnv": ["链接目标“", ["shown"], "”未指向现有文档。"],"XBgr2S": ["复制进来"],@@ -2132,6 +2172,9 @@"Y_iImT": ["无法解析文件 ", ["identity"], "。转到引用位置。"],"Y_kL7X": ["自定义编辑器的外观和行为。"],"Ya3PlJ": ["需要授权"],+ "YaVU2F": [+ "在 Git 项目中,Open Knowledge 还添加了一个作用域 .gitattributes 规则,以便在下一次重建之前合并并发索引更改。"+ ],"YaeyFh": ["拉取可能会覆盖你本地文件中未提交的编辑。"],"Yb82LN": ["ID:", ["0"]],"Yea-K5": ["恢复到这个时间点"],@@ -2241,6 +2284,7 @@"_Bix3-": [["localizedFirstMessage"], " 的出现位置"],"_DwR-n": ["正在创建…"],"_FLBbi": [["sizeText"], " · 已隐去机密信息 · 崩溃转储未隐去"],+ "_G7A92": ["维护index.md"],"_GRWOJ": ["要更换嵌入服务提供方吗?"],"_HgF9q": ["排序方式"],"_IGfXZ": ["OpenKnowledge 上次意外退出了。"],@@ -2319,10 +2363,12 @@"无法连接到智能体服务。请确认 OpenKnowledge 服务器正在运行且为最新版本(如果它已在运行,请重启),然后重试。"],"aalx4E": ["正在编辑损坏的 MDX 源码:", ["reason"]],+ "aatPoi": ["生成的文件"],"abiHje": ["删除选中的项目"],"adsMWO": ["正在解析差异"],"ah_ekO": ["“", ["name"], "”已是最新"],"aiArms": ["我们无法克隆这个仓库。"],+ "aiOceC": ["启用索引"],"ajHi4O": ["自动同步已暂停——你没有推送到这个仓库的权限。切换到「跟随」以继续接收更新。"],"ajz9F8": ["无法加载 ", ["filePath"], " 的冲突内容。请尝试重新加载页面。"],"ak4LLg": ["清空菜单"],@@ -2438,11 +2484,13 @@],"cb-0G0": ["清除颜色"],"ccNps_": ["仅显示已修改的"],+ "cd3THN": ["文件结构"],"cd5EXh": ["报告问题"],"cdm00A": ["无入链"],"cdmk8A": ["未提交的改动"],"cgl-gn": ["已连接到 GitHub"],"chL5IG": ["社区"],+ "ciozf1": ["项目中已有的技能"],"cjtjry": ["在 OpenKnowledge 的导航历史中后退。"],"cklVjM": ["时间线"],"clJ3qM": ["完成。"],@@ -2607,6 +2655,7 @@"fbdLmk": ["切换粗体格式。"],"fbsiBw": ["启动终端时出了点问题。"],"fcgvCA": ["Claude"],+ "fdKQAE": ["将其关闭"],"fdeFfN": ["(二进制文件,无法预览)"],"fevEu0": ["拉取最新改动"],"ffH3Rt": ["添加评论(Enter)"],@@ -2665,12 +2714,16 @@"gUx34c": ["OpenKnowledge 使用的语言;“跟随系统”会跟随你的操作系统。你自己的笔记仍保持你书写时的语言。"],+ "gVMkEr": [+ "在日志文档中:条目标题以 ISO YYYY-MM-DD 日期开头,最新的在前。您使用多少个 title,以及条目是否为项目符号,都取决于您。"+ ],"gY7wnY": ["正在登录 ", ["agentName"], "…"],"gYz2ep": [["timeLabel"], "后过期"],"gZElfU": ["正在修复第 ", ["0"], "/", ["1"], " 个文件"],"gZiT5e": ["要把这些符号链接替换为独立副本吗?"],"gayL_Q": ["发布计划"],"gbHcbI": ["删除属性失败"],+ "gfYI3o": ["禁用 ", ["id"]],"gfb-CM": ["无法获取分支——请登录 GitHub 后重试。"],"gfdqcY": ["无法应用该更改:", ["0"]],"gfohmY": ["连接工具"],@@ -2723,6 +2776,9 @@"hLKfZe": ["改用令牌"],"hLod4_": ["转换为模板"],"hLy8b1": ["已更新到版本 ", ["version"]],+ "hPQBsa": [+ "保留文件以小写形式命名为 index.md 和 log.md。在区分大小写的文件系统上,Index.md 被作为普通文档读取并失去其含义。"+ ],"hQXiDc": ["搜索分支…"],"hQjvzi": ["一个 .zip 或 .skill 压缩包。"],"hS0wC4": ["OpenKnowledge 恢复了 ", ["subject"], " 的较早版本"],@@ -2846,6 +2902,7 @@"iy64Li": ["完全同步——你的编辑会自动提交并推送到你的远程仓库。"],"iycx_A": ["正在推送"],"iz1LdD": ["自上次在这里写入后,它在 OK 之外被改动过——显示的是磁盘上现在的状态"],+ "j-o6Z2": ["由于无法保存项目设置,索引维护已停止。检查项目文件权限,然后重试。"],"j15ZSH": ["把评论发送到"],"j2229h": ["正在删除 OpenKnowledge 的文件…"],"j2kt1j": [@@ -2927,6 +2984,7 @@"k4CuuV": ["现成的文件夹和模板,帮你快速上手。选择一个包可以预览会创建哪些内容,然后再添加到你的项目中。"],+ "k5rKNs": ["frontmatter"],"k7Hoig": ["这个版本没有内容改动。"],"k8xtrB": ["对于 <0>",@@ -2964,7 +3022,9 @@"kSiB3X": ["无法移到", ["trashNoun"]],"kUn-CN": ["同步已关闭"],"kV2YZv": ["没看到<0>技能</0>?请先启用<1>设置 <2/> 功能 <3/> 代码执行与文件创建</1>。"],+ "kVS5tE": ["在每个文件夹中维护 generated 索引?"],"kVgQUA": ["删除此对话?"],+ "kVzuTI": ["推荐代理技能"],"kYL1lH": ["智能体活动"],"k_Dqw1": [["0", "plural", { "other": ["#", " 个文档均无问题。"] }]],"k_pade": ["配置现在已共享。提交这些 OK 文件即可分享给你的团队。"],@@ -3047,7 +3107,9 @@"lWNpNB": ["通过 CodeMirror 添加光标或选中匹配项。"],"lXKZGw": ["一级标题"],"lY27jj": [["0"], " 年前"],+ "lY7Unt": ["启用索引生成"],"lZAiSP": ["反向链接响应的结构与预期不符。"],+ "lZoQdy": ["开放技能"],"lZvQrY": ["把 ", ["0"], " 用作深色主题"],"l_6JHD": ["搜索图标..."],"l_FAT6": ["只能使用字母、数字、<0>-</0> 或 <1>_</1>。"],@@ -3065,6 +3127,7 @@"ljHjfg": ["那个分支已经在另一个 worktree 中打开了。"],"lkYioO": ["显示或隐藏文档面板"],"ll2yNl": ["内容目录"],+ "llXHHh": [["pluginCount", "plural", { "other": ["插件"] }]],"lmBPt0": ["只有外部链接才会发起请求。指向本项目其他文档的链接从本地索引生成预览,绝不会离开你的电脑。"],@@ -3117,6 +3180,9 @@{ "other": ["把这 ", "#", " 个问题交给你的 AI 智能体,包括没有自动修复方案的部分。"] }]],+ "mhnCt3": [+ "每个概念文档都带有一个非空类型。这是 OKF 的一致性底线的全部 - 只有类型的文档是完全一致的。"+ ],"mk2poV": ["例如 server.ts"],"mlvM8g": ["无法重新定位那条评论。"],"mmpzAq": ["在 markdown 源码编辑器中对长行自动换行。"],@@ -3346,6 +3412,9 @@"qRZh7J": ["让 Tab 键离开源码编辑器,而不是缩进。"],"qSKu2v": ["源码导航与选择"],"qSxaOz": ["接受对方的删除"],+ "qTT48-": [+ "像 [[Page]] 这样的 Wiki 链接 — 一种受支持的链接方式,但外部阅读器无法解析任何内容并显示括号。"+ ],"qTcVwj": ["为这个项目浏览或上传技能。"],"qTcZZu": ["加载标签失败。按 <0>Esc</0> 后重新打开可重试。"],"qX-ABr": ["或者改用浏览器登录:"],@@ -3379,6 +3448,7 @@"r51jLC": ["文件已保存,Claude 桌面应用已打开"],"r6ncaO": ["关闭标签页"],"r6y-jM": ["警告"],+ "r7IaYp": ["Open Knowledge Format 指导"],"r871ed": ["你的知识库现在已经在 GitHub 上,地址是 <0>",["ownerLogin"],@@ -3406,6 +3476,7 @@"rZVMkf": ["可视化编辑器替换输入框已聚焦"],"radOpL": ["图片 ", ["identity"], "。转到引用位置。"],"rageVb": ["带实时预览面板的自定义 HTML(沙箱 iframe)。"],+ "rarziH": ["帮助编码代理选择 OKF 文档类型、保留来源并避免发明不受支持的元数据。"],"rbrHTd": ["已批准 — ", ["optionName"]],"rcJmK8": ["把这些位置改为副本"],"rdU729": ["布局"],@@ -3452,6 +3523,7 @@"sER-bs": ["文件"],"sFhaTJ": ["用于在菜单中区分名称相近的模板。"],"sGZLfB": ["获取仓库列表失败"],+ "sHDllh": ["停止维护 index.md"],"sICrVf": ["已恢复到 ", ["0"], " 的版本"],"sIGbBZ": ["把所选内容转换为脚注"],"sIxSSP": ["在你的终端中解决冲突"],@@ -3465,6 +3537,7 @@"sOxZaS": ["加载关系图失败"],"sQoLn0": ["退出"],"sR0I-f": ["折叠全部文件"],+ "sSRndh": ["开始维护 index.md"],"sW5OjU": ["必填"],"sZ2IOu": ["这个",@@ -3479,6 +3552,9 @@"saIASg": ["第二项"],"saYiIO": ["路径不能包含空字节"],"scu3wk": ["模型"],+ "scyoP9": [+ "索引文档不包含 frontmatter,除了知识库根目录中的 frontmatter 。日志文档不被覆盖——OKF不限制它们的frontmatter。"+ ],"se-tU0": ["无法修复 ", ["total"], " 个文件中的 ", ["0"], " 个。"],"seeS6l": ["要在这个文件夹中设置 OpenKnowledge 吗?"],"sgmRY8": ["已跳过下载 ", ["0"], "。"],@@ -3525,6 +3601,9 @@"tHKQ6j": ["正在重命名"],"tKlWWY": ["表情符号"],"tLX6LY": ["OpenKnowledge 写入了一个文档"],+ "tM5uzl": [+ "出处、信任和生命周期系列:sources、generated、verified、status 和 stale_after。每个字段都是可选的,缺席绝不是一个错误。"+ ],"tN5WTS": ["服务提供方拒绝了这个请求。请检查 API 密钥和模型 id。"],"tP5DDk": ["应用链接"],"tUvUfp": ["使用你已有的文件夹。"],@@ -3574,6 +3653,7 @@"uGaIIS": ["检出 worktree"],"uH_S-u": [["loadErrorTitle"], ":", ["message"]],"uJfwF8": ["已安装——没有可导入的新内容。"],+ "uK2peg": ["根据 Open Knowledge Format 检查您的项目。随时在“设置”中将其关闭。"],"uKRYiW": ["同步状态不可用——服务器错误。"],"uL_Wx8": ["终端意外停止了。"],"uM6jnS": ["恢复失败"],@@ -3609,6 +3689,9 @@"uyOQ4e": ["主题已复制为 base16 YAML"],"uynXup": [["tokens", "plural", { "other": ["token"] }]],"v-h2hx": ["删除 ", ["targetGitPath"]],+ "v15iQB": [+ "经证明的计算合约。仅适用于类型为 Attested Computation 的文档,其中 OKF 需要 runtime;普通概念不受影响。"+ ],"v2ZW0K": ["启用终端"],"v2a04T": ["markdownlint 规则"],"v41fCm": ["找不到文件"],diff --git a/packages/app/src/locales/zh-Hans/messages.po b/packages/app/src/locales/zh-Hans/messages.poindex 3912e4a7c..7e0858127 100644--- a/packages/app/src/locales/zh-Hans/messages.po+++ b/packages/app/src/locales/zh-Hans/messages.po@@ -263,6 +263,11 @@ msgstr "{0, plural, other {当前匹配 {4} 个文档中的 {3} 个。}}"msgid "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"msgstr "{0, plural, other {# 个文档均无问题。}}"+#. placeholder {0}: pluginRows.length+#: src/components/CreatedItemsList.tsx+msgid "{0, plural, one {Plugin} other {Plugins}}"+msgstr "{0, plural, other {插件}}"+#. placeholder {0}: editorList.hiddenCount#: src/components/McpConsentDialogBody.tsxmsgid "{0, plural, one {Show # more tool} other {Show # more tools}}"@@ -629,7 +634,9 @@ msgstr "{displayName} CLI,{hint}"msgid "{docName} is {0}. OpenKnowledge currently opens files up to {1}."msgstr "{docName} 有 {0}。OpenKnowledge 目前最多可打开 {1} 的文件。"+#. placeholder {0}: OKF_RULE_IDS.length#. placeholder {0}: entries.length+#: src/components/settings/LintingSection.tsx#: src/components/settings/markdownlint-rule-browser.tsxmsgid "{enabledCount}/{0} on"msgstr "已开启 {enabledCount}/{0}"@@ -792,6 +799,10 @@ msgstr "已使用 {percent}%(剩余 {left}%)"msgid "{phase} — {pct}%"msgstr "{phase} — {pct}%"+#: src/components/CreatedItemsList.tsx+msgid "{pluginCount, plural, one {plugin} other {plugins}}"+msgstr "{pluginCount, plural, other {插件}}"+#: src/components/PropertyDisclosure.tsxmsgid "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"msgstr "{problemCount, plural, other {# 个属性与架构不匹配}}"@@ -1547,6 +1558,10 @@ msgstr "已被选中的上级文件夹覆盖"msgid "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."msgstr "已经有 git 仓库了?在这个项目的文件夹中用 <0>git remote add origin <url></0> 添加它。检测到远程仓库后,本页会自动更新。"+#: src/components/settings/LintingSection.tsx+msgid "Already in project"+msgstr "已经在项目中"+#: src/components/SkillPluginBundleDialog.tsxmsgid "Already installed — nothing new to import."msgstr "已安装——没有可导入的新内容。"@@ -1592,6 +1607,10 @@ msgstr "另一个同步操作正在进行中。请稍后再试。"msgid "any"msgstr "任意"+#: src/components/settings/LintingSection.tsx+msgid "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+msgstr "任何 .mdx 文件。该格式仅限 .md,因此扫描 .md 的阅读器永远不会打开它 - 如果存在同名的 .md,则会读取该文件。"+#. placeholder {0}: summary.name#: src/components/settings/LintingSection.tsxmsgid "any doc named {0}"@@ -2152,6 +2171,7 @@ msgstr "无法共享此路径。"#: src/components/ReportBugDialogBody.tsx#: src/components/SeedDialog.tsx#: src/components/settings/LinkPreviewsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/SavedThemesTiles.tsx#: src/components/settings/SearchSection.tsx#: src/components/ShareBranchSwitchDialog.tsx@@ -2292,6 +2312,10 @@ msgstr "正在检出文件"msgid "Checking sign-in status"msgstr "正在检查登录状态"+#: src/components/settings/LintingSection.tsx+msgid "Checking skill"+msgstr "检查技能"+#: src/components/ImportSkillForm.tsxmsgid "Checking source"msgstr "正在检查来源"@@ -2308,6 +2332,10 @@ msgstr "正在检查…"msgid "Checklist with checkboxes."msgstr "带复选框的清单。"+#: src/components/CreatedItemsList.tsx+msgid "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+msgstr "根据 Open Knowledge Format 检查您的项目。随时在“设置”中将其关闭。"+#: src/components/ImportSkillForm.tsxmsgid "Choose a skill archive"msgstr "选择技能压缩包"@@ -4304,6 +4332,10 @@ msgstr "禁用 {0}"msgid "Disable {file}"msgstr "禁用 {file}"+#: src/components/settings/LintingSection.tsx+msgid "Disable {id}"+msgstr "禁用 {id}"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "Disable external link previews"msgstr "关闭外部链接预览"@@ -4406,6 +4438,10 @@ msgstr "文档面板"msgid "Document statistics"msgstr "文档统计"+#: src/components/settings/LintingSection.tsx+msgid "Document structure"+msgstr "文件结构"+#: src/components/empty-state/use-create-suggestions.tsmsgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."msgstr "记录这个仓库的架构:创建一页总览,链接到每个主要模块的页面,说明各自的职责和入口。"@@ -4797,6 +4833,10 @@ msgstr "启用 {displayName} CLI"msgid "Enable {file}"msgstr "启用 {file}"+#: src/components/settings/LintingSection.tsx+msgid "Enable {id}"+msgstr "启用 {id}"+#: src/components/AutoSyncOnboardingDialog.tsx#: src/components/EnableSyncConfirmDialog.tsx#: src/components/share-receive-miss-content.tsx@@ -4821,6 +4861,10 @@ msgstr "要启用「跟随」吗?"msgid "Enable git auto-sync?"msgstr "要启用 git 自动同步吗?"+#: src/components/settings/LintingSection.tsx+msgid "Enable indexes"+msgstr "启用索引"+#: src/components/ProblemsPanel.tsxmsgid "Enable plugins"msgstr "启用插件"@@ -4849,6 +4893,10 @@ msgstr "为这个项目启用终端"msgid "Enable Themes"msgstr "启用主题"+#: src/components/settings/LintingSection.tsx+msgid "Enabling index generation"+msgstr "启用索引生成"+#: src/components/ActivityModeContent.tsxmsgid "Ended"msgstr "已结束"@@ -4919,6 +4967,10 @@ msgstr "错误:"msgid "Escape"msgstr "Esc"+#: src/components/settings/LintingSection.tsx+msgid "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+msgstr "每个概念文档都带有一个非空类型。这是 OKF 的一致性底线的全部 - 只有类型的文档是完全一致的。"+#: src/components/settings/LintingSection.tsxmsgid "every doc"msgstr "所有文档"@@ -5694,6 +5746,10 @@ msgstr "来自模板"msgid "From the {0} plugin"msgstr "来自 {0} 插件"+#: src/components/settings/LintingSection.tsx+msgid "Frontmatter"+msgstr "frontmatter"+#: src/components/TemplateForm.tsxmsgid "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."msgstr "用这个模板创建的每个文档都以这段 frontmatter 开头。值使用 YAML——列表写作 <0>[a, b]</0>;<1>{{date}}</1> 会在创建时填入。"@@ -5736,6 +5792,10 @@ msgstr "游戏结束 · 按空格再玩一次"msgid "General"msgstr "通用"+#: src/components/settings/LintingSection.tsx+msgid "Generated files"+msgstr "生成的文件"+#: src/components/TerminalCliMissingBanner.tsxmsgid "Get {displayName}"msgstr "获取 {displayName}"@@ -5769,6 +5829,10 @@ msgstr "git 配置不可用"msgid "Git identity isn't set — commits use a default author. Set yours so teammates see your name."msgstr "尚未设置 git 身份——提交会使用默认作者。设置你自己的身份,队友才能看到你的名字。"+#: src/components/settings/LintingSection.tsx+msgid "Git merge rule"+msgstr "Git 合并规则"+#: src/components/ShareBranchSwitchDialog.tsxmsgid "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."msgstr "Git 在这个仓库中需要 {tool},但它未安装或找不到。请先安装再重试。"@@ -5923,7 +5987,7 @@ msgstr "heading-slug"msgid "Headings"msgstr "标题"-#: src/components/AutoSyncEnableWarning.tsx+#: src/components/DisclosureWarning.tsx#: src/editor/slash-command/component-items.tsxmsgid "Heads up"msgstr "注意"@@ -5945,6 +6009,10 @@ msgstr "你好,世界!"msgid "Help"msgstr "帮助"+#: src/components/settings/LintingSection.tsx+msgid "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+msgstr "帮助编码代理选择 OKF 文档类型、保留来源并避免发明不受支持的元数据。"+#. Subtext for the open-knowledge-discovery skill row#. Subtext for the open-knowledge-discovery skill row#: src/components/McpConsentDialogBody.tsx@@ -6277,10 +6345,18 @@ msgstr "已作为“{0}”导入——名称“{1}”已被占用。"msgid "Importing"msgstr "正在导入"+#: src/components/settings/LintingSection.tsx+msgid "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+msgstr "在日志文档中:条目标题以 ISO YYYY-MM-DD 日期开头,最新的在前。您使用多少个 title,以及条目是否为项目符号,都取决于您。"+#: src/components/SeedDialog.tsxmsgid "In a subfolder"msgstr "在子文件夹中"+#: src/components/settings/LintingSection.tsx+msgid "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+msgstr "在索引文档中:条目位于节标题下,每个条目都带有一个链接。围绕列表的散文很好。"+#: src/components/empty-state/CreatePromptComposer.tsx#: src/components/handoff/AgentSplitButton.tsx#: src/components/handoff/OpenInAgentContextSubmenu.tsx@@ -6299,6 +6375,14 @@ msgstr "在应用内"msgid "In app (beta)"msgstr "在应用内(beta)"+#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+msgstr "在 Git 项目中,Open Knowledge 会在仓库根目录的 .gitattributes 文件中添加一条限定范围的规则,以便合并并发的索引更改。"++#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+msgstr "在 Git 项目中,Open Knowledge 还添加了一个作用域 .gitattributes 规则,以便在下一次重建之前合并并发索引更改。"+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "In the Claude Desktop App"msgstr "在 Claude 桌面应用中"@@ -6323,6 +6407,26 @@ msgstr "增加或减少当前列表项的缩进。"msgid "Indented blockquote for citations."msgstr "用于引用的缩进引文块。"+#: src/components/settings/LintingSection.tsx+msgid "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+msgstr "索引文档不包含 frontmatter,除了知识库根目录中的 frontmatter 。日志文档不被覆盖——OKF不限制它们的frontmatter。"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+msgstr "索引维护已暂停,因为另一个 Git 属性控制 index.md。更新 .gitattributes 以便作用域 index.md 路径使用 merge=union,然后重试。"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+msgstr "索引维护已暂停,因为 Open Knowledge 无法确认所需的 Git 合并规则。检查 Git 和 .gitattributes,然后重试。"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+msgstr "索引维护停止,因为 Open Knowledge 无法到达项目服务器。当项目重新连接时重试。"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+msgstr "由于无法保存项目设置,索引维护已停止。检查项目文件权限,然后重试。"+#: src/components/settings/SearchSection.tsxmsgid "Indexed {embedded} of {total} pages."msgstr "已索引 {total} 个页面中的 {embedded} 个。"@@ -6511,6 +6615,10 @@ msgstr "安装到所有智能体"msgid "Install selected"msgstr "安装选中项"+#: src/components/settings/LintingSection.tsx+msgid "Install skill"+msgstr "安装技巧"+#: src/components/SkillPluginBundleBanner.tsxmsgid "Install skills"msgstr "安装技能"@@ -6520,6 +6628,7 @@ msgid "Install the gh CLI"msgstr "安装 gh CLI"#: src/components/settings/AiToolsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ProjectAiToolsSection.tsx#: src/components/SkillEditorActions.tsxmsgid "Installed"@@ -6733,6 +6842,10 @@ msgstr "让这个项目与你的 git 远程保持同步。「跟随」只获取msgid "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."msgstr "记录你打交道的人和公司,以及你们之间的会面。适合用来记住某人是谁、你怎么认识他们,以及上次聊了什么。"+#: src/components/settings/LintingSection.tsx+msgid "Keeps your knowledge base aligned with the Open Knowledge Format."+msgstr "让您的知识库与 Open Knowledge Format 保持一致。"+#. placeholder {0}: toName.trim()#: src/components/SkillForkDialog.tsxmsgid "Kept both — \"{0}\" is its own skill now"@@ -7108,6 +7221,14 @@ msgstr "正在寻找 <0>{lookingForUrl}</0>。"msgid "Lost connection to \"{docName}\"."msgstr "与“{docName}”的连接已断开。"+#: src/components/settings/LintingSection.tsx+msgid "Maintain generated indexes in every folder?"+msgstr "在每个文件夹中维护 generated 索引?"++#: src/components/settings/LintingSection.tsx+msgid "Maintain index.md"+msgstr "维护index.md"+#: src/components/SkillInstallMenu.tsxmsgid "make source"msgstr "设为来源"@@ -8252,6 +8373,10 @@ msgstr "OK 桌面版"msgid "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."msgstr "OK 上次把这个文件夹设为 {0}——此后 OK 之外的操作改动过它。显示的是磁盘上现在的状态;你下一次的「符号链接/取消链接」会覆盖它。"+#: src/components/settings/LintingSection.tsx+msgid "OKF agent skill installed"+msgstr "OKF 代理技能已安装"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "On — hovering an external link sends its URL to the destination site to fetch a preview."msgstr "开启——把鼠标悬停在外部链接上时,会把它的 URL 发送到目标站点以获取预览。"@@ -8268,6 +8393,10 @@ msgstr "在 <0>{address}</0> 上"msgid "On selected text in <0>{address}</0>"msgstr "在 <0>{address}</0> 中选中的文本上"+#: src/components/settings/LintingSection.tsx+msgid "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+msgstr "在根索引上,okf_version 被写为带引号的字符串,如 \"0.2\"。不加引号,YAML 将其读取为数字,0.10 默默地变成 0.1。"+#. Next step for a Cursor project MCP row — Cursor leaves project servers disabled#: src/components/settings/ProjectAiToolsSection.tsxmsgid "One more step: enable it in Cursor → Settings → Tools & MCP (Cursor leaves project servers off until you turn them on)."@@ -8490,6 +8619,22 @@ msgstr "在 worktree 中打开"msgid "Open it there"msgstr "在那里打开"+#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+msgstr "Open Knowledge 在包含 Markdown 的每个文件夹中创建并维护名为 index.md 的导航文件。"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge Format guidance"+msgstr "Open Knowledge Format 指导"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+msgstr "Open Knowledge 在包含 Markdown 的每个文件夹中维护一个名为 index.md 的导航文件,每个文件夹按类型列出该文件夹的文档并链接到其子文件夹。当您的文档发生更改时,它会重写这些文件,并且您自己编辑到其中的任何内容都会被替换。"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+msgstr "当文档更改时,Open Knowledge 会重写这些 index.md 文件,因此对它们的手动编辑将被替换。"+#. placeholder {0}: item.displayName#. placeholder {1}: item.displayName#. placeholder {2}: item.version@@ -8536,6 +8681,10 @@ msgstr "打开设置"msgid "Open shared {targetNoun}"msgstr "打开共享的{targetNoun}"+#: src/components/settings/LintingSection.tsx+msgid "Open skill"+msgstr "开放技能"+#: src/editor/extensions/JsxComponentView.tsxmsgid "Open source doc: {mirrorSrc}"msgstr "打开来源文档:{mirrorSrc}"@@ -9372,6 +9521,7 @@ msgid "project"msgstr "项目"#: src/components/CommandPalette.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ScopeBadge.tsx#: src/lib/skill-scope.tsmsgid "Project"@@ -9643,6 +9793,10 @@ msgstr "最近的项目"msgid "Recently opened"msgstr "最近打开"+#: src/components/settings/LintingSection.tsx+msgid "Recommended agent skill"+msgstr "推荐代理技能"+#: src/components/SyncStatusBadge.tsxmsgid "Reconnect required"msgstr "需要重新连接"@@ -10080,6 +10234,10 @@ msgstr "研究不会飞的鸟类的灭绝"msgid "research-note"msgstr "research-note"+#: src/components/settings/LintingSection.tsx+msgid "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+msgstr "保留文件以小写形式命名为 index.md 和 log.md。在区分大小写的文件系统上,Index.md 被作为普通文档读取并失去其含义。"+#: src/components/settings/CustomThemeEditor.tsxmsgid "Reset"msgstr "重置"@@ -10322,6 +10480,7 @@ msgid "Rule editing is available for the project's root markdownlint config"msgstr "规则编辑仅适用于项目根目录的 markdownlint 配置"#: src/components/LintConfigEditor.tsx+#: src/components/settings/LintingSection.tsxmsgid "Rules"msgstr "规则"@@ -11264,6 +11423,10 @@ msgstr "未为 {conflictHosts} 安装技能“{conflictName}”——你在那msgid "Skill \"{name}\" created"msgstr "已创建技能“{name}”"+#: src/components/settings/LintingSection.tsx+msgid "Skill already in project"+msgstr "项目中已有的技能"+#: src/components/ExploreSkills.tsxmsgid "Skill discovery powered by <0>skills.sh</0>"msgstr "技能发现由 <0>skills.sh</0> 提供支持"@@ -11523,6 +11686,10 @@ msgstr "起始于"msgid "Start here: what this is and how it's organized."msgstr "从这里开始:这是什么,以及它是怎么组织的。"+#: src/components/settings/LintingSection.tsx+msgid "Start maintaining index.md"+msgstr "开始维护 index.md"+#: src/lib/keyboard-shortcuts.tsmsgid "Start source completion"msgstr "启动源码补全"@@ -11618,6 +11785,10 @@ msgstr "停止修复文件"msgid "Stop fixing. Files already fixed stay fixed."msgstr "停止修复。已修复的文件保持已修复状态。"+#: src/components/settings/LintingSection.tsx+msgid "Stop maintaining index.md"+msgstr "停止维护 index.md"+#: src/lib/project-fix-sweep-store.tsmsgid "Stopped fixing. Files already fixed stay fixed."msgstr "已停止修复。已修复的文件保持已修复状态。"@@ -12121,6 +12292,10 @@ msgstr "智能体没有停止。强制停止将关闭此对话并退出智能体msgid "The agent's persona, values, and voice."msgstr "智能体的人设、价值观和语气。"+#: src/components/settings/LintingSection.tsx+msgid "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+msgstr "经证明的计算合约。仅适用于类型为 Attested Computation 的文档,其中 OKF 需要 runtime;普通概念不受影响。"+#: src/components/ProblemsPanel.tsxmsgid "The audit could not be completed. Try again."msgstr "审查未能完成。请重试。"@@ -12179,6 +12354,10 @@ msgstr "公式 <0>c = √(a² + b²)</0> 以行内形式渲染。"msgid "the git exclude file isn't writable"msgstr "git 的 exclude 文件不可写"+#: src/components/settings/LintingSection.tsx+msgid "The index files stay in place. Open Knowledge removes only the Git rule it added."+msgstr "索引文件保留在原处。 Open Knowledge 仅删除它添加的 Git 规则。"+#: src/lib/locale-load-failure-notice.tsmsgid "The interface is still in the language you were reading. Check your connection, then reload to try again."msgstr "界面仍是你当时阅读的语言。请检查网络连接,然后重新加载再试一次。"@@ -12215,6 +12394,10 @@ msgstr "这个文档顶部的属性块有格式错误。请切换到源码模式msgid "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."msgstr "属性有改动,但无法比较——YAML 解析失败。两个版本均按原样显示。"+#: src/components/settings/LintingSection.tsx+msgid "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+msgstr "出处、信任和生命周期系列:sources、generated、verified、status 和 stale_after。每个字段都是可选的,缺席绝不是一个错误。"+#: src/components/settings/SearchSection.tsxmsgid "The provider is rate-limiting this key. Try again in a moment."msgstr "服务提供方正在对这个密钥限流。请稍后再试。"@@ -12252,6 +12435,10 @@ msgstr "架构文件不存在或加载失败——添加字段会自动创建它msgid "the server responded but server.lock has no port yet"msgstr "服务器有响应,但 server.lock 中还没有端口"+#: src/components/settings/LintingSection.tsx+msgid "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+msgstr "使用 title、description、resource 和 tags 时的形状。不需要;声明一个仅固定其类型,因此标记为以逗号分隔的字符串形式编写的 tags 。"+#: src/components/SkillInstallMenu.tsxmsgid "The skill's own folder — the source other locations copy or link from"msgstr "技能自己的文件夹——其他位置从这里复制或链接"@@ -12565,6 +12752,10 @@ msgstr "这可能需要一点时间。你的 markdown 内容会保留。"msgid "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."msgstr "这会把 <0>{name}</0> 从 {0} 移到 {1},在磁盘上重新放置它的文件,并在你的编辑器中以 {2} 级别重新安装它。"+#: src/components/settings/LintingSection.tsx+msgid "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+msgstr "这个需要查看您的文件,而不仅仅是打开的文档,因此它会在您运行项目审核时出现,而不是在您键入时出现。"+#: src/components/SeedDialog.tsxmsgid "This pack is already set up here."msgstr "这个包在这里已经设置好了。"@@ -12928,6 +13119,10 @@ msgstr "把 {0} 变回一个真实目录,其中为它当前看到的每个技msgid "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."msgstr "把 {display} 变回一个真实目录,其中为它当前看到的每个技能各放一个符号链接——一切照常可用,之后由每个技能自己的菜单来管理。"+#: src/components/CreatedItemsList.tsx+msgid "Turn it off any time in Settings."+msgstr "随时在“设置”中将其关闭。"+#: src/components/NotInSidebarIndicator.tsxmsgid "Turn off Only markdown files"msgstr "关闭「只显示 markdown 文件」"@@ -12953,6 +13148,10 @@ msgstr "要开启语义搜索吗?"msgid "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."msgstr "把你读过的东西变成清晰可信的文章。保存来源,弄清它的含义,再留下最终版本,以便日后可以放心引用。"+#: src/components/settings/LintingSection.tsx+msgid "Turning it off"+msgstr "将其关闭"+#: src/components/acp/working-status.tsmsgid "Turning it over…"msgstr "正在反复推敲…"@@ -13643,6 +13842,10 @@ msgstr "维基链接"msgid "Wiki link suggestions"msgstr "维基链接建议"+#: src/components/settings/LintingSection.tsx+msgid "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+msgstr "像 [[Page]] 这样的 Wiki 链接 — 一种受支持的链接方式,但外部阅读器无法解析任何内容并显示括号。"+#: src/components/PublishToGitHubDialog.tsxmsgid "Will be created as <0>{sanitizedName}</0>"msgstr "将创建为 <0>{sanitizedName}</0>"diff --git a/packages/app/src/locales/zh-Hant/messages.json b/packages/app/src/locales/zh-Hant/messages.jsonindex f2c84b23e..79508d0e8 100644--- a/packages/app/src/locales/zh-Hant/messages.json+++ b/packages/app/src/locales/zh-Hant/messages.json@@ -110,6 +110,7 @@"0ySP5u": ["變更會自動儲存到這個主題。"],"0zAhu6": ["所有文件"],"10g8I_": ["關閉「只顯示 markdown 檔案」"],+ "110eEb": ["Open Knowledge 在包含 Markdown 的每個資料夾中建立並維護名為 index.md 的導覽檔案。"],"11ukmX": ["重新命名失敗:", ["0"]],"12F9WL": ["(無 id)"],"151wvk": ["顯示側邊欄"],@@ -127,6 +128,7 @@"1GhYxC": ["共 ", ["totalPages"]],"1HBhDS": ["正在簽出檔案"],"1J0c0X": ["仍然無法連線到 ", ["displayName"], "。要再試最後一次嗎?"],+ "1JpLgH": ["在索引文件中:條目位於節標題下,每個條目都帶有連結。圍繞列表的散文很好。"],"1LtA5r": ["把技能符號連結到 ", ["path"]],"1MGRQl": ["終端機工作階段"],"1NgrlY": ["其他安裝方式"],@@ -138,6 +140,7 @@"1V17kO": ["正在載入兩個版本"],"1VpfKR": ["為這個專案建立一個技能。"],"1XSMhZ": ["在用<1> git rm --cached</1> 取消追蹤之前,切換到<0>僅本機</0>會被拒絕。"],+ "1ZXkqM": ["隨時在“設定”中將其關閉。"],"1ZpfyB": ["用 AI ", ["displayName"], " 開啟,", ["hint"]],"1a6ICf": ["正在跟著代理的編輯走"],"1bDVu5": ["工作區指令面板"],@@ -266,6 +269,8 @@"3o3tur": ["起始內容"],"3oh0nQ": [["path"], " 中巢狀的 .okignore 有錯誤"],"3pU8e-": ["釘選分頁"],+ "3qDsdf": ["安裝技巧"],+ "3ri_4O": ["讓您的知識庫與 Open Knowledge Format 保持一致。"],"3s-k7L": [["0", "plural", { "other": ["再顯示 ", "#", " 個工具"] }]],"3uSzeS": ["圖片可以來自任何地方 · 非圖片檔案必須位於工作區中"],"3v62tp": ["skills.sh 上的熱門項目"],@@ -397,6 +402,7 @@"5ss1kT": ["你在這台電腦上產生的報告。可以重新傳送、顯示檔案,或刪除不再需要的報告。"],"5tcmwY": ["新增值"],"5vAI6Z": ["它不符合我的工作流程"],+ "5w38tn": ["索引維護停止,因為 Open Knowledge 無法到達專案伺服器。當項目重新連接時重試。"],"5wV2qQ": ["以及更多"],"5y_9lO": ["正在等待授權"],"6-wLTJ": ["比 origin 落後 ", ["behind"], " 個"],@@ -516,6 +522,7 @@"7d1a0d": ["公開"],"7dZnmw": ["相關度"],"7hctf2": ["描述你想建立的專案"],+ "7idx48": ["OKF 代理程式技能已安裝"],"7jIIFX": ["全都設定好了!"],"7kb4LU": ["已核准"],"7l15X4": ["失敗"],@@ -523,6 +530,7 @@"7m3Ade": ["安裝次數:"],"7qRHf0": ["為 Claude Chat 和 Cowork 安裝"],"7uBlRT": ["複製檔案樹中目前聚焦的項目,這樣「貼上」就能做出一份副本。"],+ "7wogIQ": [["0", "plural", { "other": ["外掛程式"] }]],"80c4-P": ["程式碼已複製到剪貼簿"],"81H_23": ["新增屬性"],"851WA-": ["這可以在「設定 > AI 工具與 CLI」中設定"],@@ -567,6 +575,7 @@"8nWu1k": ["空白圖表"],"8oWgty": ["勾選全部註解以傳送"],"8qgfac": ["MCP 伺服器"],+ "8rZ1pk": ["啟用 ", ["id"]],"8ruqQi": ["失效的內部連結"],"8sMErm": ["要啟用「跟隨」嗎?"],"8t9CRE": ["正在啟動 ", ["agentName"], "…"],@@ -717,6 +726,9 @@"BQKHuL": ["重新啟動終端機"],"BQu9Pg": ["符號連結"],"BUyQnq": ["無法重新啟動伺服器。請在這個資料夾中試試 `ok start`。"],+ "BVkqD9": [+ "索引維護已暫停,因為另一個 Git 屬性控制 index.md。更新 .gitattributes 以便作用域 index.md 路徑使用 merge=union,然後重試。"+ ],"BY-g4_": ["新增模式"],"Ba4D2x": ["範本已匯入"],"Bdha5y": ["正在發布…"],@@ -733,6 +745,7 @@"Bv5a9_": ["選取範圍統計"],"Bx4EXG": [["label"], " 的動作"],"By-7Pn": ["切換項目符號清單。"],+ "ByIOcK": ["索引檔案保留在原處。 Open Knowledge 僅刪除它所新增的 Git 規則。"],"BymzO4": ["文件大綱"],"C-mmmK": ["你的端點提供的模型 id。它的向量維度會自動偵測——把欄位清空就會恢復成 ",@@ -772,6 +785,9 @@"無論如何 <0>~/.ok/bin</0> 和 <1>~/.ok/env.sh</1> 都會保留——應用程式一律會維護它們。"],"CXTwen": ["無法安全地編輯這個專案的設定"],+ "CXcveY": [+ "Open Knowledge 在包含 Markdown 的每個資料夾中維護一個名為 index.md 的導航文件,每個資料夾按類型列出該資料夾的文件並連結到其子資料夾。當您的文件發生更改時,它會重寫這些文件,並且您自己編輯到其中的任何內容都會被替換。"+ ],"CXj9C-": ["新屬性名稱"],"C_Lyvh": ["儲存主題設定失敗"],"C_WGy8": [@@ -795,6 +811,9 @@"Cu6GXQ": ["來源資料夾本身不會移動。"],"CvsD6Y": ["透過 ", ["viaTags"]],"CwOXMT": [["keyName"], " 的值"],+ "CxCOFx": [+ "在 Git 專案中,Open Knowledge 會在儲存庫根目錄的 .gitattributes 檔案中新增一條限定範圍的規則,以便合併並行的索引變更。"+ ],"CxVk-w": ["對 ", ["address"], " 加上註解"],"D-NlUC": ["跟隨系統"],"D-Oh1s": ["如何設定 ", ["0"], "(在瀏覽器中開啟)"],@@ -853,6 +872,9 @@"DhT_PK": ["OpenKnowledge 匯入了一個技能"],"DiFKSL": ["正在統計 markdown 檔案"],"DiZ3pq": ["圖示選擇器"],+ "DjNcDy": [+ "使用 title、description、resource 和 tags 時的形狀。不需要;聲明一個僅固定其類型,因此標記為以逗號分隔的字串形式編寫的 tags 。"+ ],"DmkTrb": ["無法建立這個主題。請再試一次。"],"Dnn2XG": ["自動"],"DpjYd6": ["跳到錨定的文字"],@@ -1038,6 +1060,9 @@"GNkUvW": ["已排隊——本次執行結束後傳送"],"GQ3O42": ["垃圾桶"],"GQDSBN": ["版面配置選項"],+ "GROUfG": [+ "任何 .mdx 文件。此格式僅限 .md,因此掃描 .md 的閱讀器永遠不會開啟它 - 如果存在同名的 .md,則會讀取該檔案。"+ ],"GSYWCm": ["隱藏文件面板"],"GUYwCr": ["關閉這則提示"],"GUZHkL": ["缺少色盤色彩"],@@ -1173,6 +1198,7 @@"IxHMdF": ["無法刪除那則註解。"],"IxyZXD": ["螢幕擷圖"],"Izh19j": ["從 ", ["tail"], " 讀取"],+ "J0uRhj": ["檢查技能"],"J1XRO3": ["主題色彩"],"J2Mv98": ["名稱(例如 ", ["login"], ")"],"J2_JuX": ["無(", ["0"], " 無法比對到任何文件)"],@@ -1191,6 +1217,7 @@"JHf6qZ": ["[email protected]"],"JJcBCm": ["共 ", ["0"], " 個"],"JK-Ave": ["隱藏縮圖"],+ "JKXcOi": ["已經在專案中"],"JL3si7": ["正在更新"],"JLUTgi": ["還沒有標籤——在任何文件中寫下 `#tagname` 就能填入索引。"],"JLzQi_": ["關閉 ", ["accessibleLabel"]],@@ -1278,6 +1305,9 @@"L-rMC9": ["重設為預設值"],"L1BQTH": [["0"], " 尚未安裝——正在開啟它的下載頁面。"],"L1ZE3M": ["文件統計"],+ "L3BcJ4": [+ "這個需要查看您的文件,而不僅僅是打開的文檔,因此它會在您執行專案審核時出現,而不是在您鍵入時出現。"+ ],"L3CEC1": ["這個項目"],"L3w0_C": ["在獨立視窗中將文件展示為簡報。在文件的 frontmatter 中加入 <0>slides: true</0>,再透過 Slidev 動作開啟。算繪由 Slidev CLI 處理,OpenKnowledge 並未內建。"@@ -1693,6 +1723,12 @@"R6ABfU": ["直接工作,不先制定計畫"],"R9IDFz": ["會重新命名磁碟上的資料夾,以及代理呼叫它時使用的 id。"],"R9dK63": ["範例圖片"],+ "RB_g_C": [+ "在根索引上,okf_version 被寫為引號的字串,如 \"0.2\"。不加引號,YAML 將其讀為數字,0.10 默默地變成 0.1。"+ ],+ "RD6H9q": [+ "當文件變更時,Open Knowledge 會重寫這些 index.md 文件,因此對它們的手動編輯將會被取代。"+ ],"RDjuBN": ["設定"],"RDrXh4": ["設定使用者、專案和整合相關的選項。"],"RG3yW6": ["輸入這個主題的名稱。"],@@ -1760,6 +1796,9 @@"SF9qpO": ["留下你的電子郵件以便我們跟進"],"SFEWV6": ["無法載入 OpenKnowledge 技能。請再試一次。"],"SFN6dN": ["標題 3"],+ "SIPelo": [+ "索引維護已暫停,因為 Open Knowledge 無法確認所需的 Git 合併規則。檢查 Git 和 .gitattributes,然後再試一次。"+ ],"SInSnF": ["參考 <0>", ["0"], "</0>"],"SItQRc": ["你覺得 OpenKnowledge 如何?"],"SOPwPh": ["還原到這次編輯"],@@ -2048,6 +2087,7 @@"X7u0xR": ["有 ", ["0"], " 個範本可用"],"X8kjQX": ["重新用 GitHub 驗證"],"X9VpsP": ["正在載入資料夾內容"],+ "XAnapw": ["Git 合併規則"],"XAyxsa": ["簽出遠端分支"],"XBBZnv": ["連結目標「", ["shown"], "」未指向現有文件。"],"XBgr2S": ["複製進來"],@@ -2154,6 +2194,9 @@"Y_iImT": ["無法解析檔案 ", ["identity"], "。前往引用位置。"],"Y_kL7X": ["自訂編輯器的外觀和行為。"],"Ya3PlJ": ["需要授權"],+ "YaVU2F": [+ "在 Git 專案中,Open Knowledge 也新增了一個作用域 .gitattributes 規則,以便在下一次重建之前合併並發索引變更。"+ ],"YaeyFh": ["拉取可能會覆蓋你本機檔案中尚未提交的編輯。"],"Yb82LN": ["ID:", ["0"]],"Yea-K5": ["還原到這個時間點"],@@ -2261,6 +2304,7 @@"_Bix3-": [["localizedFirstMessage"], " 的出現位置"],"_DwR-n": ["正在建立…"],"_FLBbi": [["sizeText"], " · 已遮蔽機密資訊 · 當機傾印未遮蔽"],+ "_G7A92": ["維護index.md"],"_GRWOJ": ["要更換嵌入服務供應商嗎?"],"_HgF9q": ["排序方式"],"_IGfXZ": ["OpenKnowledge 上次非預期地結束了。"],@@ -2339,10 +2383,12 @@"無法連接到代理服務。請確認 OpenKnowledge 伺服器正在執行而且是最新版本(如果它已經在執行,請重新啟動),然後再試一次。"],"aalx4E": ["正在編輯壞掉的 MDX 原始碼:", ["reason"]],+ "aatPoi": ["產生的文件"],"abiHje": ["刪除選取的項目"],"adsMWO": ["正在解析差異"],"ah_ekO": ["「", ["name"], "」已是最新"],"aiArms": ["我們無法複製這個儲存庫。"],+ "aiOceC": ["啟用索引"],"ajHi4O": ["自動同步已暫停——你沒有推送到這個儲存庫的權限。切換到「跟隨」以繼續接收更新。"],"ajz9F8": ["無法載入 ", ["filePath"], " 的衝突內容。請試著重新載入頁面。"],"ak4LLg": ["清除選單"],@@ -2458,11 +2504,13 @@],"cb-0G0": ["清除顏色"],"ccNps_": ["只顯示已修改的"],+ "cd3THN": ["文件結構"],"cd5EXh": ["回報問題"],"cdm00A": ["沒有連入"],"cdmk8A": ["尚未提交的變更"],"cgl-gn": ["已連接到 GitHub"],"chL5IG": ["社群"],+ "ciozf1": ["專案中已有的技能"],"cjtjry": ["在 OpenKnowledge 的導覽記錄中往回走。"],"cklVjM": ["時間軸"],"clJ3qM": ["完成。"],@@ -2627,6 +2675,7 @@"fbdLmk": ["切換粗體格式。"],"fbsiBw": ["啟動終端機時出了點問題。"],"fcgvCA": ["Claude"],+ "fdKQAE": ["將其關閉"],"fdeFfN": ["(二進位檔案,無法預覽)"],"fevEu0": ["拉取最新的變更"],"ffH3Rt": ["新增註解(Enter)"],@@ -2689,12 +2738,16 @@"gUx34c": ["OpenKnowledge 使用的語言;「跟隨系統」會跟隨你的作業系統。你自己的筆記會保持你書寫時的語言。"],+ "gVMkEr": [+ "在日誌文件中:條目標題以 ISO YYYY-MM-DD 日期開頭,最新的在前。您使用多少個 title,以及條目是否為項目符號,都取決於您。"+ ],"gY7wnY": ["正在登入 ", ["agentName"], "…"],"gYz2ep": [["timeLabel"], "後到期"],"gZElfU": ["正在修正第 ", ["0"], "/", ["1"], " 個檔案"],"gZiT5e": ["要把這些符號連結換成獨立的副本嗎?"],"gayL_Q": ["發行計畫"],"gbHcbI": ["刪除屬性失敗"],+ "gfYI3o": ["停用 ", ["id"]],"gfb-CM": ["無法取得分支——請登入 GitHub 後再試一次。"],"gfdqcY": ["無法套用這項變更:", ["0"]],"gfohmY": ["連接工具"],@@ -2747,6 +2800,9 @@"hLKfZe": ["改用權杖"],"hLod4_": ["轉換成範本"],"hLy8b1": ["已更新到版本 ", ["version"]],+ "hPQBsa": [+ "保留檔案以小寫形式命名為 index.md 和 log.md。在區分大小寫的檔案系統上,Index.md 被當作普通文件讀取並失去其意義。"+ ],"hQXiDc": ["搜尋分支…"],"hQjvzi": ["一個 .zip 或 .skill 封存檔。"],"hS0wC4": ["OpenKnowledge 還原了 ", ["subject"], " 的較早版本"],@@ -2870,6 +2926,7 @@"iy64Li": ["完全同步——你的編輯會自動提交並推送到你的遠端。"],"iycx_A": ["正在推送"],"iz1LdD": ["自從它上次寫入這裡之後,在 OK 之外被改動過——顯示的是磁碟上現在的狀態"],+ "j-o6Z2": ["由於無法保存項目設置,索引維護已停止。檢查專案檔案權限,然後重試。"],"j15ZSH": ["把註解傳送到"],"j2229h": ["正在移除 OpenKnowledge 的檔案…"],"j2kt1j": [@@ -2951,6 +3008,7 @@"k4CuuV": ["現成的資料夾和範本,幫你快速上手。選一個套件可以先看會建立哪些東西,再把它加到你的專案。"],+ "k5rKNs": ["frontmatter"],"k7Hoig": ["這個版本沒有內容變更。"],"k8xtrB": ["像 <0>",@@ -2988,7 +3046,9 @@"kSiB3X": ["無法移到", ["trashNoun"]],"kUn-CN": ["同步已關閉"],"kV2YZv": ["沒看到<0>技能</0>嗎?請先啟用<1>設定 <2/> 功能 <3/> 程式碼執行與檔案建立</1>。"],+ "kVS5tE": ["在每個資料夾中維護 generated 索引?"],"kVgQUA": ["刪除此對話?"],+ "kVzuTI": ["推薦代理技能"],"kYL1lH": ["代理活動"],"k_Dqw1": [["0", "plural", { "other": ["#", " 份文件都沒有問題。"] }]],"k_pade": ["設定現在已分享。提交這些 OK 檔案就能分享給你的團隊。"],@@ -3071,7 +3131,9 @@"lWNpNB": ["透過 CodeMirror 新增游標或選取相符的項目。"],"lXKZGw": ["標題 1"],"lY27jj": [["0"], " 年前"],+ "lY7Unt": ["啟用索引生成"],"lZAiSP": ["反向連結的回應結構與預期不符。"],+ "lZoQdy": ["開放技能"],"lZvQrY": ["把 ", ["0"], " 用作深色主題"],"l_6JHD": ["搜尋圖示..."],"l_FAT6": ["只能用字母、數字、<0>-</0> 或 <1>_</1>。"],@@ -3089,6 +3151,7 @@"ljHjfg": ["那個分支已經在另一個 worktree 中開啟了。"],"lkYioO": ["顯示或隱藏文件面板"],"ll2yNl": ["內容目錄"],+ "llXHHh": [["pluginCount", "plural", { "other": ["外掛程式"] }]],"lmBPt0": ["只有外部連結才會發出要求。連到這個專案其他文件的連結是從本機索引產生預覽,絕不會離開你的電腦。"],@@ -3141,6 +3204,9 @@{ "other": ["把這 ", "#", " 個問題交給你的 AI 代理,包括沒有自動修正方式的部分。"] }]],+ "mhnCt3": [+ "每個概念文檔都帶有一個非空類型。這是 OKF 的一致性底線的全部 - 只有類型的文檔是完全一致的。"+ ],"mk2poV": ["例如 server.ts"],"mlvM8g": ["無法重新定位那則註解。"],"mmpzAq": ["在 markdown 原始碼編輯器中把過長的行自動換行。"],@@ -3372,6 +3438,9 @@"qRZh7J": ["讓 Tab 鍵離開原始碼編輯器,而不是縮排。"],"qSKu2v": ["原始碼導覽與選取"],"qSxaOz": ["接受對方的刪除"],+ "qTT48-": [+ "像 [[Page]] 這樣的 Wiki 連結 — 一種受支援的連結方式,但外部閱讀器無法解析任何內容並顯示括號。"+ ],"qTcVwj": ["為這個專案瀏覽或上傳技能。"],"qTcZZu": ["載入標籤失敗。按 <0>Esc</0> 後重新開啟可再試一次。"],"qX-ABr": ["或者改用瀏覽器登入:"],@@ -3405,6 +3474,7 @@"r51jLC": ["檔案已儲存,Claude Desktop App 已開啟"],"r6ncaO": ["關閉分頁"],"r6y-jM": ["警告"],+ "r7IaYp": ["Open Knowledge Format 指導"],"r871ed": ["你的知識庫現在已經在 GitHub 上,位置是 <0>",["ownerLogin"],@@ -3432,6 +3502,7 @@"rZVMkf": ["視覺化編輯器取代輸入框已聚焦"],"radOpL": ["圖片 ", ["identity"], "。前往引用位置。"],"rageVb": ["帶即時預覽窗格的自訂 HTML(沙箱 iframe)。"],+ "rarziH": ["幫助編碼代理選擇 OKF 文件類型、保留來源並避免發明不支援的元資料。"],"rbrHTd": ["已核准 — ", ["optionName"]],"rcJmK8": ["把這些位置改成副本"],"rdU729": ["版面配置"],@@ -3478,6 +3549,7 @@"sER-bs": ["檔案"],"sFhaTJ": ["用來在選單中區分名稱相近的範本。"],"sGZLfB": ["取得儲存庫清單失敗"],+ "sHDllh": ["停止維護 index.md"],"sICrVf": ["已還原到 ", ["0"], " 的版本"],"sIGbBZ": ["把選取內容轉換成註腳"],"sIxSSP": ["在你的終端機中解決衝突"],@@ -3491,6 +3563,7 @@"sOxZaS": ["載入關係圖失敗"],"sQoLn0": ["結束"],"sR0I-f": ["摺疊全部檔案"],+ "sSRndh": ["開始維護 index.md"],"sW5OjU": ["必填"],"sZ2IOu": ["這個",@@ -3505,6 +3578,9 @@"saIASg": ["第二項"],"saYiIO": ["路徑不能包含空位元組"],"scu3wk": ["模型"],+ "scyoP9": [+ "索引文件不包含 frontmatter,除了知識庫根目錄中的 frontmatter 。日誌文件不被覆蓋-OKF不限制它們的frontmatter。"+ ],"se-tU0": ["無法修復 ", ["total"], " 個檔案中的 ", ["0"], " 個。"],"seeS6l": ["要在這個資料夾中設定 OpenKnowledge 嗎?"],"sgmRY8": ["已略過下載 ", ["0"], "。"],@@ -3551,6 +3627,9 @@"tHKQ6j": ["正在重新命名"],"tKlWWY": ["表情符號"],"tLX6LY": ["OpenKnowledge 寫入了一個文件"],+ "tM5uzl": [+ "來源、信任與生命週期系列:sources、generated、verified、status 和 stale_after。每個欄位都是可選的,缺席絕不是一個錯誤。"+ ],"tN5WTS": ["供應商拒絕了這個要求。請檢查 API 金鑰和模型 id。"],"tP5DDk": ["套用連結"],"tUvUfp": ["用你已經有的資料夾。"],@@ -3600,6 +3679,7 @@"uGaIIS": ["簽出 worktree"],"uH_S-u": [["loadErrorTitle"], ":", ["message"]],"uJfwF8": ["已經安裝了——沒有可匯入的新內容。"],+ "uK2peg": ["根據 Open Knowledge Format 檢查您的項目。隨時在“設定”中將其關閉。"],"uKRYiW": ["無法取得同步狀態——伺服器錯誤。"],"uL_Wx8": ["終端機非預期地停止了。"],"uM6jnS": ["還原失敗"],@@ -3637,6 +3717,9 @@"uyOQ4e": ["主題已複製為 base16 YAML"],"uynXup": [["tokens", "plural", { "other": ["token"] }]],"v-h2hx": ["刪除 ", ["targetGitPath"]],+ "v15iQB": [+ "經證明的計算合約。僅適用於類型為 Attested Computation 的文檔,其中 OKF 需要 runtime;普通概念不受影響。"+ ],"v2ZW0K": ["啟用終端機"],"v2a04T": ["markdownlint 規則"],"v41fCm": ["找不到檔案"],diff --git a/packages/app/src/locales/zh-Hant/messages.po b/packages/app/src/locales/zh-Hant/messages.poindex ed6778f08..33e07618c 100644--- a/packages/app/src/locales/zh-Hant/messages.po+++ b/packages/app/src/locales/zh-Hant/messages.po@@ -263,6 +263,11 @@ msgstr "{0, plural, other {目前符合 {4} 個文件中的 {3} 個。}}"msgid "{0, plural, one {No problems across # document.} other {No problems across # documents.}}"msgstr "{0, plural, other {# 份文件都沒有問題。}}"+#. placeholder {0}: pluginRows.length+#: src/components/CreatedItemsList.tsx+msgid "{0, plural, one {Plugin} other {Plugins}}"+msgstr "{0, plural, other {外掛程式}}"+#. placeholder {0}: editorList.hiddenCount#: src/components/McpConsentDialogBody.tsxmsgid "{0, plural, one {Show # more tool} other {Show # more tools}}"@@ -629,7 +634,9 @@ msgstr "{displayName} CLI,{hint}"msgid "{docName} is {0}. OpenKnowledge currently opens files up to {1}."msgstr "{docName} 有 {0}。OpenKnowledge 目前最多可開啟 {1} 的檔案。"+#. placeholder {0}: OKF_RULE_IDS.length#. placeholder {0}: entries.length+#: src/components/settings/LintingSection.tsx#: src/components/settings/markdownlint-rule-browser.tsxmsgid "{enabledCount}/{0} on"msgstr "已開啟 {enabledCount}/{0}"@@ -792,6 +799,10 @@ msgstr "已使用 {percent}%(剩餘 {left}%)"msgid "{phase} — {pct}%"msgstr "{phase} — {pct}%"+#: src/components/CreatedItemsList.tsx+msgid "{pluginCount, plural, one {plugin} other {plugins}}"+msgstr "{pluginCount, plural, other {外掛程式}}"+#: src/components/PropertyDisclosure.tsxmsgid "{problemCount, plural, one {# property does not match the schema} other {# properties do not match the schema}}"msgstr "{problemCount, plural, other {# 個屬性不符合結構描述}}"@@ -1547,6 +1558,10 @@ msgstr "已由選取的上層資料夾涵蓋"msgid "Already have a git repository? Add it with <0>git remote add origin <url></0> in this project's folder. This page updates automatically once a remote is detected."msgstr "已經有 git 儲存庫了?在這個專案的資料夾中用 <0>git remote add origin <url></0> 加上它。偵測到遠端後,這個頁面會自動更新。"+#: src/components/settings/LintingSection.tsx+msgid "Already in project"+msgstr "已經在專案中"+#: src/components/SkillPluginBundleDialog.tsxmsgid "Already installed — nothing new to import."msgstr "已經安裝了——沒有可匯入的新內容。"@@ -1592,6 +1607,10 @@ msgstr "另一個同步作業正在進行中。請稍候再試。"msgid "any"msgstr "任意"+#: src/components/settings/LintingSection.tsx+msgid "Any .mdx file. The format is .md-only, so a reader scanning for .md never opens it — and if a .md of the same name exists, reads that one instead."+msgstr "任何 .mdx 文件。此格式僅限 .md,因此掃描 .md 的閱讀器永遠不會開啟它 - 如果存在同名的 .md,則會讀取該檔案。"+#. placeholder {0}: summary.name#: src/components/settings/LintingSection.tsxmsgid "any doc named {0}"@@ -2152,6 +2171,7 @@ msgstr "無法分享這個路徑。"#: src/components/ReportBugDialogBody.tsx#: src/components/SeedDialog.tsx#: src/components/settings/LinkPreviewsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/SavedThemesTiles.tsx#: src/components/settings/SearchSection.tsx#: src/components/ShareBranchSwitchDialog.tsx@@ -2292,6 +2312,10 @@ msgstr "正在簽出檔案"msgid "Checking sign-in status"msgstr "正在檢查登入狀態"+#: src/components/settings/LintingSection.tsx+msgid "Checking skill"+msgstr "檢查技能"+#: src/components/ImportSkillForm.tsxmsgid "Checking source"msgstr "正在檢查來源"@@ -2308,6 +2332,10 @@ msgstr "正在檢查…"msgid "Checklist with checkboxes."msgstr "帶核取方塊的清單。"+#: src/components/CreatedItemsList.tsx+msgid "Checks your project against the Open Knowledge Format. Turn it off any time in Settings."+msgstr "根據 Open Knowledge Format 檢查您的項目。隨時在“設定”中將其關閉。"+#: src/components/ImportSkillForm.tsxmsgid "Choose a skill archive"msgstr "選擇技能封存檔"@@ -4304,6 +4332,10 @@ msgstr "停用 {0}"msgid "Disable {file}"msgstr "停用 {file}"+#: src/components/settings/LintingSection.tsx+msgid "Disable {id}"+msgstr "停用 {id}"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "Disable external link previews"msgstr "關閉外部連結預覽"@@ -4406,6 +4438,10 @@ msgstr "文件面板"msgid "Document statistics"msgstr "文件統計"+#: src/components/settings/LintingSection.tsx+msgid "Document structure"+msgstr "文件結構"+#: src/components/empty-state/use-create-suggestions.tsmsgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."msgstr "記錄這個儲存庫的架構:建立一頁總覽,連到每個主要模組的頁面,說明各自的職責和進入點。"@@ -4797,6 +4833,10 @@ msgstr "啟用 {displayName} CLI"msgid "Enable {file}"msgstr "啟用 {file}"+#: src/components/settings/LintingSection.tsx+msgid "Enable {id}"+msgstr "啟用 {id}"+#: src/components/AutoSyncOnboardingDialog.tsx#: src/components/EnableSyncConfirmDialog.tsx#: src/components/share-receive-miss-content.tsx@@ -4821,6 +4861,10 @@ msgstr "要啟用「跟隨」嗎?"msgid "Enable git auto-sync?"msgstr "要啟用 git 自動同步嗎?"+#: src/components/settings/LintingSection.tsx+msgid "Enable indexes"+msgstr "啟用索引"+#: src/components/ProblemsPanel.tsxmsgid "Enable plugins"msgstr "啟用外掛"@@ -4849,6 +4893,10 @@ msgstr "為這個專案啟用終端機"msgid "Enable Themes"msgstr "啟用主題"+#: src/components/settings/LintingSection.tsx+msgid "Enabling index generation"+msgstr "啟用索引生成"+#: src/components/ActivityModeContent.tsxmsgid "Ended"msgstr "已結束"@@ -4919,6 +4967,10 @@ msgstr "錯誤:"msgid "Escape"msgstr "Esc"+#: src/components/settings/LintingSection.tsx+msgid "Every concept document carries a non-empty type. This is the whole of OKF's conformance floor — a document with only a type is fully conformant."+msgstr "每個概念文檔都帶有一個非空類型。這是 OKF 的一致性底線的全部 - 只有類型的文檔是完全一致的。"+#: src/components/settings/LintingSection.tsxmsgid "every doc"msgstr "所有文件"@@ -5694,6 +5746,10 @@ msgstr "來自範本"msgid "From the {0} plugin"msgstr "來自 {0} 外掛"+#: src/components/settings/LintingSection.tsx+msgid "Frontmatter"+msgstr "frontmatter"+#: src/components/TemplateForm.tsxmsgid "Frontmatter every document created from this template starts with. Values are YAML — a list is <0>[a, b]</0>; <1>{{date}}</1> fills in on create."msgstr "用這個範本建立的每份文件都會以這段 frontmatter 開頭。值使用 YAML——清單寫成 <0>[a, b]</0>;<1>{{date}}</1> 會在建立時填入。"@@ -5736,6 +5792,10 @@ msgstr "遊戲結束 · 按空白鍵再玩一次"msgid "General"msgstr "一般"+#: src/components/settings/LintingSection.tsx+msgid "Generated files"+msgstr "產生的文件"+#: src/components/TerminalCliMissingBanner.tsxmsgid "Get {displayName}"msgstr "取得 {displayName}"@@ -5769,6 +5829,10 @@ msgstr "無法使用 git 設定"msgid "Git identity isn't set — commits use a default author. Set yours so teammates see your name."msgstr "還沒設定 git 身分——提交會用預設作者。設定你自己的身分,隊友才看得到你的名字。"+#: src/components/settings/LintingSection.tsx+msgid "Git merge rule"+msgstr "Git 合併規則"+#: src/components/ShareBranchSwitchDialog.tsxmsgid "Git needs {tool} for this repository, but it isn't installed or couldn't be found. Install it, then try again."msgstr "Git 在這個儲存庫需要 {tool},但它沒有安裝或找不到。請先安裝再試一次。"@@ -5923,7 +5987,7 @@ msgstr "heading-slug"msgid "Headings"msgstr "標題"-#: src/components/AutoSyncEnableWarning.tsx+#: src/components/DisclosureWarning.tsx#: src/editor/slash-command/component-items.tsxmsgid "Heads up"msgstr "提醒"@@ -5945,6 +6009,10 @@ msgstr "你好,世界!"msgid "Help"msgstr "說明"+#: src/components/settings/LintingSection.tsx+msgid "Helps coding agents choose OKF document types, preserve provenance, and avoid inventing unsupported metadata."+msgstr "幫助編碼代理選擇 OKF 文件類型、保留來源並避免發明不支援的元資料。"+#. Subtext for the open-knowledge-discovery skill row#. Subtext for the open-knowledge-discovery skill row#: src/components/McpConsentDialogBody.tsx@@ -6277,10 +6345,18 @@ msgstr "已用「{0}」這個名稱匯入——名稱「{1}」已被占用。"msgid "Importing"msgstr "正在匯入"+#: src/components/settings/LintingSection.tsx+msgid "In a log document: entry headings lead with an ISO YYYY-MM-DD date, newest first. How many titles you use, and whether entries are bullets, is up to you."+msgstr "在日誌文件中:條目標題以 ISO YYYY-MM-DD 日期開頭,最新的在前。您使用多少個 title,以及條目是否為項目符號,都取決於您。"+#: src/components/SeedDialog.tsxmsgid "In a subfolder"msgstr "在子資料夾中"+#: src/components/settings/LintingSection.tsx+msgid "In an index document: entries sit under a section heading and each one carries a link. Prose around the lists is fine."+msgstr "在索引文件中:條目位於節標題下,每個條目都帶有連結。圍繞列表的散文很好。"+#: src/components/empty-state/CreatePromptComposer.tsx#: src/components/handoff/AgentSplitButton.tsx#: src/components/handoff/OpenInAgentContextSubmenu.tsx@@ -6299,6 +6375,14 @@ msgstr "在應用程式內"msgid "In app (beta)"msgstr "在應用程式內(beta)"+#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge adds a scoped rule to the repository-root .gitattributes file so concurrent index changes combine."+msgstr "在 Git 專案中,Open Knowledge 會在儲存庫根目錄的 .gitattributes 檔案中新增一條限定範圍的規則,以便合併並行的索引變更。"++#: src/components/settings/LintingSection.tsx+msgid "In Git projects, Open Knowledge also adds a scoped .gitattributes rule so concurrent index changes combine before the next rebuild."+msgstr "在 Git 專案中,Open Knowledge 也新增了一個作用域 .gitattributes 規則,以便在下一次重建之前合併並發索引變更。"+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "In the Claude Desktop App"msgstr "在 Claude Desktop App 中"@@ -6323,6 +6407,26 @@ msgstr "增加或減少目前清單項目的縮排。"msgid "Indented blockquote for citations."msgstr "用來引用的縮排引言區塊。"+#: src/components/settings/LintingSection.tsx+msgid "Index documents carry no frontmatter, except the one at your knowledge base's root. Log documents are not covered — OKF does not constrain their frontmatter."+msgstr "索引文件不包含 frontmatter,除了知識庫根目錄中的 frontmatter 。日誌文件不被覆蓋-OKF不限制它們的frontmatter。"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."+msgstr "索引維護已暫停,因為另一個 Git 屬性控制 index.md。更新 .gitattributes 以便作用域 index.md 路徑使用 merge=union,然後重試。"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance is paused because Open Knowledge could not confirm the required Git merge rule. Check Git and .gitattributes, then try again."+msgstr "索引維護已暫停,因為 Open Knowledge 無法確認所需的 Git 合併規則。檢查 Git 和 .gitattributes,然後再試一次。"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because Open Knowledge could not reach the project server. Try again when the project reconnects."+msgstr "索引維護停止,因為 Open Knowledge 無法到達專案伺服器。當項目重新連接時重試。"++#: src/components/settings/LintingSection.tsx+msgid "Index maintenance stayed off because the project setting could not be saved. Check the project file permissions, then try again."+msgstr "由於無法保存項目設置,索引維護已停止。檢查專案檔案權限,然後重試。"+#: src/components/settings/SearchSection.tsxmsgid "Indexed {embedded} of {total} pages."msgstr "已索引 {total} 個頁面中的 {embedded} 個。"@@ -6511,6 +6615,10 @@ msgstr "安裝到所有代理"msgid "Install selected"msgstr "安裝選取項"+#: src/components/settings/LintingSection.tsx+msgid "Install skill"+msgstr "安裝技巧"+#: src/components/SkillPluginBundleBanner.tsxmsgid "Install skills"msgstr "安裝技能"@@ -6520,6 +6628,7 @@ msgid "Install the gh CLI"msgstr "安裝 gh CLI"#: src/components/settings/AiToolsSection.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ProjectAiToolsSection.tsx#: src/components/SkillEditorActions.tsxmsgid "Installed"@@ -6733,6 +6842,10 @@ msgstr "讓這個專案和你的 git 遠端保持同步。「跟隨」只取得msgid "Keep track of the people and companies you work with and the meetings you have with them. Good for remembering who someone is, how you know them, and what you last talked about."msgstr "記錄你往來的人和公司,以及你們之間的會面。適合用來記住某人是誰、你怎麼認識他們,還有上次聊了什麼。"+#: src/components/settings/LintingSection.tsx+msgid "Keeps your knowledge base aligned with the Open Knowledge Format."+msgstr "讓您的知識庫與 Open Knowledge Format 保持一致。"+#. placeholder {0}: toName.trim()#: src/components/SkillForkDialog.tsxmsgid "Kept both — \"{0}\" is its own skill now"@@ -7108,6 +7221,14 @@ msgstr "正在尋找 <0>{lookingForUrl}</0>。"msgid "Lost connection to \"{docName}\"."msgstr "與「{docName}」的連線已中斷。"+#: src/components/settings/LintingSection.tsx+msgid "Maintain generated indexes in every folder?"+msgstr "在每個資料夾中維護 generated 索引?"++#: src/components/settings/LintingSection.tsx+msgid "Maintain index.md"+msgstr "維護index.md"+#: src/components/SkillInstallMenu.tsxmsgid "make source"msgstr "設為來源"@@ -8252,6 +8373,10 @@ msgstr "OK 桌面版"msgid "OK last set this folder to {0} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins."msgstr "OK 上次把這個資料夾設為 {0}——之後 OK 以外的東西改動過它。顯示的是磁碟上現在的狀態;你下一次的「符號連結/取消連結」會覆蓋它。"+#: src/components/settings/LintingSection.tsx+msgid "OKF agent skill installed"+msgstr "OKF 代理程式技能已安裝"+#: src/components/settings/LinkPreviewsSection.tsxmsgid "On — hovering an external link sends its URL to the destination site to fetch a preview."msgstr "開啟——把游標停在外部連結上時,會把它的 URL 送到目標網站以取得預覽。"@@ -8268,6 +8393,10 @@ msgstr "在 <0>{address}</0> 上"msgid "On selected text in <0>{address}</0>"msgstr "在 <0>{address}</0> 中選取的文字上"+#: src/components/settings/LintingSection.tsx+msgid "On the root index, okf_version is written as a quoted string like \"0.2\". Unquoted, YAML reads it as a number and 0.10 silently becomes 0.1."+msgstr "在根索引上,okf_version 被寫為引號的字串,如 \"0.2\"。不加引號,YAML 將其讀為數字,0.10 默默地變成 0.1。"+#. Next step for a Cursor project MCP row — Cursor leaves project servers disabled#: src/components/settings/ProjectAiToolsSection.tsxmsgid "One more step: enable it in Cursor → Settings → Tools & MCP (Cursor leaves project servers off until you turn them on)."@@ -8490,6 +8619,22 @@ msgstr "在 worktree 中開啟"msgid "Open it there"msgstr "在那裡開啟"+#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge creates and maintains a navigation file named index.md in every folder that contains Markdown."+msgstr "Open Knowledge 在包含 Markdown 的每個資料夾中建立並維護名為 index.md 的導覽檔案。"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge Format guidance"+msgstr "Open Knowledge Format 指導"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge maintains a navigation file named index.md in every folder that contains Markdown, each listing that folder's documents by type and linking to its subfolders. It rewrites these files as your documents change, and anything you edit into them yourself is replaced."+msgstr "Open Knowledge 在包含 Markdown 的每個資料夾中維護一個名為 index.md 的導航文件,每個資料夾按類型列出該資料夾的文件並連結到其子資料夾。當您的文件發生更改時,它會重寫這些文件,並且您自己編輯到其中的任何內容都會被替換。"++#: src/components/settings/LintingSection.tsx+msgid "Open Knowledge rewrites these index.md files as documents change, so manual edits to them are replaced."+msgstr "當文件變更時,Open Knowledge 會重寫這些 index.md 文件,因此對它們的手動編輯將會被取代。"+#. placeholder {0}: item.displayName#. placeholder {1}: item.displayName#. placeholder {2}: item.version@@ -8536,6 +8681,10 @@ msgstr "開啟設定"msgid "Open shared {targetNoun}"msgstr "開啟分享的{targetNoun}"+#: src/components/settings/LintingSection.tsx+msgid "Open skill"+msgstr "開放技能"+#: src/editor/extensions/JsxComponentView.tsxmsgid "Open source doc: {mirrorSrc}"msgstr "開啟來源文件:{mirrorSrc}"@@ -9372,6 +9521,7 @@ msgid "project"msgstr "專案"#: src/components/CommandPalette.tsx+#: src/components/settings/LintingSection.tsx#: src/components/settings/ScopeBadge.tsx#: src/lib/skill-scope.tsmsgid "Project"@@ -9643,6 +9793,10 @@ msgstr "最近的專案"msgid "Recently opened"msgstr "最近開啟"+#: src/components/settings/LintingSection.tsx+msgid "Recommended agent skill"+msgstr "推薦代理技能"+#: src/components/SyncStatusBadge.tsxmsgid "Reconnect required"msgstr "需要重新連接"@@ -10080,6 +10234,10 @@ msgstr "研究不會飛的鳥類的滅絕"msgid "research-note"msgstr "research-note"+#: src/components/settings/LintingSection.tsx+msgid "Reserved files are named index.md and log.md in lowercase. On a case-sensitive filesystem, Index.md is read as an ordinary document and loses its meaning."+msgstr "保留檔案以小寫形式命名為 index.md 和 log.md。在區分大小寫的檔案系統上,Index.md 被當作普通文件讀取並失去其意義。"+#: src/components/settings/CustomThemeEditor.tsxmsgid "Reset"msgstr "重設"@@ -10322,6 +10480,7 @@ msgid "Rule editing is available for the project's root markdownlint config"msgstr "只有專案根目錄的 markdownlint 設定才能編輯規則"#: src/components/LintConfigEditor.tsx+#: src/components/settings/LintingSection.tsxmsgid "Rules"msgstr "規則"@@ -11264,6 +11423,10 @@ msgstr "未為 {conflictHosts} 安裝技能「{conflictName}」——你在那msgid "Skill \"{name}\" created"msgstr "已建立技能「{name}」"+#: src/components/settings/LintingSection.tsx+msgid "Skill already in project"+msgstr "專案中已有的技能"+#: src/components/ExploreSkills.tsxmsgid "Skill discovery powered by <0>skills.sh</0>"msgstr "技能探索由 <0>skills.sh</0> 提供"@@ -11523,6 +11686,10 @@ msgstr "起點"msgid "Start here: what this is and how it's organized."msgstr "從這裡開始:這是什麼,以及它是怎麼安排的。"+#: src/components/settings/LintingSection.tsx+msgid "Start maintaining index.md"+msgstr "開始維護 index.md"+#: src/lib/keyboard-shortcuts.tsmsgid "Start source completion"msgstr "啟動原始碼自動完成"@@ -11618,6 +11785,10 @@ msgstr "停止修正檔案"msgid "Stop fixing. Files already fixed stay fixed."msgstr "停止修正。已經修正好的檔案會維持原狀。"+#: src/components/settings/LintingSection.tsx+msgid "Stop maintaining index.md"+msgstr "停止維護 index.md"+#: src/lib/project-fix-sweep-store.tsmsgid "Stopped fixing. Files already fixed stay fixed."msgstr "已停止修正。已經修正好的檔案會維持原狀。"@@ -12121,6 +12292,10 @@ msgstr "智慧代理沒有停止。強制停止將關閉此對話並結束智慧msgid "The agent's persona, values, and voice."msgstr "代理的人設、價值觀和語氣。"+#: src/components/settings/LintingSection.tsx+msgid "The attested-computation contract. Only applies to documents typed Attested Computation, where OKF requires a runtime; ordinary concepts are unaffected."+msgstr "經證明的計算合約。僅適用於類型為 Attested Computation 的文檔,其中 OKF 需要 runtime;普通概念不受影響。"+#: src/components/ProblemsPanel.tsxmsgid "The audit could not be completed. Try again."msgstr "稽核未能完成。請再試一次。"@@ -12179,6 +12354,10 @@ msgstr "公式 <0>c = √(a² + b²)</0> 會以行內形式顯示。"msgid "the git exclude file isn't writable"msgstr "git 的 exclude 檔案無法寫入"+#: src/components/settings/LintingSection.tsx+msgid "The index files stay in place. Open Knowledge removes only the Git rule it added."+msgstr "索引檔案保留在原處。 Open Knowledge 僅刪除它所新增的 Git 規則。"+#: src/lib/locale-load-failure-notice.tsmsgid "The interface is still in the language you were reading. Check your connection, then reload to try again."msgstr "介面仍是你先前閱讀的語言。請檢查網路連線,然後重新載入再試一次。"@@ -12215,6 +12394,10 @@ msgstr "這份文件最上面的屬性區塊有格式錯誤。請切換到原始msgid "The properties changed, but could not be compared — the YAML did not parse. Both versions are shown as written."msgstr "屬性有變更,但無法比較——YAML 解析失敗。兩個版本均按原樣顯示。"+#: src/components/settings/LintingSection.tsx+msgid "The provenance, trust, and lifecycle families: sources, generated, verified, status, and stale_after. Every field is optional, and absence is never an error."+msgstr "來源、信任與生命週期系列:sources、generated、verified、status 和 stale_after。每個欄位都是可選的,缺席絕不是一個錯誤。"+#: src/components/settings/SearchSection.tsxmsgid "The provider is rate-limiting this key. Try again in a moment."msgstr "供應商正在對這把金鑰限流。請稍候再試。"@@ -12252,6 +12435,10 @@ msgstr "結構描述檔案不存在或載入失敗——新增欄位就會建立msgid "the server responded but server.lock has no port yet"msgstr "伺服器有回應,但 server.lock 裡還沒有連接埠"+#: src/components/settings/LintingSection.tsx+msgid "The shapes of title, description, resource, and tags when you use them. None are required; declaring one only pins its type, so tags written as a comma-separated string is flagged."+msgstr "使用 title、description、resource 和 tags 時的形狀。不需要;聲明一個僅固定其類型,因此標記為以逗號分隔的字串形式編寫的 tags 。"+#: src/components/SkillInstallMenu.tsxmsgid "The skill's own folder — the source other locations copy or link from"msgstr "技能自己的資料夾——其他位置從這裡複製或連結"@@ -12565,6 +12752,10 @@ msgstr "這可能要花一點時間。你的 markdown 內容會保留。"msgid "This moves <0>{name}</0> from {0} to {1}, relocating its files on disk and re-installing it in your editors at the {2} level."msgstr "這會把 <0>{name}</0> 從 {0} 移到 {1},在磁碟上重新安置它的檔案,並在你的編輯器中以 {2} 層級重新安裝它。"+#: src/components/settings/LintingSection.tsx+msgid "This one needs to see your files, not just the open document, so it appears when you run a project audit rather than while you type."+msgstr "這個需要查看您的文件,而不僅僅是打開的文檔,因此它會在您執行專案審核時出現,而不是在您鍵入時出現。"+#: src/components/SeedDialog.tsxmsgid "This pack is already set up here."msgstr "這個套件在這裡已經設定好了。"@@ -12928,6 +13119,10 @@ msgstr "把 {0} 變回一個真正的目錄,裡面為它目前看得到的每msgid "Turn {display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there."msgstr "把 {display} 變回一個真正的目錄,裡面為它目前看得到的每個技能各放一個符號連結——一切照常運作,之後由每個技能自己的選單來管理。"+#: src/components/CreatedItemsList.tsx+msgid "Turn it off any time in Settings."+msgstr "隨時在“設定”中將其關閉。"+#: src/components/NotInSidebarIndicator.tsxmsgid "Turn off Only markdown files"msgstr "關閉「只顯示 markdown 檔案」"@@ -12953,6 +13148,10 @@ msgstr "要開啟語意搜尋嗎?"msgid "Turn the things you read into clear, trusted articles. Save a source, figure out what it means, then keep the final version so you can rely on it later."msgstr "把你讀過的東西變成清楚可信的文章。先存下來源,弄懂它的意思,再留下最終版本,之後就能放心引用。"+#: src/components/settings/LintingSection.tsx+msgid "Turning it off"+msgstr "將其關閉"+#: src/components/acp/working-status.tsmsgid "Turning it over…"msgstr "反覆推敲中…"@@ -13643,6 +13842,10 @@ msgstr "維基連結"msgid "Wiki link suggestions"msgstr "維基連結建議"+#: src/components/settings/LintingSection.tsx+msgid "Wiki-links like [[Page]] — a supported way to link here, but an external reader resolves nothing and shows the brackets."+msgstr "像 [[Page]] 這樣的 Wiki 連結 — 一種受支援的連結方式,但外部閱讀器無法解析任何內容並顯示括號。"+#: src/components/PublishToGitHubDialog.tsxmsgid "Will be created as <0>{sanitizedName}</0>"msgstr "會建立成 <0>{sanitizedName}</0>"diff --git a/packages/app/tests/integration/api-error-envelope/seed-install-pack-skill.test.ts b/packages/app/tests/integration/api-error-envelope/seed-install-pack-skill.test.tsnew file mode 100644index 000000000..5346c884b--- /dev/null+++ b/packages/app/tests/integration/api-error-envelope/seed-install-pack-skill.test.ts@@ -0,0 +1,73 @@+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';+import { join } from 'node:path';+import {+ ProblemDetailsSchema,+ SeedInstallPackSkillSuccessSchema,+} from '@inkeep/open-knowledge-core';+import { afterAll, beforeAll, describe, expect, test } from 'vitest';+import { HARNESS_BOOT_TIMEOUT_MS } from '../harness-boot-timeout';+import { createTestServer, type TestServer } from '../test-harness';++let server: TestServer;++beforeAll(async () => {+ server = await createTestServer();+ const platformSkillDir = join(server.contentDir, '.claude', 'skills', 'open-knowledge');+ mkdirSync(platformSkillDir, { recursive: true });+ writeFileSync(+ join(platformSkillDir, 'SKILL.md'),+ '---\nname: open-knowledge\ndescription: project skill\n---\n',+ 'utf-8',+ );+}, HARNESS_BOOT_TIMEOUT_MS);++afterAll(async () => {+ await server.cleanup();+});++describe('seed-install-pack-skill envelope', () => {+ test('installs only the requested pack skill and returns its creation state', async () => {+ const configPath = join(server.contentDir, '.ok', 'config.yml');+ const configBefore = readFileSync(configPath);+ const res = await fetch(`http://127.0.0.1:${server.port}/api/seed/install-pack-skill`, {+ method: 'POST',+ headers: { 'Content-Type': 'application/json' },+ body: JSON.stringify({ packId: 'okf' }),+ });++ expect(res.status).toBe(200);+ const parsed = SeedInstallPackSkillSuccessSchema.safeParse(await res.json());+ expect(parsed.success).toBe(true);+ if (parsed.success) {+ expect(parsed.data).toEqual({+ installedHosts: ['Claude Code'],+ skills: [{ name: 'okf-knowledge-base', created: true }],+ });+ }+ expect(+ existsSync(join(server.contentDir, '.claude', 'skills', 'okf-knowledge-base', 'SKILL.md')),+ ).toBe(true);+ expect(existsSync(join(server.contentDir, 'index.md'))).toBe(false);+ expect(readFileSync(configPath)).toEqual(configBefore);+ });++ test('rejects an unknown pack id with problem details', async () => {+ const res = await fetch(`http://127.0.0.1:${server.port}/api/seed/install-pack-skill`, {+ method: 'POST',+ headers: { 'Content-Type': 'application/json' },+ body: JSON.stringify({ packId: 'not-a-pack' }),+ });++ expect(res.status).toBe(400);+ const parsed = ProblemDetailsSchema.safeParse(await res.json());+ expect(parsed.success).toBe(true);+ if (parsed.success) expect(parsed.data.type).toBe('urn:ok:error:invalid-request');+ });++ test('method-not-allowed on GET advertises POST', async () => {+ const res = await fetch(`http://127.0.0.1:${server.port}/api/seed/install-pack-skill`);++ expect(res.status).toBe(405);+ expect(res.headers.get('allow')).toBe('POST');+ });+});diff --git a/packages/app/tests/integration/attribution-sweep-coverage.test.ts b/packages/app/tests/integration/attribution-sweep-coverage.test.tsindex d499f488e..03af655c3 100644--- a/packages/app/tests/integration/attribution-sweep-coverage.test.ts+++ b/packages/app/tests/integration/attribution-sweep-coverage.test.ts@@ -180,6 +180,10 @@ const EXEMPT_HANDLERS = new Set(['handleSavedThemesList','handleSavedTheme','handleTemplate',+ // `/api/generated-index/settings` coordinates project config with a scoped+ // `.gitattributes` rule. It authors no document content, so there is no+ // document contributor identity to record.+ 'handleGeneratedIndexSettings',// `/api/lint/config` (GET) + `/api/lint/markdownlint-config` (POST) — the markdown// linter's effective-config read and the native `.markdownlint.*` rule write.// Project-configuration writes (lint rules), not agent-authored document@@ -381,6 +385,9 @@ const EXEMPT_HANDLERS = new Set([// GET (enumerates registered packs from `STARTER_PACKS`); identity-free.'handleSeedPlan','handleSeedApply',+ // Installs the selected pack skill on behalf of the local user through the+ // same fs-direct seed machinery. It does not author agent-attributed content.+ 'handleSeedInstallPackSkill','handleSeedPacks','handleAgentActivity','handleAgentBurstDiff',diff --git a/packages/app/tests/integration/conflict-gate-coverage.test.ts b/packages/app/tests/integration/conflict-gate-coverage.test.tsindex 903e2dc2c..1b09de452 100644--- a/packages/app/tests/integration/conflict-gate-coverage.test.ts+++ b/packages/app/tests/integration/conflict-gate-coverage.test.ts@@ -137,6 +137,10 @@ const EXEMPT_HANDLERS = new Set(['handleTagsForName','handlePages','handleFolderConfig',+ // `/api/generated-index/settings` coordinates project config with a scoped+ // `.gitattributes` rule. It has no content-document target, so a per-doc+ // conflict cannot apply.+ 'handleGeneratedIndexSettings',// `/api/saved-themes` (list) + `/api/saved-theme` (save/delete) — user-global// theme-store operations. They target scheme files under `<home>/.ok/themes`,// not a Y.Doc, so the per-doc conflict-refusal gate does not apply — same@@ -298,6 +302,9 @@ const EXEMPT_HANDLERS = new Set(['handleSkillDuplicate','handleSeedPlan','handleSeedApply',+ // Pack-skill installation authors a new bundle fs-direct or refreshes its+ // editor projection; it does not mutate an existing content Y.Doc body.+ 'handleSeedInstallPackSkill','handleSeedPacks','handleShareConstructUrl','handleSharePublishOwners',diff --git a/packages/app/tests/integration/origin-undoability-sweep.test.ts b/packages/app/tests/integration/origin-undoability-sweep.test.tsindex 6ba7f3288..b630175c2 100644--- a/packages/app/tests/integration/origin-undoability-sweep.test.ts+++ b/packages/app/tests/integration/origin-undoability-sweep.test.ts@@ -65,6 +65,11 @@ const ORIGIN_UNDO_CONTRACT: Record<string, UndoRow> = {why: 'Managed-rename spine (paired). System origin tracked by no UndoManager.',contract: 'attribution-sweep-coverage.test.ts (identity threading)',},+ GENERATED_ARTIFACT_ORIGIN: {+ undo: 'system-not-undoable',+ why: 'Machine-maintained generated documents are reconciled through a paired system write and are tracked by no UndoManager.',+ contract: 'generated-artifact.test.ts, server-factory.test.ts (generated index wiring)',+ },MERMAID_SOURCE_ORIGIN: {undo: 'system-not-undoable',why: 'Mermaid diagram seed/reconcile into Y.Text(source); system origin, markdown bridge gated off.',diff --git a/packages/app/tests/stress/okf-generated-index-settings.e2e.ts b/packages/app/tests/stress/okf-generated-index-settings.e2e.tsnew file mode 100644index 000000000..79d35c492--- /dev/null+++ b/packages/app/tests/stress/okf-generated-index-settings.e2e.ts@@ -0,0 +1,191 @@+/**+ * Browser coverage for the OKF generated-index disclosure and its disk effects.+ *+ * The unique worker option is the isolation boundary: Playwright cannot place+ * this file in a worker whose content directory is shared by ordinary specs.+ * That matters after confirmation because the generator intentionally authors+ * index.md throughout the tree. One test owns the full decline-then-confirm+ * sequence so those generated files cannot leak between tests in this file.+ */++import { execFileSync } from 'node:child_process';+import { existsSync, readFileSync, statSync, writeFileSync } from 'node:fs';+import { join } from 'node:path';+import AxeBuilder from '@axe-core/playwright';+import type { Page } from '@playwright/test';+import { parse } from 'yaml';+import { expect, test } from './_helpers';++test.use({+ workerServerEnv: { OK_TEST_OKF_GENERATED_INDEX_SETTINGS: 'isolated-content-v1' },+});++type OkfProjectConfig = {+ contentRules?: {+ okf?: {+ enabled?: boolean;+ generate?: { index?: boolean };+ };+ };+};++function readProjectConfig(configPath: string): OkfProjectConfig {+ if (!existsSync(configPath)) return {};+ return parse(readFileSync(configPath, 'utf-8')) as OkfProjectConfig;+}++async function openOkfSettings(page: Page): Promise<void> {+ await page.goto('/#settings/plugins-manage');+ await expect(page.getByTestId('settings-plugins-manage')).toBeVisible({ timeout: 30_000 });++ const okfToggle = page.getByTestId('settings-plugin-toggle-okf');+ await expect(okfToggle).toBeVisible();+ if ((await okfToggle.getAttribute('aria-checked')) !== 'true') {+ await okfToggle.click();+ }+ await expect(okfToggle).toHaveAttribute('aria-checked', 'true');++ await page.goto('/#settings/plugin:okf');+ await expect(page.getByTestId('settings-plugin-okf')).toBeVisible({ timeout: 30_000 });+}++async function expectDisclosureContrast(page: Page, theme: 'light' | 'dark'): Promise<void> {+ await page.evaluate((nextTheme) => {+ document.documentElement.removeAttribute('data-color-theme');+ document.getElementById('ok-custom-theme')?.remove();+ document.documentElement.classList.toggle('dark', nextTheme === 'dark');+ }, theme);++ const results = await new AxeBuilder({ page })+ .include('[data-testid="settings-okf-generate-index-confirm"]')+ .withRules(['color-contrast'])+ .analyze();++ expect(results.violations).toEqual([]);+}++test('Escape decline restores focus, confirmation creates indexes, and disabling preserves them', async ({+ page,+ api,+ workerServer,+}) => {+ execFileSync('git', ['init', '-q'], { cwd: workerServer.contentDir });+ await api.seedDocs([+ {+ name: 'home',+ markdown: '---\ntitle: Home\ntype: note\n---\n\n# Home\n',+ },+ {+ name: 'guides/intro',+ markdown: '---\ntitle: Intro\ntype: guide\n---\n\n# Intro\n',+ },+ ]);++ const configPath = join(workerServer.contentDir, '.ok', 'config.yml');+ const rootIndexPath = join(workerServer.contentDir, 'index.md');+ const nestedIndexPath = join(workerServer.contentDir, 'guides', 'index.md');+ const attributesPath = join(workerServer.contentDir, '.gitattributes');++ await openOkfSettings(page);+ await expect.poll(() => readProjectConfig(configPath).contentRules?.okf?.enabled).toBe(true);++ const configBeforeDisclosure = readFileSync(configPath, 'utf-8');+ const generateToggle = page.getByTestId('settings-okf-generate-index');+ await expect(generateToggle).toHaveAttribute('aria-checked', 'false');++ await generateToggle.press('Space');+ const disclosure = page.getByRole('dialog', {+ name: 'Maintain generated indexes in every folder?',+ });+ await expect(disclosure).toBeVisible();+ await expect(disclosure).toContainText('index.md');+ await expect(disclosure).toContainText('every folder');+ await expectDisclosureContrast(page, 'light');+ await expectDisclosureContrast(page, 'dark');+ await page.evaluate(() => {+ document.documentElement.classList.remove('dark');+ });++ expect(readFileSync(configPath, 'utf-8')).toBe(configBeforeDisclosure);+ expect(existsSync(rootIndexPath)).toBe(false);+ expect(existsSync(nestedIndexPath)).toBe(false);++ await expect(disclosure).toContainText('.gitattributes');+ const cancelButton = disclosure.getByRole('button', { name: 'Cancel' });+ const confirmButton = disclosure.getByRole('button', { name: 'Enable indexes' });+ await expect(confirmButton).toHaveCSS('text-transform', 'uppercase');+ const dialogBox = await disclosure.boundingBox();+ expect(dialogBox).not.toBeNull();+ for (const button of [cancelButton, confirmButton]) {+ const buttonBox = await button.boundingBox();+ expect(buttonBox).not.toBeNull();+ expect(buttonBox?.x ?? -1).toBeGreaterThanOrEqual(dialogBox?.x ?? 0);+ expect((buttonBox?.x ?? 0) + (buttonBox?.width ?? 0)).toBeLessThanOrEqual(+ (dialogBox?.x ?? 0) + (dialogBox?.width ?? 0),+ );+ }+ await cancelButton.press('Tab');+ await expect(confirmButton).toBeFocused();+ await confirmButton.press('Escape');+ await expect(disclosure).toBeHidden();+ await expect(generateToggle).toBeFocused();+ await expect(generateToggle).toHaveAttribute('aria-checked', 'false');+ expect(readFileSync(configPath, 'utf-8')).toBe(configBeforeDisclosure);+ expect(existsSync(rootIndexPath)).toBe(false);+ expect(existsSync(nestedIndexPath)).toBe(false);+ expect(existsSync(attributesPath)).toBe(false);++ await generateToggle.click();+ await disclosure.getByRole('button', { name: 'Enable indexes' }).click();+ await expect(generateToggle).toHaveAttribute('aria-checked', 'true');+ await expect+ .poll(() => readProjectConfig(configPath).contentRules?.okf?.generate?.index, {+ timeout: 15_000,+ })+ .toBe(true);+ await expect+ .poll(+ () => ({+ root: existsSync(rootIndexPath),+ nested: existsSync(nestedIndexPath),+ }),+ { timeout: 20_000 },+ )+ .toEqual({ root: true, nested: true });++ expect(readFileSync(rootIndexPath, 'utf-8')).toContain('./guides/index.md');+ expect(readFileSync(nestedIndexPath, 'utf-8')).toContain('./intro.md');+ expect(readFileSync(attributesPath, 'utf-8')).toContain('/**/index.md merge=union');++ const generatedFiles = [rootIndexPath, nestedIndexPath].map((path) => ({+ path,+ bytes: readFileSync(path),+ mtimeMs: statSync(path).mtimeMs,+ }));++ await generateToggle.click();+ await expect(generateToggle).toHaveAttribute('aria-checked', 'false');+ await expect+ .poll(() => readProjectConfig(configPath).contentRules?.okf?.generate?.index, {+ timeout: 15_000,+ })+ .toBe(false);++ for (const snapshot of generatedFiles) {+ expect(existsSync(snapshot.path)).toBe(true);+ expect(readFileSync(snapshot.path)).toEqual(snapshot.bytes);+ expect(statSync(snapshot.path).mtimeMs).toBe(snapshot.mtimeMs);+ }++ expect(existsSync(attributesPath)).toBe(false);++ writeFileSync(attributesPath, 'index.md merge=ours\n', 'utf-8');+ await generateToggle.click();+ await disclosure.getByRole('button', { name: 'Enable indexes' }).click();+ await expect(generateToggle).toHaveAttribute('aria-checked', 'false');+ await expect(page.getByTestId('settings-okf-generate-index-status')).toContainText(+ 'another Git attribute controls index.md',+ );+ expect(readProjectConfig(configPath).contentRules?.okf?.generate?.index).toBe(false);+ expect(readFileSync(attributesPath, 'utf-8')).toBe('index.md merge=ours\n');+});diff --git a/packages/app/tests/stress/okf-recommended-skill-install.e2e.ts b/packages/app/tests/stress/okf-recommended-skill-install.e2e.tsnew file mode 100644index 000000000..0f9b785f2--- /dev/null+++ b/packages/app/tests/stress/okf-recommended-skill-install.e2e.ts@@ -0,0 +1,71 @@+/**+ * Browser coverage for the OKF recommendation's complete install path.+ *+ * The dedicated worker owns its skill roots because the test authors a real+ * project skill. Reloading after installation drops the card's optimistic state,+ * proving the server's skills listing recognizes what the install endpoint wrote.+ */++import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';+import { join } from 'node:path';+import type { Page } from '@playwright/test';+import { expect, test } from './_helpers';++test.use({+ workerServerEnv: { OK_TEST_OKF_RECOMMENDED_SKILL: 'isolated-content-v1' },+});++async function openOkfSettings(page: Page): Promise<void> {+ await page.goto('/#settings/plugins-manage');+ await expect(page.getByTestId('settings-plugins-manage')).toBeVisible({ timeout: 30_000 });++ const okfToggle = page.getByTestId('settings-plugin-toggle-okf');+ await expect(okfToggle).toBeVisible();+ if ((await okfToggle.getAttribute('aria-checked')) !== 'true') await okfToggle.click();+ await expect(okfToggle).toHaveAttribute('aria-checked', 'true');++ await page.goto('/#settings/plugin:okf');+ await expect(page.getByTestId('settings-plugin-okf')).toBeVisible({ timeout: 30_000 });+}++test('installs the recommended skill through the real endpoint and recognizes it after reload', async ({+ page,+ workerServer,+}) => {+ const platformSkillDir = join(workerServer.contentDir, '.claude', 'skills', 'open-knowledge');+ mkdirSync(platformSkillDir, { recursive: true });+ writeFileSync(+ join(platformSkillDir, 'SKILL.md'),+ '---\nname: open-knowledge\ndescription: project skill\n---\n',+ 'utf-8',+ );++ await openOkfSettings(page);+ const card = page.getByTestId('settings-okf-recommended-skill');+ await expect(card).toBeVisible();+ await card.getByRole('button', { name: 'Install skill' }).click();++ const dialog = page.getByRole('dialog', { name: 'Install from OKF' });+ await expect(dialog).toBeVisible();+ await expect(dialog).toContainText('Project');+ await expect(dialog).toContainText('okf-knowledge-base');+ await dialog.getByRole('button', { name: 'Install selected' }).click();++ const installedSkill = join(+ workerServer.contentDir,+ '.claude',+ 'skills',+ 'okf-knowledge-base',+ 'SKILL.md',+ );+ await expect.poll(() => existsSync(installedSkill), { timeout: 15_000 }).toBe(true);+ expect(readFileSync(installedSkill, 'utf-8')).toContain('name: okf-knowledge-base');+ await expect(card).toContainText('Installed');++ await page.reload();+ await expect(page.getByTestId('settings-plugin-okf')).toBeVisible({ timeout: 30_000 });+ const reloadedCard = page.getByTestId('settings-okf-recommended-skill');+ await expect(reloadedCard).toContainText('Installed');+ await expect(reloadedCard.getByRole('button', { name: 'Open skill' })).toBeVisible();+ await expect(reloadedCard.getByRole('button', { name: 'Install skill' })).toHaveCount(0);+});diff --git a/packages/cli/src/commands/seed.ts b/packages/cli/src/commands/seed.tsindex f3190eec0..0fe73859c 100644--- a/packages/cli/src/commands/seed.ts+++ b/packages/cli/src/commands/seed.ts@@ -14,6 +14,7 @@ import {AGENTS_SKILLS_ROOT,EDITOR_PROJECT_SKILL_ROOT,PROJECT_SKILL_EDITOR_IDS,+ planHasOutstandingWork,skillRootActivationPath,} from '@inkeep/open-knowledge-core';import {@@ -129,12 +130,13 @@ export async function runSeed(opts: SeedCommandOptions = {}): Promise<SeedComman};}- // A pending pack skill is outstanding work even when every folder/template- // already exists (see ScaffoldPlan.packSkills) — `applySeed` would still author- // and install it, so this is not a no-op. SeedDialog folds the same two signals.- // Nothing is pending when the project has no usable skill home: apply declines- // there, so this stays a no-op run after run and the message says why.- if (plan.created.length === 0 && !plan.packSkills?.some((s) => s.pending)) {+ // A pending pack skill or a required plugin that is off is outstanding work+ // even when every folder/template already exists — `applySeed` would still+ // author the skill and enable the plugin, so this is not a no-op. Shared with+ // SeedDialog so the CLI and the dialog cannot disagree about what "nothing to+ // do" means. A refused skill install is not outstanding work because apply+ // cannot perform it; the refusal note below explains what the user must do.+ if (!planHasOutstandingWork(plan)) {const packName = STARTER_PACKS[packId].name;// A conflicted skill is present-but-not-ours: "already seeded" would// misread the user's own skill as the pack's, so say what's actually true.@@ -212,6 +214,15 @@ export async function runSeed(opts: SeedCommandOptions = {}): Promise<SeedComman? `\n${dim(`Installed the ${packName} skills for: ${applyResult.packSkillsInstalled.join(', ')}`)}`: '';+ // Name the plugins this run switched on. Silence here would leave a user who+ // had one off to discover the change in Settings later with no explanation —+ // the same disclosure the dialog owes, on the surface the CLI user is looking+ // at. Only plugins actually flipped are listed, so a re-seed says nothing.+ const pluginLine =+ applyResult.pluginsEnabled.length > 0+ ? `\n${dim(`Enabled plugin(s) included with this pack: ${applyResult.pluginsEnabled.join(', ')} — turn off any time in Settings.`)}`+ : '';+// Name collisions are not errors — the seed succeeded and the user's own// skill was left untouched — but silence would read as "pack installed".// `hosts` means the skill DID install — a same-named skill of the user's only@@ -226,7 +237,7 @@ export async function runSeed(opts: SeedCommandOptions = {}): Promise<SeedCommanreturn {status: 'applied',- message: `${success(`✓ Seeded ${packName}`)} ${dim(`(${applyResult.applied} entries, ${applyResult.durationMs}ms)`)}${skillLine}${skillHomeRefusalNote(plan, packName)}${conflictLines}`,+ message: `${success(`✓ Seeded ${packName}`)} ${dim(`(${applyResult.applied} entries, ${applyResult.durationMs}ms)`)}${skillLine}${pluginLine}${skillHomeRefusalNote(plan, packName)}${conflictLines}`,plan,exitCode: 0,};diff --git a/packages/core/package.json b/packages/core/package.jsonindex f7ef0ff9b..062b3578b 100644--- a/packages/core/package.json+++ b/packages/core/package.json@@ -98,6 +98,7 @@"mdast-util-mdx-expression": "^2.0.1","mdast-util-mdx-jsx": "3.2.0","mdast-util-to-markdown": "^2.1.2",+ "mdast-util-to-string": "^4.0.0","micromark-extension-mdx": "2.1.0","micromark-util-classify-character": "^2.0.1","micromark-util-decode-numeric-character-reference": "^2.0.2",@@ -116,6 +117,7 @@"remark-rehype": "^11.1.2","remark-stringify": "^11.0.0","unified": "^11.0.5",+ "unified-lint-rule": "^3.0.0","unist-util-visit": "^5.1.0","vfile": "^6.0.0","vfile-message": "^4.0.3",diff --git a/packages/core/src/bridge/bind-frontmatter-doc.ts b/packages/core/src/bridge/bind-frontmatter-doc.tsindex d7a845280..dfd95ef49 100644--- a/packages/core/src/bridge/bind-frontmatter-doc.ts+++ b/packages/core/src/bridge/bind-frontmatter-doc.ts@@ -1,3 +1,4 @@+import type * as Y from 'yjs';import type { Err, Ok, Result } from '../config/result.ts';import { type FrontmatterValidationError, toFrontmatterIssue } from '../frontmatter/errors.ts';diff --git a/packages/core/src/bridge/bridge-invariant.ts b/packages/core/src/bridge/bridge-invariant.tsindex 005627195..8bfdb40cd 100644--- a/packages/core/src/bridge/bridge-invariant.ts+++ b/packages/core/src/bridge/bridge-invariant.ts@@ -1,3 +1,4 @@+import { fnv1aDigest } from './hash-util.ts';export type BridgeInvariantSite = 'observer-b' | 'persistence' | 'test-harness';diff --git a/packages/core/src/bridge/compose.ts b/packages/core/src/bridge/compose.tsindex 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/divergence-locate.ts b/packages/core/src/bridge/divergence-locate.tsindex 6b505314d..d979f4b39 100644--- a/packages/core/src/bridge/divergence-locate.ts+++ b/packages/core/src/bridge/divergence-locate.ts@@ -1,3 +1,4 @@+import { findFirstDivergenceIndex } from './tolerance-telemetry.ts';export const BRIDGE_LINE_KINDS = [diff --git a/packages/core/src/bridge/doc-boundary-space.ts b/packages/core/src/bridge/doc-boundary-space.tsindex 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/bridge/growth-detect.ts b/packages/core/src/bridge/growth-detect.tsindex 9d9c244b0..463e89595 100644--- a/packages/core/src/bridge/growth-detect.ts+++ b/packages/core/src/bridge/growth-detect.ts@@ -1,3 +1,4 @@+const DEFAULT_MIN_SUBSTANTIVE_LINE_LENGTH = 16;export const DUPLICATION_GATE_MIN_LINE_LENGTH = 8;diff --git a/packages/core/src/bridge/intraline-predicate.ts b/packages/core/src/bridge/intraline-predicate.tsindex c43fdd7e7..0939885bb 100644--- a/packages/core/src/bridge/intraline-predicate.ts+++ b/packages/core/src/bridge/intraline-predicate.ts@@ -1,3 +1,4 @@+export function rawLineCounts(doc: string): Map<string, number> {const counts = new Map<string, number>();for (const line of doc.split('\n')) {diff --git a/packages/core/src/bridge/merge-three-way.ts b/packages/core/src/bridge/merge-three-way.tsindex 251560a35..c0dc65705 100644--- a/packages/core/src/bridge/merge-three-way.ts+++ b/packages/core/src/bridge/merge-three-way.ts@@ -65,6 +65,7 @@ export function tryLineLevelCombine(return { clean: true, merged };}+export type BridgeMergeContentLossSide = 'user' | 'agent';export type BridgeMergeContentLossWhich = 'substring' | 'order' | 'growth';diff --git a/packages/core/src/bridge/normalize.ts b/packages/core/src/bridge/normalize.tsindex 01ac80099..dcc5b0690 100644--- a/packages/core/src/bridge/normalize.ts+++ b/packages/core/src/bridge/normalize.ts@@ -1,3 +1,4 @@+import { stripFrontmatter } from '../extensions/frontmatter.ts';import { bodyEdgeEmpties } from './doc-boundary-space.ts';diff --git a/packages/core/src/bridge/pm-structural-equivalence.ts b/packages/core/src/bridge/pm-structural-equivalence.tsindex 754dc5cc2..0be5203e4 100644--- a/packages/core/src/bridge/pm-structural-equivalence.ts+++ b/packages/core/src/bridge/pm-structural-equivalence.ts@@ -32,6 +32,7 @@ const BR_SENTINEL: PmStructuralNode = { type: '__br__' };const BR_LITERAL_RE = /^<br\s*\/?>$/i;+interface DegradeEntry {readonly label: string;readonly severity: ToleranceClassSeverity;@@ -127,6 +128,7 @@ export interface ComparePmStructuralOptions {ignoreAttrs?: (attrKey: string) => boolean;}+/** Rebuild a node with `fn` applied to each child; identity when childless.* Shared by the degrade canonicalizers so none re-implements the walk. */function mapChildren(@@ -248,6 +250,7 @@ function applyDegrades(tree: PmStructuralNode): {return { normalized: current, fired };}+export function comparePmStructural(expected: PmStructuralNode,actual: PmStructuralNode,diff --git a/packages/core/src/bridge/subsequence.ts b/packages/core/src/bridge/subsequence.tsindex af20de1e2..dca644141 100644--- a/packages/core/src/bridge/subsequence.ts+++ b/packages/core/src/bridge/subsequence.ts@@ -1,3 +1,4 @@+/** True when `needle` is a subsequence of `haystack` (two-pointer, O(n+m)):* insertions in `haystack` are free; any dropped or substituted `needle` byte* fails. */diff --git a/packages/core/src/config/field-registry.test.ts b/packages/core/src/config/field-registry.test.tsindex 66871404f..87f0c1b22 100644--- a/packages/core/src/config/field-registry.test.ts+++ b/packages/core/src/config/field-registry.test.ts@@ -263,6 +263,9 @@ describe('ConfigSchema coverage (NR3 — every leaf has fieldRegistry metadata)''contentRules.frontmatter.enabled','contentRules.frontmatter.schemas','contentRules.markdownlint.enabled',+ 'contentRules.okf.enabled',+ 'contentRules.okf.generate.index',+ 'contentRules.okf.rules','lossCapture.enabled','lossCapture.maxBytes','remote.port',diff --git a/packages/core/src/config/schema.ts b/packages/core/src/config/schema.tsindex 56eb3372a..2434f7940 100644--- a/packages/core/src/config/schema.ts+++ b/packages/core/src/config/schema.ts@@ -1125,10 +1125,76 @@ export const ConfigSchema = z.looseObject({.default([]),}).default({ enabled: false, schemas: [] }),+ okf: z+ .object({+ enabled: z+ .boolean()+ .register(fieldRegistry, {+ scope: 'project',+ agentSettable: false,+ reload: 'live',+ defaultScope: 'project',+ description:+ 'Whether the OKF plugin (Open Knowledge Format portability + conformance rules) contributes diagnostics. Advisory warnings; never blocks a write.',+ })+ .default(false),+ // Per-rule opt-outs. No severity map: OKF findings are uniformly+ // advisory warnings, so a rule is only ever on or off. Deliberately+ // PARTIAL — absent means the rule runs, so a config records only+ // deviations and a newly registered rule is live without anyone+ // editing their config.+ //+ // The key space is OPEN, matching `markdownlint.rules`, and that is+ // load-bearing rather than lax. `config.yml` is committed and shared,+ // and this rule set grows: with a closed enum, a config written after+ // a new rule shipped fails to parse on any older build — and because+ // a schema failure defaults the WHOLE document, that one unknown key+ // silently reverts `content.dir`, the theme, and every other setting.+ // An unrecognized id is inert instead (`isOkfRuleEnabled` only ever+ // looks up registered ids); the settings pane is what keeps a human+ // from typo'ing one in the first place.+ rules: z+ .record(z.string(), z.boolean())+ .register(fieldRegistry, {+ scope: 'project',+ agentSettable: false,+ reload: 'live',+ defaultScope: 'project',+ description:+ 'Per-rule opt-outs for the OKF plugin, keyed by rule id (e.g. no-wiki-links). Omit a rule to leave it enabled; set false to silence it while keeping the plugin on.',+ })+ .optional(),+ // The producer half of the format. Every other key under a plugin+ // describes what it REPORTS; these make it write files, which is why+ // they are opt-in separately from `enabled` rather than riding it. A+ // user who turned the plugin on to see conformance warnings did not+ // thereby ask OK to start owning documents in their tree.+ //+ // Keyed by artifact rather than a flat `generateIndex` boolean: a+ // second generated file is then a value, not a schema reshape of a+ // structure users already have in their config files.+ generate: z+ .object({+ index: z+ .boolean()+ .register(fieldRegistry, {+ scope: 'project',+ agentSettable: false,+ reload: 'live',+ defaultScope: 'project',+ description:+ 'Whether OK generates and maintains a navigation index.md in every folder that contains Markdown, each listing the documents in that folder grouped by frontmatter type and linking to its subfolders. OK owns these files: edits to them are replaced on the next rebuild.',+ })+ .default(false),+ })+ .default({ index: false }),+ })+ .default({ enabled: false, generate: { index: false } }),}).default({markdownlint: { enabled: false },frontmatter: { enabled: false, schemas: [] },+ okf: { enabled: false, generate: { index: false } },}),// Validation-surface behavior (the unified audit plane's non-plugin knobs).// PROJECT scope, like `contentRules`: how broken links are classified anddiff --git a/packages/core/src/desktop-bridge.ts b/packages/core/src/desktop-bridge.tsindex d7b7686e5..f452628c7 100644--- a/packages/core/src/desktop-bridge.ts+++ b/packages/core/src/desktop-bridge.ts@@ -31,6 +31,7 @@ import type {OkBugReportSendResult,ReportBundleLevel,} from './logger-types.ts';+import type { LintPluginId } from './markdown/lint/types.ts';import type { LocalOpOkInitResponse } from './schemas/api/local-op.ts';import type {BranchInfoResponse,@@ -724,9 +725,18 @@ export interface OkScaffoldPlan {skipped: OkScaffoldSkipEntry[];warnings: string[];/** Project-local skills shipped by the pack. `pending` means apply would- * author or refresh the skill source. `conflict` means a user-owned skill- * holds the name; apply will neither install nor clobber it. */+ * author or refresh the skill source. `conflict` means a user-owned skill+ * holds the name; apply will neither install nor clobber it. */packSkills?: { name: string; pending: boolean; conflict?: boolean }[];+ /**+ * Lint plugins the pack requires. `pending` means apply would turn one on.+ *+ * `id` is the plugin union rather than a bare `string`: this interface is+ * hand-mirrored from the server's `ScaffoldPlan`, and the preload passes one+ * where the other is expected — so a widened field here does not read as+ * "more permissive", it fails to assign.+ */+ requiredPlugins?: { id: LintPluginId; pending: boolean }[];}export interface OkScaffoldApplyError {path: string;@@ -738,6 +748,8 @@ export interface OkScaffoldApplyResult {durationMs: number;/** Editor display-names that received the pack's project skill (e.g. "Claude Code"). */packSkillsInstalled: string[];+ /** Required plugins this apply actually turned on; empty when all were already enabled. */+ pluginsEnabled: LintPluginId[];/** Pack skills skipped because a user-owned same-named skill holds the name. */packSkillConflicts: { name: string; hosts?: string[] }[];}diff --git a/packages/core/src/index.ts b/packages/core/src/index.tsindex bf9e41315..1f5ad87ae 100644--- a/packages/core/src/index.ts+++ b/packages/core/src/index.ts@@ -636,6 +636,8 @@ export {type AppliesToSummary,applyFieldConstraint,applyTextEdits,+ assertNeverOkfRuleGroupId,+ assertNeverOkfRuleId,CANONICAL_SCHEMA_DIALECT_URIS,type CompiledAppliesTo,canonicalRuleId,@@ -663,6 +665,7 @@ export {frontmatterSchemaCompileError,isFrontmatterSchemaAsset,isMarkdownlintJsonConfig,+ isOkfRuleEnabled,isSupportedSchemaDialect,isToolManagedSchemaPath,LINKS_VALIDATION_SETTINGS,@@ -699,6 +702,19 @@ export {MarkdownlintRuleWriteRequestSchema,type MarkdownlintRuleWriteValue,type MarkdownlintSlice,+ OKF_FRONTMATTER_REGISTRY,+ OKF_PROJECT_REGISTRY,+ OKF_RULE_GROUPS,+ OKF_RULE_IDS,+ OKF_SCHEMA_DIR,+ type OkfProjectFinding,+ type OkfRuleGroupId,+ type OkfRuleId,+ type OkfRuleToggles,+ type OkfSchemaFile,+ type OkfSlice,+ okfAdvertisedSchemaMappings,+ okfSchemaPathFor,type PersistedLinterConfig,type ResolvedFrontmatterSchemaEntry,RULE_DISPLAY_CATEGORIES,@@ -708,12 +724,16 @@ export {type RuleOptionType,removeSchemaField,renameSchemaField,+ renderOkfSchemaFiles,resolveFrontmatterSchemaDialect,resolveMarkdownlintConfig,runMarkdownlint,+ runOkfFrontmatterRules,+ runOkfProjectRules,type SchemaParentPathSegment,SUPPORTED_SCHEMA_DIALECTS,selectApplicableFrontmatterSchemas,+ selectOkfFrontmatterSchemas,summarizeAppliesTo,toEffectiveBase,type ValidationAuditCountsResponse,@@ -1124,6 +1144,10 @@ export {SeedApplyRequestSchema,type SeedApplySuccess,SeedApplySuccessSchema,+ type SeedInstallPackSkillRequest,+ SeedInstallPackSkillRequestSchema,+ type SeedInstallPackSkillSuccess,+ SeedInstallPackSkillSuccessSchema,type SeedListPacksSuccess,SeedListPacksSuccessSchema,type SeedPackEntryCounts,@@ -1715,6 +1739,7 @@ export {workspaceSearchBasename,workspaceSearchPathSegments,} from './search/workspace-search.ts';+export { planHasOutstandingWork, type SeedPlanWorkShape } from './seed-plan-work.ts';export {type BranchMatchOutcome,type Candidate,@@ -1875,6 +1900,7 @@ export {getIdentity,HUMAN_COLORS,iconFromClientName,+ SYSTEM_WRITER_DISPLAY_NAMES,} from './utils/identity.ts';export {type AnchorLinkTarget,diff --git a/packages/core/src/markdown/callout-transformer.ts b/packages/core/src/markdown/callout-transformer.tsindex 83d47404a..a363dfd54 100644--- a/packages/core/src/markdown/callout-transformer.ts+++ b/packages/core/src/markdown/callout-transformer.ts@@ -1,3 +1,4 @@+import type { Blockquote, Paragraph, Root } from 'mdast';import type { MdxJsxAttribute, MdxJsxFlowElement } from 'mdast-util-mdx';import { visit } from 'unist-util-visit';diff --git a/packages/core/src/markdown/code-fence.ts b/packages/core/src/markdown/code-fence.tsindex 9807a7e82..4499dbc92 100644--- a/packages/core/src/markdown/code-fence.ts+++ b/packages/core/src/markdown/code-fence.ts@@ -1,3 +1,4 @@+export function selectFenceChar(info: string): '`' | '~' {return info.includes('`') ? '~' : '`';}diff --git a/packages/core/src/markdown/comment-promoter.ts b/packages/core/src/markdown/comment-promoter.tsindex 7415c474a..34704165b 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/dedent-block-jsx-close.ts b/packages/core/src/markdown/dedent-block-jsx-close.tsindex ece5c02a1..b6299a948 100644--- a/packages/core/src/markdown/dedent-block-jsx-close.ts+++ b/packages/core/src/markdown/dedent-block-jsx-close.ts@@ -1,3 +1,4 @@+import { findFencedRegions, isInsideFence } from './fence-regions.ts';const INDENTED_BLOCK_JSX_CLOSE_RE = /^([ ]{1,3})(<\/[A-Z][A-Za-z0-9_]*\s*>)([ \t]*)$/gm;diff --git a/packages/core/src/markdown/details-accordion-promoter.ts b/packages/core/src/markdown/details-accordion-promoter.tsindex 54774764a..acd398aa6 100644--- a/packages/core/src/markdown/details-accordion-promoter.ts+++ b/packages/core/src/markdown/details-accordion-promoter.ts@@ -1,3 +1,4 @@+import type { Nodes, Paragraph, Parent, Root, Text } from 'mdast';import type { MdxJsxAttribute, MdxJsxFlowElement } from 'mdast-util-mdx';import { visit } from 'unist-util-visit';diff --git a/packages/core/src/markdown/div-align-promoter.ts b/packages/core/src/markdown/div-align-promoter.tsindex 43ecdc709..ba9b56384 100644--- a/packages/core/src/markdown/div-align-promoter.ts+++ b/packages/core/src/markdown/div-align-promoter.ts@@ -1,3 +1,4 @@+import type { Nodes, Paragraph, Parent, Root, Text } from 'mdast';import type { MdxJsxFlowElement } from 'mdast-util-mdx';import { visit } from 'unist-util-visit';diff --git a/packages/core/src/markdown/fence-regions.ts b/packages/core/src/markdown/fence-regions.tsindex 6d3f3643e..4513da9bb 100644--- a/packages/core/src/markdown/fence-regions.ts+++ b/packages/core/src/markdown/fence-regions.ts@@ -1,3 +1,4 @@+const FENCE_RE = /^(`{3,}|~{3,})/gm;export function findFencedRegions(src: string): Array<[number, number]> {diff --git a/packages/core/src/markdown/fixtures/index.ts b/packages/core/src/markdown/fixtures/index.tsindex 00f5771ee..6931623c7 100644--- a/packages/core/src/markdown/fixtures/index.ts+++ b/packages/core/src/markdown/fixtures/index.ts@@ -1,3 +1,4 @@+import { readFileSync } from 'node:fs';import { dirname, resolve } from 'node:path';import { fileURLToPath } from 'node:url';@@ -8,6 +9,7 @@ function fixturePath(...segments: string[]): string {return resolve(FIXTURES_DIR, ...segments);}+interface GfmExample {section: string;markdown: string;@@ -17,6 +19,7 @@ export function loadGfmExamples(): GfmExample[] {return JSON.parse(readFileSync(fixturePath('gfm', 'examples.json'), 'utf8')) as GfmExample[];}+interface MdxCrashEntry {id: string;input: string;@@ -68,6 +71,7 @@ export function loadLargeEmbedFixtures(): LargeEmbedFixture[] {) as LargeEmbedFixture[];}+export function loadPrd6955Before(): string {return readFileSync(fixturePath('regression', 'prd-6955-before.md'), 'utf8');}@@ -76,6 +80,7 @@ export function loadPrd6955CorruptedTriplicated(): string {return readFileSync(fixturePath('regression', 'prd-6955-corrupted-triplicated.md'), 'utf8');}+export interface NgPinnedCase {id: string;name: string;@@ -92,6 +97,7 @@ export function loadNgPinnedCases(): NgPinnedCase[] {) as NgPinnedCase[];}+export function loadLargeRealistic(): string {return readFileSync(fixturePath('perf', 'large-realistic.md'), 'utf8');}diff --git a/packages/core/src/markdown/fixtures/perf/generate.ts b/packages/core/src/markdown/fixtures/perf/generate.tsindex 8b1eb8519..daa3ef82b 100644--- a/packages/core/src/markdown/fixtures/perf/generate.ts+++ b/packages/core/src/markdown/fixtures/perf/generate.ts@@ -1,3 +1,4 @@+import { writeFileSync } from 'node:fs';import { dirname, resolve } from 'node:path';import { fileURLToPath } from 'node:url';@@ -10,6 +11,7 @@ const BASELINE_ONLY_COUNTS = [500, 2500] as const;const SEED = 0xf1de1117;+function mulberry32(seed: number): () => number {let a = seed >>> 0;return () => {@@ -36,6 +38,7 @@ function pickWeighted<T>(rand: () => number, items: readonly [T, number][]): T {return items[items.length - 1][0];}+const WORDS = ['lorem','ipsum',@@ -153,6 +156,7 @@ function mdxBlock(rand: () => number): string {return `<${name}>\n\n${sentence(rand)}\n\n</${name}>`;}+type BlockKind = 'paragraph' | 'heading' | 'list' | 'code' | 'table' | 'mdx';const MIX: readonly [BlockKind, number][] = [@@ -191,6 +195,7 @@ function generateDocument(blockCount: number, seed: number): string {return `${blocks.join('\n\n')}\n`;}+function main(): void {for (const count of [...BLOCK_COUNTS, ...BASELINE_ONLY_COUNTS]) {const doc = generateDocument(count, SEED);diff --git a/packages/core/src/markdown/guard-flanking-matrix.ts b/packages/core/src/markdown/guard-flanking-matrix.tsindex 420dc0fe5..32c055c5b 100644--- a/packages/core/src/markdown/guard-flanking-matrix.ts+++ b/packages/core/src/markdown/guard-flanking-matrix.ts@@ -7,6 +7,7 @@ import {import { BACKSLASH_GUARD_SUBSTITUTIONS, encodeBackslashEscapes } from './backslash-escape-guard.ts';import { ENTITY_REF_GUARD_SUBSTITUTIONS, encodeEntityRefs } from './entity-ref-guard.ts';+export const ATTENTION_DELIMITERS = ['*', '_', '**', '~~', '=='] as const;export type FlankClass = 'whitespace' | 'punctuation' | 'other';diff --git a/packages/core/src/markdown/handler-shadow-audit.ts b/packages/core/src/markdown/handler-shadow-audit.tsindex 2653473da..283913255 100644--- a/packages/core/src/markdown/handler-shadow-audit.ts+++ b/packages/core/src/markdown/handler-shadow-audit.ts@@ -1,3 +1,4 @@+export interface HandlerShadowWitness {input: string;expect: 'byte' | 'byte-and-reparse-type';diff --git a/packages/core/src/markdown/highlight-promoter.ts b/packages/core/src/markdown/highlight-promoter.tsindex da0a81d23..5d1000cc4 100644--- a/packages/core/src/markdown/highlight-promoter.ts+++ b/packages/core/src/markdown/highlight-promoter.ts@@ -1,3 +1,4 @@+import type { Nodes, Parent, PhrasingContent, Root, Text } from 'mdast';import type { MdxJsxTextElement } from 'mdast-util-mdx';import { SKIP, visit } from 'unist-util-visit';diff --git a/packages/core/src/markdown/html-to-mdast.ts b/packages/core/src/markdown/html-to-mdast.tsindex 787315157..9681c0056 100644--- a/packages/core/src/markdown/html-to-mdast.ts+++ b/packages/core/src/markdown/html-to-mdast.ts@@ -1,3 +1,4 @@+import type { Element as HastElement, Root as HastRoot } from 'hast';import type { List, Nodes as MdastNodes, Root as MdastRoot } from 'mdast';import rehypeParse from 'rehype-parse';@@ -128,7 +129,8 @@ export function htmlToMdast(html: string, options?: HtmlToMdastOptions): MdastRothrow new HtmlPayloadTooLargeError(html.length, maxBytes);}- const processor = unified().use(rehypeParse, { fragment: true });+ const processor = unified()+ .use(rehypeParse, { fragment: true });for (const plugin of cleanupPlugins) {processor.use(plugin);diff --git a/packages/core/src/markdown/image-promoter.ts b/packages/core/src/markdown/image-promoter.tsindex 706fa9afb..994eb6917 100644--- a/packages/core/src/markdown/image-promoter.ts+++ b/packages/core/src/markdown/image-promoter.ts@@ -1,3 +1,4 @@+import type { Image, Paragraph, Root } from 'mdast';import type { MdxJsxAttribute, MdxJsxFlowElement } from 'mdast-util-mdx';import { visit } from 'unist-util-visit';diff --git a/packages/core/src/markdown/index.ts b/packages/core/src/markdown/index.tsindex 779e27500..ec1ac1b7e 100644--- a/packages/core/src/markdown/index.ts+++ b/packages/core/src/markdown/index.ts@@ -1,3 +1,4 @@+import {type FromProseMirrorOptions,fromPmMark,@@ -206,6 +207,7 @@ export class MarkdownManager {}}+const registry = createRegistry();function destructureAttrs(@@ -254,6 +256,7 @@ function destructureAttrs(return result;}+function hasDirtyDescendant(node: PmNode): boolean {let found = false;node.descendants((child) => {@@ -276,6 +279,7 @@ function effectiveDirty(node: PmNode, freshnessChecker?: StructuralFreshnessChecreturn freshnessChecker ? freshnessChecker.isDiverged(node.toJSON()) : false;}+function isEmptyMdastParagraph(node: MdastNodes): boolean {if (node.type !== 'paragraph') return false;const children = node.children ?? [];@@ -344,6 +348,7 @@ function extractTextFromMdastNodes(nodes: MdastNodes[]): string {return out;}+import {AUDIO_EXTENSIONS,FILE_ATTACHMENT_EXTENSIONS,@@ -596,6 +601,7 @@ function buildMdastToPmHandlers(}));}+if (m.emphasis) {handlers.emphasis = toPmMark(m.emphasis, (node: Emphasis) => ({sourceDelimiter: node.data?.sourceDelimiter ?? '*',@@ -676,6 +682,7 @@ function buildMdastToPmHandlers(}));}+if (m.link) {const sourceLiteralMark = m.sourceLiteral;handlers.link = (node: Link, _parent: MdastParent, state: MdastToPmState) => {@@ -973,6 +980,7 @@ function buildMdastToPmHandlers(};}+const blockUnknownHandler = (node: {type: string;position?: { start: { offset: number }; end: { offset: number } };@@ -1098,6 +1106,7 @@ function buildMdastToPmHandlers(return handlers as RemarkProseMirrorOptions['handlers'];}+function buildPmToMdastHandlers(schema: Schema,freshness: FreshnessCheckerHolder,diff --git a/packages/core/src/markdown/lint/applies-to.ts b/packages/core/src/markdown/lint/applies-to.tsindex fa0be9e86..b79e9aef7 100644--- a/packages/core/src/markdown/lint/applies-to.ts+++ b/packages/core/src/markdown/lint/applies-to.ts@@ -1,3 +1,4 @@+import picomatch from 'picomatch';import { SUPPORTED_DOC_EXTENSIONS } from '../../constants/doc-extensions.ts';diff --git a/packages/core/src/markdown/lint/config-files.ts b/packages/core/src/markdown/lint/config-files.tsindex 312c9c74b..94b34dee1 100644--- a/packages/core/src/markdown/lint/config-files.ts+++ b/packages/core/src/markdown/lint/config-files.ts@@ -1,3 +1,4 @@+const MARKDOWNLINT_JSON_CONFIG_FILES: ReadonlySet<string> = new Set(['.markdownlint.json','.markdownlint.jsonc',diff --git a/packages/core/src/markdown/lint/config-schemas.ts b/packages/core/src/markdown/lint/config-schemas.tsindex c400441b2..7d97004fb 100644--- a/packages/core/src/markdown/lint/config-schemas.ts+++ b/packages/core/src/markdown/lint/config-schemas.ts@@ -2,6 +2,7 @@ import { z } from 'zod';import { agentIdentityFields, safeDocNameField, summaryField } from '../../schemas/api/_shared.ts';import { LocalTargetDiagnosticEvidenceSchema } from '../../schemas/api/agent-write.ts';import { DEFAULT_MARKDOWNLINT_CONFIG } from './default-config.ts';+import type { OkfRuleId } from './okf-rule-meta.ts';import { LINT_PLUGINS, type LinterConfig } from './plugins.ts';import type { FrontmatterSchemaMapping, MarkdownlintRuleSetting } from './types.ts';@@ -13,10 +14,16 @@ interface PersistedFrontmatterSlice {enabled: boolean;schemas?: FrontmatterSchemaMapping[];}+interface PersistedOkfSlice {+ enabled: boolean;+ rules?: Partial<Record<OkfRuleId, boolean>>;+ generate?: { index?: boolean };+}export interface PersistedLinterConfig {enabled?: boolean;markdownlint: PersistedMarkdownlintSlice;frontmatter?: PersistedFrontmatterSlice;+ okf?: PersistedOkfSlice;}export function toEffectiveBase(persisted: PersistedLinterConfig): LinterConfig {@@ -31,6 +38,11 @@ export function toEffectiveBase(persisted: PersistedLinterConfig): LinterConfigenabled: persisted.frontmatter?.enabled ?? false,schemas: persisted.frontmatter?.schemas ?? [],},+ okf: {+ enabled: persisted.okf?.enabled ?? false,+ ...(persisted.okf?.rules === undefined ? {} : { rules: persisted.okf.rules }),+ generate: { index: persisted.okf?.generate?.index ?? false },+ },},};}@@ -39,6 +51,7 @@ const fullPluginShape = Object.fromEntries(LINT_PLUGINS.map((plugin) => [plugin.id, plugin.sliceSchema]),) as z.ZodRawShape;+export const LinterConfigSchema = z.object({enabled: z.boolean(),plugins: z.object(fullPluginShape),diff --git a/packages/core/src/markdown/lint/default-config.ts b/packages/core/src/markdown/lint/default-config.tsindex d48eea5e4..a51f2ffb0 100644--- a/packages/core/src/markdown/lint/default-config.ts+++ b/packages/core/src/markdown/lint/default-config.ts@@ -6,6 +6,7 @@ export const DEFAULT_MARKDOWNLINT_CONFIG: Record<string, MarkdownlintRuleSettingMD013: false,};+export function resolveMarkdownlintConfig(rules: Record<string, MarkdownlintRuleSetting> | undefined,): Configuration {diff --git a/packages/core/src/markdown/lint/frontmatter-schema-edit.ts b/packages/core/src/markdown/lint/frontmatter-schema-edit.tsindex ef478e268..9c9542661 100644--- a/packages/core/src/markdown/lint/frontmatter-schema-edit.ts+++ b/packages/core/src/markdown/lint/frontmatter-schema-edit.ts@@ -1,3 +1,4 @@+import { CANONICAL_SCHEMA_DIALECT_URIS, DEFAULT_SCHEMA_DIALECT } from './frontmatter-validate.ts';export interface FrontmatterFieldConstraint {diff --git a/packages/core/src/markdown/lint/frontmatter-validate.ts b/packages/core/src/markdown/lint/frontmatter-validate.tsindex 0d4c9a0df..ca6eed91c 100644--- a/packages/core/src/markdown/lint/frontmatter-validate.ts+++ b/packages/core/src/markdown/lint/frontmatter-validate.ts@@ -1,3 +1,4 @@+import Ajv, { type ValidateFunction } from 'ajv';import Ajv2019 from 'ajv/dist/2019.js';import Ajv2020 from 'ajv/dist/2020.js';@@ -10,11 +11,16 @@ import {unwrapFrontmatterFences,} from '../../extensions/frontmatter.ts';import { compileAppliesTo } from './applies-to.ts';-import type { LintDiagnostic, ResolvedFrontmatterSchemaEntry } from './types.ts';+import type { LintDiagnostic, LintPluginId, ResolvedFrontmatterSchemaEntry } from './types.ts';export interface LoadedFrontmatterSchema {file: string;schema: Record<string, unknown>;+ ruleId?: string;+}++export interface ValidateFrontmatterOptions {+ source?: LintPluginId;}export function selectApplicableFrontmatterSchemas(@@ -217,8 +223,10 @@ function pointerToDotPath(instancePath: string): string {export function validateFrontmatterSource(text: string,schemas: readonly LoadedFrontmatterSchema[],+ options?: ValidateFrontmatterOptions,): LintDiagnostic[] {if (schemas.length === 0) return [];+ const source = options?.source ?? 'frontmatter';const { data, keyLines } = parseFrontmatterData(text);const lines = text.split('\n');const lineSpan = (line: number): LintDiagnostic['range'] => ({@@ -227,17 +235,20 @@ export function validateFrontmatterSource(});const diagnostics: LintDiagnostic[] = [];- for (const { schema } of schemas) {+ for (const { schema, ruleId } of schemas) {const validate = compileSchema(schema);if (!validate) continue;if (validate(data)) continue;for (const error of validate.errors ?? []) {const keyword = error.keyword;+ if (keyword === 'if') continue;let line = 0;let message: string;let frontmatterScope: 'missing' | 'invalid' = 'invalid';let frontmatterProperty: string | undefined;- if (keyword === 'required' && error.instancePath === '') {+ if (keyword === 'maxProperties' && error.instancePath === '') {+ message = 'This document must not have frontmatter';+ } else if (keyword === 'required' && error.instancePath === '') {const missing = String((error.params as { missingProperty?: unknown }).missingProperty ?? '',);@@ -263,8 +274,8 @@ export function validateFrontmatterSource(diagnostics.push({range: lineSpan(line),severity: 'warning',- source: 'frontmatter',- code: keyword,+ source,+ code: ruleId ?? keyword,message,frontmatterScope,...(frontmatterProperty === undefined ? {} : { frontmatterProperty }),diff --git a/packages/core/src/markdown/lint/index.ts b/packages/core/src/markdown/lint/index.tsindex af38c2ae2..9c2a0875e 100644--- a/packages/core/src/markdown/lint/index.ts+++ b/packages/core/src/markdown/lint/index.ts@@ -1,3 +1,4 @@+import { LINT_PLUGINS, type LinterConfig } from './plugins.ts';import type { LintDiagnostic } from './types.ts';@@ -11,7 +12,11 @@ export async function lintDocument(for (const plugin of LINT_PLUGINS) {const slice = config.plugins[plugin.id];if (!slice.enabled) continue;- diagnostics.push(...(await plugin.lint(text, slice as never, { docName })));+ try {+ diagnostics.push(...(await plugin.lint(text, slice as never, { docName })));+ } catch (err) {+ console.warn(`[lint] plugin "${plugin.id}" failed${docName ? ` on "${docName}"` : ''}`, err);+ }}return diagnostics;}@@ -22,7 +27,11 @@ export function fixDocument(text: string, config: LinterConfig): string {for (const plugin of LINT_PLUGINS) {const slice = config.plugins[plugin.id];if (!slice.enabled || !plugin.fix) continue;- out = plugin.fix(out, slice as never);+ try {+ out = plugin.fix(out, slice as never);+ } catch (err) {+ console.warn(`[lint] plugin "${plugin.id}" fix failed`, err);+ }}return out;}@@ -87,6 +96,33 @@ export {selectApplicableFrontmatterSchemas,} from './frontmatter-validate.ts';export { fixMarkdownText, runMarkdownlint } from './markdownlint-runner.ts';+export {+ OKF_SCHEMA_DIR,+ type OkfSchemaFile,+ okfSchemaPathFor,+ renderOkfSchemaFiles,+} from './okf-frontmatter/materialize.ts';+export {+ OKF_FRONTMATTER_REGISTRY,+ okfAdvertisedSchemaMappings,+ runOkfFrontmatterRules,+ selectOkfFrontmatterSchemas,+} from './okf-frontmatter/registry.ts';+export {+ OKF_PROJECT_REGISTRY,+ type OkfProjectFinding,+ runOkfProjectRules,+} from './okf-project/rules.ts';+export {+ assertNeverOkfRuleGroupId,+ assertNeverOkfRuleId,+ isOkfRuleEnabled,+ OKF_RULE_GROUPS,+ OKF_RULE_IDS,+ type OkfRuleGroupId,+ type OkfRuleId,+ type OkfRuleToggles,+} from './okf-rule-meta.ts';export {DEFAULT_LINTER_CONFIG,LINT_PLUGINS,@@ -120,6 +156,7 @@ export type {MarkdownlintRuleSeverity,MarkdownlintRuleWriteValue,MarkdownlintSlice,+ OkfSlice,ResolvedFrontmatterSchemaEntry,RuleCatalogEntry,RuleOptionSpec,diff --git a/packages/core/src/markdown/lint/okf-frontmatter/materialize.ts b/packages/core/src/markdown/lint/okf-frontmatter/materialize.tsnew file mode 100644index 000000000..f438f1b16--- /dev/null+++ b/packages/core/src/markdown/lint/okf-frontmatter/materialize.ts@@ -0,0 +1,27 @@++import type { OkfRuleId } from '../okf-rule-meta.ts';+import { fileNameFor, OKF_SCHEMA_DIR, okfSchemaPathFor } from './paths.ts';+import { OKF_FRONTMATTER_REGISTRY } from './registry.ts';++export { OKF_SCHEMA_DIR, okfSchemaPathFor };++const GENERATED_NOTE =+ 'Generated by the OpenKnowledge `okf` lint plugin — do not edit. The plugin validates ' ++ 'from its own compiled copy and never reads this file, so changes here have no effect ' ++ 'and are overwritten when the server restarts. This describes an external format ' ++ '(Google’s Open Knowledge Format); to change what is enforced, change the rule ' ++ 'toggles under Settings → this project → Plugins → OKF.';++export interface OkfSchemaFile {+ readonly path: string;+ readonly ruleId: OkfRuleId;+ readonly contents: string;+}++export function renderOkfSchemaFiles(): OkfSchemaFile[] {+ return OKF_FRONTMATTER_REGISTRY.map((entry) => ({+ path: `${OKF_SCHEMA_DIR}/${fileNameFor(entry.id)}`,+ ruleId: entry.id,+ contents: `${JSON.stringify({ $comment: GENERATED_NOTE, ...entry.schema }, null, 2)}\n`,+ }));+}diff --git a/packages/core/src/markdown/lint/okf-frontmatter/paths.ts b/packages/core/src/markdown/lint/okf-frontmatter/paths.tsnew file mode 100644index 000000000..c290b6878--- /dev/null+++ b/packages/core/src/markdown/lint/okf-frontmatter/paths.ts@@ -0,0 +1,12 @@++import type { OkfRuleId } from '../okf-rule-meta.ts';++export const OKF_SCHEMA_DIR = '.ok/okf';++export function fileNameFor(ruleId: OkfRuleId): string {+ return `${ruleId.replace(/^frontmatter-/, '')}.schema.json`;+}++export function okfSchemaPathFor(ruleId: OkfRuleId): string {+ return `${OKF_SCHEMA_DIR}/${fileNameFor(ruleId)}`;+}diff --git a/packages/core/src/markdown/lint/okf-frontmatter/registry.ts b/packages/core/src/markdown/lint/okf-frontmatter/registry.tsnew file mode 100644index 000000000..5168602d5--- /dev/null+++ b/packages/core/src/markdown/lint/okf-frontmatter/registry.ts@@ -0,0 +1,97 @@++import { compileAppliesTo } from '../applies-to.ts';+import { validateFrontmatterSource } from '../frontmatter-validate.ts';+import { isOkfRuleEnabled, type OkfRuleId, type OkfRuleToggles } from '../okf-rule-meta.ts';+import type { FrontmatterSchemaMapping, LintDiagnostic } from '../types.ts';+import { okfSchemaPathFor } from './paths.ts';+import {+ OKF_ATTESTED_COMPUTATION_SCHEMA,+ OKF_PROVENANCE_SCHEMA,+ OKF_RECOMMENDED_SCHEMA,+ OKF_REQUIRED_SCHEMA,+ OKF_RESERVED_INDEX_SCHEMA,+ OKF_ROOT_INDEX_SCHEMA,+} from './schemas.ts';++const CONCEPT_SCOPE = ['**', '!**/{index,log}'];++const RESERVED_INDEX_SCOPE = ['**/index', '!index'];++const ROOT_INDEX_SCOPE = ['index'];++export interface OkfFrontmatterEntry {+ readonly id: OkfRuleId;+ readonly appliesTo: readonly string[];+ readonly schema: Record<string, unknown>;+}++export const OKF_FRONTMATTER_REGISTRY: readonly OkfFrontmatterEntry[] = [+ {+ id: 'frontmatter-required',+ appliesTo: CONCEPT_SCOPE,+ schema: OKF_REQUIRED_SCHEMA,+ },+ {+ id: 'frontmatter-recommended',+ appliesTo: CONCEPT_SCOPE,+ schema: OKF_RECOMMENDED_SCHEMA,+ },+ {+ id: 'frontmatter-provenance',+ appliesTo: CONCEPT_SCOPE,+ schema: OKF_PROVENANCE_SCHEMA,+ },+ {+ id: 'frontmatter-computation',+ appliesTo: CONCEPT_SCOPE,+ schema: OKF_ATTESTED_COMPUTATION_SCHEMA,+ },+ {+ id: 'frontmatter-reserved-index',+ appliesTo: RESERVED_INDEX_SCOPE,+ schema: OKF_RESERVED_INDEX_SCHEMA,+ },+ {+ id: 'frontmatter-root-index',+ appliesTo: ROOT_INDEX_SCOPE,+ schema: OKF_ROOT_INDEX_SCHEMA,+ },+];++export function selectOkfFrontmatterSchemas(+ rules: OkfRuleToggles,+ docName: string | undefined,+): OkfFrontmatterEntry[] {+ if (docName === undefined) return [];+ return OKF_FRONTMATTER_REGISTRY.filter(+ (entry) =>+ isOkfRuleEnabled(rules, entry.id) && compileAppliesTo([...entry.appliesTo]).matches(docName),+ );+}++export function okfAdvertisedSchemaMappings(rules: OkfRuleToggles): FrontmatterSchemaMapping[] {+ return OKF_FRONTMATTER_REGISTRY.filter((entry) => isOkfRuleEnabled(rules, entry.id)).map(+ (entry) => ({+ appliesTo: [...entry.appliesTo],+ file: okfSchemaPathFor(entry.id),+ }),+ );+}++export function runOkfFrontmatterRules(+ text: string,+ rules: OkfRuleToggles,+ docName: string | undefined,+): LintDiagnostic[] {+ const selected = selectOkfFrontmatterSchemas(rules, docName);+ if (selected.length === 0) return [];+ return validateFrontmatterSource(+ text,+ selected.map((entry) => ({+ file: okfSchemaPathFor(entry.id),+ schema: entry.schema,+ ruleId: entry.id,+ })),+ { source: 'okf' },+ );+}diff --git a/packages/core/src/markdown/lint/okf-frontmatter/schemas.ts b/packages/core/src/markdown/lint/okf-frontmatter/schemas.tsnew file mode 100644index 000000000..89845d3d5--- /dev/null+++ b/packages/core/src/markdown/lint/okf-frontmatter/schemas.ts@@ -0,0 +1,336 @@++// file-level form is deliberate: the sibling `biome-ignore` must sit on the line+// oxlint-disable unicorn/no-thenable++export const OKF_REQUIRED_SCHEMA: Record<string, unknown> = {+ $schema: 'http://json-schema.org/draft-07/schema#',+ title: 'OKF v0.2 — required frontmatter',+ description:+ 'The OKF v0.2 conformance floor. A bundle is conformant when every non-reserved .md file contains a parseable YAML frontmatter block whose `type` is non-empty. This schema is the whole of that floor: a concept carrying only `type` is fully conformant. Section numbers cite OKF v0.2: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md#11-conformance',+ type: 'object',+ required: ['type'],+ properties: {+ type: {+ type: 'string',+ pattern: '\\S',+ description:+ 'REQUIRED, and the only always-required key in OKF. A short string identifying the kind of concept; consumers use it for routing, filtering, and presentation. Type values are not registered centrally — pick something descriptive and self-explanatory (`BigQuery Table`, `BigQuery Dataset`, `API Endpoint`, `Metric`, `Playbook`, `Reference`, `Attested Computation`). Consumers must tolerate unknown types, typically by treating them as generic concepts. The `\\S` pattern is what makes §11 rule 2 mean what it says, and it replaces a `minLength` rather than joining one: a length check alone accepts a whitespace-only value that no consumer can route on, and having both would report one mistake twice. OKF v0.2 §4.1, §11.',+ },+ },+};++export const OKF_RECOMMENDED_SCHEMA: Record<string, unknown> = {+ $schema: 'http://json-schema.org/draft-07/schema#',+ title: 'OKF v0.2 — recommended frontmatter',+ description:+ 'Shapes for the OKF v0.2 recommended keys. Every key here is optional, and nothing is constrained beyond the shape OKF states: declaring a key pins its YAML type when present (so `tags` written as a comma-separated string warns) and advertises it to agents at read time. Section numbers cite OKF v0.2: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md#41-frontmatter',+ type: 'object',+ properties: {+ title: {+ type: 'string',+ description:+ 'Human-readable display name. If omitted, consumers MAY derive a title from the filename. OKF v0.2 §4.1.',+ },+ description: {+ type: 'string',+ description:+ 'A single sentence summarizing the concept. Used by `index.md` generators, search snippets, and previews. OKF v0.2 §4.1.',+ },+ resource: {+ type: 'string',+ format: 'uri-reference',+ description:+ 'A URI that uniquely identifies the underlying asset the concept describes. Absent for concepts that describe abstract ideas rather than physical resources. Path-valued: an absolute URL, a bundle-relative path beginning with `/`, or an ordinary relative path — hence `uri-reference`, not `uri`, which would reject `/tables/customers.md`. OKF v0.2 §4.1, §6.2.',+ },+ tags: {+ type: 'array',+ items: {+ type: 'string',+ },+ description:+ 'A YAML list of short strings for cross-cutting categorization. Tags stay a first-class concept through this field; OKF specifies no separate per-tag file format, so a consumer that wants a tag-browsing view synthesizes one by scanning frontmatter. OKF v0.2 §3.1, §4.1.',+ },+ timestamp: {+ description:+ 'LEGACY (OKF v0.1), superseded by `generated.at` in v0.2 — one of the two deliberate breaking changes. Consumers MAY fall back to it when `generated` is absent; new documents SHOULD write `generated: { by, at }` instead. Documented here so agents are told what it is and what replaced it, but deliberately left unconstrained: v0.2 does not define it as a producer field, so validating its shape would be a rule OKF no longer has. OKF v0.2 §5.2, §13.1.',+ },+ },+};++export const OKF_PROVENANCE_SCHEMA: Record<string, unknown> = {+ $schema: 'http://json-schema.org/draft-07/schema#',+ title: 'OKF v0.2 — provenance, trust, and lifecycle frontmatter',+ description:+ 'The optional OKF v0.2 families that make "where did this come from", "how much should I trust it", and "is it still current" answerable from frontmatter alone. Every key is optional, and absence carries meaning rather than being an error: a concept with no `verified` is unverified, and a consumer must not reject it. Only `sources[].resource` and `generated.by` are required-when-their-parent-is-present, because those are the two fields OKF marks REQUIRED in this family; every other field is described but not mandated, so nothing else is enforced. Section numbers cite OKF v0.2: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md#5-provenance-trust-and-lifecycle',+ type: 'object',+ properties: {+ sources: {+ type: 'array',+ description:+ "The materials this concept derives from, external or internal to the bundle. Lineage is expressed through links rather than a dedicated field: when an entry's `resource` points at another OKF concept, the derivation edge already exists in the bundle graph, so a consumer may recurse into that source's own `sources`. OKF v0.2 §5.1.",+ items: {+ type: 'object',+ required: ['resource'],+ properties: {+ resource: {+ type: 'string',+ description:+ 'REQUIRED within an entry. Either a concrete artifact a consumer can follow (an absolute URL, a bundle-relative path, or a path into a `references/` subdirectory) or a population or scope descriptor it cannot, for example `all queries in BigQuery project X`. Deliberately NOT format-constrained: a scope descriptor is prose, so a `uri-reference` check here would warn on conformant documents. OKF v0.2 §5.1, §6.2, §6.3.',+ },+ id: {+ type: 'string',+ description:+ 'Optional. A stable key used to attribute individual claims: a markdown footnote whose label is this id (`[^ga4-schema]`) attributes the claim it follows. SHOULD be present when the body cites the source. Keyed rather than positional because agents constantly rewrite these documents — a positional index misattributes silently the moment the list is reordered. OKF v0.2 §5.1.',+ },+ title: {+ type: 'string',+ description: 'Optional. Human-readable label for the source. OKF v0.2 §5.1.',+ },+ author: {+ type: 'string',+ description:+ 'Optional credibility signal — an authority signal: who or what produced the source. OKF describes this as following the actor convention (§7), but its own examples use a `team:<id>` prefix that the three §7 forms do not cover, so no pattern is enforced. OKF v0.2 §5.1, §7.',+ },+ usage_count: {+ type: 'integer',+ description:+ "Optional credibility signal — an adoption and liveness signal: how often `resource` was exercised (dashboard views, query executions, page reads) over `usage_window`. For a single artifact it is that artifact's own exercise count; for a scope descriptor it is the number of exercises within the scope that touch the concept. Coarse by design: comparable at the alive-versus-dead and order-of-magnitude level and against a source's own history, but not a precise cross-kind ranking. Read as liveness and trend, not as a score. OKF v0.2 §5.1.",+ },+ last_modified: {+ type: 'string',+ format: 'date',+ description:+ 'Optional credibility signal — a recency signal: when the source itself last changed, as `YYYY-MM-DD`. Distinct from `generated.at`, which records when the concept was written. OKF v0.2 §5.1.',+ },+ usage_window: {+ type: 'object',+ description:+ 'Optional per-entry override of the `usage_window` written as a sibling of `sources`. OKF v0.2 §5.1.',+ properties: {+ from: {+ type: 'string',+ format: 'date',+ description:+ "Start of the window framing this entry's `usage_count`, as `YYYY-MM-DD`. OKF v0.2 §5.1.",+ },+ to: {+ type: 'string',+ format: 'date',+ description:+ "End of the window framing this entry's `usage_count`, as `YYYY-MM-DD`. OKF v0.2 §5.1.",+ },+ },+ },+ },+ },+ },+ usage_window: {+ type: 'object',+ description:+ 'Written once as a sibling of `sources`, this frames every `usage_count` in the list with a `{ from, to }` date range. A single entry may carry its own `usage_window` to override it. OKF v0.2 §5.1.',+ properties: {+ from: {+ type: 'string',+ format: 'date',+ description: 'Start of the shared usage window, as `YYYY-MM-DD`. OKF v0.2 §5.1.',+ },+ to: {+ type: 'string',+ format: 'date',+ description: 'End of the shared usage window, as `YYYY-MM-DD`. OKF v0.2 §5.1.',+ },+ },+ },+ generated: {+ type: 'object',+ required: ['by'],+ description:+ 'How the current content was produced. Kept distinct from `verified` because who wrote a concept need not be who confirmed it. OKF v0.2 §5.2.',+ properties: {+ by: {+ type: 'string',+ description:+ 'REQUIRED within `generated`. An actor in the OKF convention: `<producer>/<version>` for agents and tools (`reference_agent/gemini-2.5-pro`), `human:<id>` for a person (`human:ahormati`), or `process:<id>` for an automated process (`process:finance-nightly`). Consumers that classify trust key off the `human:` prefix, so producers MUST use it for hand-authored or human-confirmed content — a rule about which form to pick for which content, which frontmatter alone cannot check, so the three forms are documented here rather than enforced by a pattern. OKF v0.2 §5.2, §7.',+ },+ at: {+ type: 'string',+ format: 'date-time',+ description:+ "An ISO 8601 datetime marking the content's last meaningful change. Consumers use it to tell a recent edit from a stale fact. Supersedes v0.1's top-level `timestamp`. OKF v0.2 §5.2, §13.1.",+ },+ },+ },+ verified: {+ description:+ 'Who or what has confirmed the content against its sources or `resource` — a list of verification events. Multiple entries capture independent checks, for example a human sign-off plus a nightly process; "how recently" is the latest `at`. Independent of `generated.at`: content can change without re-confirmation, and facts can be re-confirmed without regeneration. A single verifier MAY be written as one bare `{ by, at }` mapping without the list dash, and consumers MUST treat that as a one-element list — hence the two accepted shapes here. Absence means unverified, which is a valid state, never a rejection. OKF v0.2 §5.2, §5.3, §11.',+ anyOf: [+ {+ type: 'object',+ description: 'The bare single-verifier mapping form. OKF v0.2 §5.2.',+ properties: {+ by: {+ type: 'string',+ description:+ 'The verifying actor: `<producer>/<version>`, `human:<id>`, or `process:<id>`. A `human:` verifier is what raises the trust tier to human-reviewed; non-human verifiers alone yield machine-confirmed. OKF v0.2 §5.2, §5.3, §7.',+ },+ at: {+ type: 'string',+ format: 'date-time',+ description: 'ISO 8601 datetime of the verification event. OKF v0.2 §5.2.',+ },+ },+ },+ {+ type: 'array',+ description:+ 'The list form: one entry per independent verification event. OKF v0.2 §5.2.',+ items: {+ type: 'object',+ properties: {+ by: {+ type: 'string',+ description:+ 'The verifying actor: `<producer>/<version>`, `human:<id>`, or `process:<id>`. A `human:` verifier is what raises the trust tier to human-reviewed; non-human verifiers alone yield machine-confirmed. OKF v0.2 §5.2, §5.3, §7.',+ },+ at: {+ type: 'string',+ format: 'date-time',+ description: 'ISO 8601 datetime of the verification event. OKF v0.2 §5.2.',+ },+ },+ },+ },+ ],+ },+ status: {+ enum: ['draft', 'stable', 'deprecated'],+ description:+ "Lifecycle state. `draft` = not yet reviewed, possibly incomplete. `stable` = ready for consumption. `deprecated` = kept for links and history, no longer current. Absent means `stable`, so the key is only worth writing to say draft or deprecated. These three values are the whole set OKF defines, which is why this is the pack's only enum. OKF v0.2 §5.4.",+ },+ stale_after: {+ type: 'string',+ format: 'date',+ description:+ 'An absolute date, `YYYY-MM-DD`: the concept is stale when `today >= stale_after`. Absolute rather than a relative TTL so staleness stays a plain date comparison with no reference to when the concept was read. A date in the past is a freshness signal for consumers, not a violation. OKF v0.2 §5.5, §10.5.',+ },+ },+};++export const OKF_ATTESTED_COMPUTATION_SCHEMA: Record<string, unknown> = {+ $schema: 'http://json-schema.org/draft-07/schema#',+ title: 'OKF v0.2 — Attested Computation frontmatter',+ description:+ 'Shapes for the OKF v0.2 computation keys, which turn a concept into a sanctioned way to compute a value so a consumer can confirm the agent ran the blessed computation instead of improvising its own. Provenance answers "where did this claim come from"; attestation answers "was this number produced the way we said it must be". This file also carries the one value-shaped rule in the pack: `runtime` is the single key OKF marks REQUIRED here, and only when `type` is `Attested Computation`. Ordinary concepts never match that condition and are unaffected, and no other key in the family is mandated. OKF records the computation and the means to check it and executes nothing itself; receipts and verdicts are runtime artifacts that are never stored in the bundle. Section numbers cite OKF v0.2: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md#10-attested-computations-concept',+ type: 'object',+ if: {+ required: ['type'],+ properties: {+ type: {+ const: 'Attested Computation',+ description:+ 'The condition, not a constraint: everything in `then` applies only to documents whose `type` is exactly `Attested Computation`. An ordinary concept never matches, so nothing in this schema is ever asked of it. `type` is also required inside the condition so a document with no type at all fails the conformance floor once, rather than also being told it is missing a `runtime` for a type it never claimed.',+ },+ },+ },+ // biome-ignore lint/suspicious/noThenProperty: JSON Schema conditional, not a thenable+ then: {+ required: ['runtime'],+ },+ properties: {+ runtime: {+ type: 'string',+ description:+ 'REQUIRED for `type: Attested Computation`. The single field that says how to run the computation, and therefore how the executor and attester interpret it and what `parameters` mean — a parameter is a SQL bind variable, a dbt var, or a Python argument depending on the runtime. Keeping `runtime` and `parameters` in one frontmatter is what makes the binding semantics self-evident. Example values: `bigquery`, `postgres`, `dbt`, `python`, `Looker`. Not a closed set, so no enum. OKF v0.2 §10.1, §10.2.',+ },+ parameters: {+ type: 'array',+ description:+ 'The typed, named holes the agent may fill. An agent MAY only supply values for these parameters; it MUST NOT author or edit the computation. That parameter-only surface is what makes "did the sanctioned thing run" a mechanical comparison rather than a judgement call. OKF v0.2 §10.2, §10.3.',+ items: {+ type: 'object',+ properties: {+ name: {+ type: 'string',+ description:+ "The parameter name the computation binds, for example `year` bound as `@year` in BigQuery SQL or `{{ var('year') }}` in dbt. OKF v0.2 §10.2, §10.3.",+ },+ type: {+ type: 'string',+ description:+ "The parameter's type, interpreted by `runtime` (`integer`, `string`, and so on). Deliberately not constrained to JSON Schema type names, because the vocabulary belongs to the runtime. OKF v0.2 §10.2.",+ },+ required: {+ type: 'boolean',+ description:+ 'Whether the agent must supply a value for this parameter. OKF v0.2 §10.2.',+ },+ },+ },+ },+ computation: {+ type: 'string',+ format: 'uri-reference',+ description:+ "Optional. A path to a file holding the computation, used instead of an inline body fence — best for a long or generated computation, or one already kept as a real file shared with non-OKF tooling. When absent, the body's `# Computation` fence IS the computation. Path-valued: an absolute URL, a bundle-relative path beginning with `/`, or a relative path. OKF v0.2 §6.2, §10.2, §10.3.",+ },+ executor: {+ type: 'object',+ description:+ "How the computation is run. A runner — an agent, or deterministic consumer code — follows `resource`, and the run returns a receipt shaped by `receipt`. Binding the computation with the parameter values into the executable artifact is the consumer's job. OKF v0.2 §10.2, §10.5.",+ properties: {+ resource: {+ type: 'string',+ format: 'uri-reference',+ description:+ 'Names the run instructions or code. What sits behind it — a Skill, a script, a container — is a packaging choice; OKF fixes the interface, not the packaging. Conventionally points into a `references/` subdirectory, for example `references/skills/run-on-bq.md`. OKF v0.2 §1, §6.2, §6.3, §10.2.',+ },+ receipt: {+ type: 'array',+ items: {+ type: 'string',+ },+ description:+ 'Declares the fields a run must return — the evidence the attester inspects, for example `[job_id, executed_sql, result]` for BigQuery or `[run_id, compiled_sql, result]` for dbt. Because the attester compares the expanded, compiled artifact the receipt carries, a rewritten query, a swapped computation file, or a mutated dependency fails the check. The receipt itself is a runtime artifact and is never stored in the bundle. OKF v0.2 §10.2, §10.3, §10.5.',+ },+ },+ },+ attester: {+ type: 'object',+ description:+ 'The deterministic check that inspects a receipt and returns a verdict. Meant to run consumer-side. Distinct from `verified`: `verified` confirms the definition still matches policy and is recorded in the bundle, while attestation confirms a single run produced the value the sanctioned way and is not stored. OKF v0.2 §10.2, §10.6.',+ properties: {+ resource: {+ type: 'string',+ format: 'uri-reference',+ description:+ 'Names code — no LLM — that takes a receipt and returns a verdict, independently re-deriving the binding of `computation` with the claimed parameter values to compare against what actually ran. Conventionally points into a `references/` subdirectory, for example `references/attesters/sql-equality.py`. OKF v0.2 §6.2, §6.3, §10.2, §10.3.',+ },+ },+ },+ },+};++export const OKF_RESERVED_INDEX_SCHEMA: Record<string, unknown> = {+ $schema: 'http://json-schema.org/draft-07/schema#',+ title: 'OKF v0.2 — index files carry no frontmatter',+ description:+ "`index.md` is a reserved filename at any level of the hierarchy and must not be used for a concept document. Index files contain no frontmatter, with exactly one exception — a bundle-root `index.md` may carry `okf_version` — which the scope carves out with a `!index` exclusion rather than a keyword here. `maxProperties: 0` is the mechanism rather than the boolean schema `false`, because a document with no frontmatter block validates as `{}` and `false` would reject that too, flagging the very documents that are correct. `log.md` is deliberately NOT covered: §9 constrains a log's date headings, ordering, and prose entries but never its frontmatter, and OKF's own reference bundle ships a `log.md` carrying `type` and `title`. Section numbers cite OKF v0.2: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md#8-index-files",+ type: 'object',+ maxProperties: 0,+};++export const OKF_ROOT_INDEX_SCHEMA: Record<string, unknown> = {+ $schema: 'http://json-schema.org/draft-07/schema#',+ title: 'OKF v0.2 — bundle-root index.md',+ description:+ "The bundle-root `index.md` is the only index file OKF permits frontmatter in, and `okf_version` is the key it names there. OKF states the declaration as a MAY, so it is not required here. Nor is the frontmatter closed to other keys: §8 grants the exception for `okf_version` specifically, but §11 tells consumers not to reject a bundle over unknown additional keys, and that ambiguity is resolved in favor of the looser reading. The one thing pinned is the value's shape, because a YAML float is provably lossy where a version string is not. Section numbers cite OKF v0.2: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md#12-versioning",+ type: 'object',+ properties: {+ okf_version: {+ type: 'string',+ pattern: '^[0-9]+\\.[0-9]+$',+ description:+ 'The OKF version this bundle targets, as `<major>.<minor>` — currently `"0.2"`. Quote it: unquoted `0.2` parses as a YAML number, so a consumer comparing version strings sees a float instead, and `0.10` would silently become `0.1`. A minor bump is backward-compatible additions; a major bump may rename required fields or change reserved filenames. Consumers that do not understand the declared version should attempt best-effort consumption rather than refusing the bundle. OKF v0.2 §12.',+ },+ },+};diff --git a/packages/core/src/markdown/lint/okf-project/rules.ts b/packages/core/src/markdown/lint/okf-project/rules.tsnew file mode 100644index 000000000..8b476332e--- /dev/null+++ b/packages/core/src/markdown/lint/okf-project/rules.ts@@ -0,0 +1,60 @@++import { SUPPORTED_DOC_EXTENSIONS } from '../../../constants/doc-extensions.ts';+import { isOkfRuleEnabled, type OkfRuleId, type OkfRuleToggles } from '../okf-rule-meta.ts';++export interface OkfProjectFinding {+ readonly file: string;+ readonly code: OkfRuleId;+ readonly message: string;+}++function splitName(path: string): { stem: string; ext: string } {+ const base = path.slice(path.lastIndexOf('/') + 1);+ const dot = base.lastIndexOf('.');+ if (dot <= 0) return { stem: base, ext: '' };+ return { stem: base.slice(0, dot), ext: base.slice(dot) };+}++function noMdx(paths: readonly string[]): OkfProjectFinding[] {+ const mdStems = new Set(+ paths+ .filter((path) => splitName(path).ext.toLowerCase() === '.md')+ .map((path) => path.slice(0, path.lastIndexOf('.'))),+ );+ const findings: OkfProjectFinding[] = [];+ for (const path of paths) {+ if (splitName(path).ext.toLowerCase() !== '.mdx') continue;+ const stem = path.slice(0, path.lastIndexOf('.'));+ const lead = `"${path}" won't be picked up by an Open Knowledge Format consumer — the format is .md-only, and nothing scanning for .md files will open an .mdx.`;+ findings.push({+ file: path,+ code: 'project-no-mdx',+ message: mdStems.has(stem)+ ? `${lead} It is also shadowed by "${stem}.md", so a consumer reads that file instead and gets different content than this project shows you.`+ : lead,+ });+ }+ return findings;+}++export interface OkfProjectRule {+ readonly id: OkfRuleId;+ readonly run: (paths: readonly string[]) => OkfProjectFinding[];+}++export const OKF_PROJECT_REGISTRY: readonly OkfProjectRule[] = [+ { id: 'project-no-mdx', run: noMdx },+];++export function runOkfProjectRules(+ paths: readonly string[],+ rules: OkfRuleToggles,+): OkfProjectFinding[] {+ const docs = paths.filter((path) =>+ SUPPORTED_DOC_EXTENSIONS.some((ext) => path.toLowerCase().endsWith(ext)),+ );+ if (docs.length === 0) return [];+ return OKF_PROJECT_REGISTRY.filter((rule) => isOkfRuleEnabled(rules, rule.id)).flatMap((rule) =>+ rule.run(docs),+ );+}diff --git a/packages/core/src/markdown/lint/okf-rule-meta.ts b/packages/core/src/markdown/lint/okf-rule-meta.tsnew file mode 100644index 000000000..44913a9dc--- /dev/null+++ b/packages/core/src/markdown/lint/okf-rule-meta.ts@@ -0,0 +1,51 @@++export const OKF_RULE_IDS = [+ 'no-wiki-links',+ 'log-shape',+ 'index-shape',+ 'reserved-casing',+ 'frontmatter-required',+ 'frontmatter-recommended',+ 'frontmatter-provenance',+ 'frontmatter-computation',+ 'frontmatter-reserved-index',+ 'frontmatter-root-index',+ 'project-no-mdx',+] as const;++export type OkfRuleId = (typeof OKF_RULE_IDS)[number];++export type OkfRuleToggles = Partial<Record<OkfRuleId, boolean>> | undefined;++export function isOkfRuleEnabled(rules: OkfRuleToggles, id: OkfRuleId): boolean {+ return rules?.[id] !== false;+}++export const OKF_RULE_GROUPS = [+ { id: 'structure', ids: ['no-wiki-links', 'log-shape', 'index-shape', 'reserved-casing'] },+ {+ id: 'frontmatter',+ ids: [+ 'frontmatter-required',+ 'frontmatter-recommended',+ 'frontmatter-provenance',+ 'frontmatter-computation',+ 'frontmatter-reserved-index',+ 'frontmatter-root-index',+ ],+ },+ {+ id: 'project',+ ids: ['project-no-mdx'],+ },+] as const satisfies readonly { id: string; ids: readonly OkfRuleId[] }[];++export type OkfRuleGroupId = (typeof OKF_RULE_GROUPS)[number]['id'];++export function assertNeverOkfRuleId(value: never): never {+ throw new Error(`Unhandled OkfRuleId variant: ${JSON.stringify(value as unknown)}`);+}++export function assertNeverOkfRuleGroupId(value: never): never {+ throw new Error(`Unhandled OkfRuleGroupId variant: ${JSON.stringify(value as unknown)}`);+}diff --git a/packages/core/src/markdown/lint/okf-rules.ts b/packages/core/src/markdown/lint/okf-rules.tsnew file mode 100644index 000000000..d0999b62e--- /dev/null+++ b/packages/core/src/markdown/lint/okf-rules.ts@@ -0,0 +1,28 @@++import { isOkfRuleEnabled, type OkfRuleId, type OkfRuleToggles } from './okf-rule-meta.ts';+import type { OkfRule } from './okf-runner.ts';+import { indexShape } from './rules/index-shape.ts';+import { logShape } from './rules/log-shape.ts';+import { noWikiLinks } from './rules/no-wiki-links.ts';+import { reservedCasing } from './rules/reserved-casing.ts';++interface OkfRuleEntry {+ readonly id: OkfRuleId;+ readonly rule: OkfRule;+}++export const OKF_RULE_REGISTRY: readonly OkfRuleEntry[] = [+ { id: 'no-wiki-links', rule: noWikiLinks },+ { id: 'log-shape', rule: logShape },+ { id: 'index-shape', rule: indexShape },+ { id: 'reserved-casing', rule: reservedCasing },+];++const ALL_OKF_RULES: readonly OkfRule[] = OKF_RULE_REGISTRY.map((entry) => entry.rule);++export function selectEnabledOkfRules(rules: OkfRuleToggles): readonly OkfRule[] {+ if (rules === undefined) return ALL_OKF_RULES;+ return OKF_RULE_REGISTRY.filter((entry) => isOkfRuleEnabled(rules, entry.id)).map(+ (entry) => entry.rule,+ );+}diff --git a/packages/core/src/markdown/lint/okf-runner.ts b/packages/core/src/markdown/lint/okf-runner.tsnew file mode 100644index 000000000..fabb08d6e--- /dev/null+++ b/packages/core/src/markdown/lint/okf-runner.ts@@ -0,0 +1,79 @@++import type { Root } from 'mdast';+import remarkFrontmatter from 'remark-frontmatter';+import remarkGfm from 'remark-gfm';+import remarkParse from 'remark-parse';+import { unified } from 'unified';+import { lintRule } from 'unified-lint-rule';+import type { Point, Position } from 'unist';+import { VFile } from 'vfile';+import type { VFileMessage } from 'vfile-message';+import { compileAppliesTo } from './applies-to.ts';+import type { LintDiagnostic, LintPosition, LintRange } from './types.ts';++declare module 'vfile' {+ interface VFileDataMap {+ okfDocName?: string;+ }+}++type OkfRuleFn = (tree: Root, file: VFile) => void;++export function defineOkfRule(id: string, rule: OkfRuleFn) {+ return lintRule(`okf:${id}`, (tree, file) => {+ try {+ rule(tree as Root, file);+ } catch (err) {+ console.warn(+ `[lint] OKF rule "${id}" failed${file.data.okfDocName ? ` on "${file.data.okfDocName}"` : ''}`,+ err,+ );+ }+ });+}++export function defineScopedOkfRule(id: string, appliesTo: string, rule: OkfRuleFn) {+ const scope = compileAppliesTo(appliesTo);+ return defineOkfRule(id, (tree, file) => {+ if (scope.matches(file.data.okfDocName)) rule(tree, file);+ });+}++export type OkfRule = ReturnType<typeof defineOkfRule>;++const point = (p: Point): LintPosition => ({ line: p.line - 1, character: p.column - 1 });++function rangeOf(place: Point | Position | null | undefined, lines: readonly string[]): LintRange {+ if (place && 'start' in place) return { start: point(place.start), end: point(place.end) };+ if (place) {+ const start = point(place);+ return { start, end: { line: start.line, character: lines[start.line]?.length ?? 0 } };+ }+ return { start: { line: 0, character: 0 }, end: { line: 0, character: lines[0]?.length ?? 0 } };+}++function toDiagnostic(message: VFileMessage, lines: readonly string[]): LintDiagnostic {+ return {+ range: rangeOf(message.place, lines),+ severity: 'warning',+ source: 'okf',+ code: message.ruleId ?? 'okf',+ message: message.reason,+ };+}++export function runOkfRules(+ text: string,+ rules: readonly OkfRule[],+ docName?: string,+): LintDiagnostic[] {+ if (rules.length === 0) return [];+ const processor = unified().use(remarkParse).use(remarkGfm).use(remarkFrontmatter, ['yaml']);+ for (const rule of rules) processor.use(rule);+ const file = new VFile({ value: text });+ if (docName !== undefined) file.data.okfDocName = docName;+ const tree = processor.parse(file);+ processor.runSync(tree, file);+ const lines = text.split('\n');+ return file.messages.map((message) => toDiagnostic(message, lines));+}diff --git a/packages/core/src/markdown/lint/plugins.ts b/packages/core/src/markdown/lint/plugins.tsindex 5e832aa19..03efcf66c 100644--- a/packages/core/src/markdown/lint/plugins.ts+++ b/packages/core/src/markdown/lint/plugins.ts@@ -1,3 +1,4 @@+import { z } from 'zod';import { DEFAULT_MARKDOWNLINT_CONFIG, resolveMarkdownlintConfig } from './default-config.ts';import {@@ -5,14 +6,19 @@ import {validateFrontmatterSource,} from './frontmatter-validate.ts';import { fixMarkdownText, runMarkdownlint } from './markdownlint-runner.ts';+import { runOkfFrontmatterRules } from './okf-frontmatter/registry.ts';+import { selectEnabledOkfRules } from './okf-rules.ts';+import { runOkfRules } from './okf-runner.ts';import {type FrontmatterSlice,type LintDiagnostic,type LintPluginId,MARKDOWNLINT_RULE_SEVERITIES,type MarkdownlintSlice,+ type OkfSlice,} from './types.ts';+const MarkdownlintRuleSettingSchema = z.union([z.boolean(),z.enum(MARKDOWNLINT_RULE_SEVERITIES),@@ -65,7 +71,23 @@ const frontmatterPlugin: LintPlugin<'frontmatter', FrontmatterSlice> = {},};-export const LINT_PLUGINS = [markdownlintPlugin, frontmatterPlugin] as const;+const okfPlugin: LintPlugin<'okf', OkfSlice> = {+ id: 'okf',+ sliceSchema: z.object({+ enabled: z.boolean(),+ rules: z.record(z.string(), z.boolean()).optional(),+ generate: z.object({ index: z.boolean().optional() }).optional(),+ }),+ defaultSlice: { enabled: false },+ async lint(text, slice, ctx) {+ return [+ ...runOkfRules(text, selectEnabledOkfRules(slice.rules), ctx.docName),+ ...runOkfFrontmatterRules(text, slice.rules, ctx.docName),+ ];+ },+};++export const LINT_PLUGINS = [markdownlintPlugin, frontmatterPlugin, okfPlugin] as const;type LintPluginEntry = (typeof LINT_PLUGINS)[number];diff --git a/packages/core/src/markdown/lint/rules/index-shape.ts b/packages/core/src/markdown/lint/rules/index-shape.tsnew file mode 100644index 000000000..fcbb1b56c--- /dev/null+++ b/packages/core/src/markdown/lint/rules/index-shape.ts@@ -0,0 +1,40 @@++import type { List, ListItem } from 'mdast';+import { EXIT, visit } from 'unist-util-visit';+import { defineScopedOkfRule } from '../okf-runner.ts';++const INDEX_SCOPE = '**/index';++function hasLink(item: ListItem): boolean {+ let found = false;+ visit(item, ['link', 'linkReference'], () => {+ found = true;+ return EXIT;+ });+ return found;+}++export const indexShape = defineScopedOkfRule('index-shape', INDEX_SCOPE, (tree, file) => {+ let sectionOpen = false;+ for (const node of tree.children) {+ if (node.type === 'heading') {+ sectionOpen = true;+ continue;+ }+ if (node.type === 'list' && !sectionOpen) {+ file.message(+ 'This index list is not under a section heading, so an Open Knowledge Format consumer reading the file as navigation has no name to file its entries under — an index is one or more heading-led sections of bulleted links.',+ node as List,+ );+ }+ }++ visit(tree, 'listItem', (node: ListItem) => {+ if (node.children.some((child) => child.type === 'list')) return;+ if (hasLink(node)) return;+ file.message(+ "This index entry has no link, so an Open Knowledge Format consumer reading the file as navigation has nowhere to follow it. Every entry in the format's own reference bundles is a link followed by a short description.",+ node,+ );+ });+});diff --git a/packages/core/src/markdown/lint/rules/log-shape.ts b/packages/core/src/markdown/lint/rules/log-shape.tsnew file mode 100644index 000000000..431e4e9c8--- /dev/null+++ b/packages/core/src/markdown/lint/rules/log-shape.ts@@ -0,0 +1,60 @@++import type { Heading } from 'mdast';+import { toString as headingText } from 'mdast-util-to-string';+import { visit } from 'unist-util-visit';+import { defineScopedOkfRule } from '../okf-runner.ts';++const LOG_SCOPE = '**/log';++const ISO_DATE_PREFIX = /^\s*(\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])(?!\d)/;++function isRealCalendarDate(year: number, month: number, day: number): boolean {+ const date = new Date(Date.UTC(year, month - 1, day));+ return (+ date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day+ );+}++const DATE_INTENT = /^\s*\d{4}[-/.]\d{1,2}[-/.]\d{1,2}/;++function quote(text: string): string {+ const trimmed = text.trim();+ return trimmed.length > 60 ? `${trimmed.slice(0, 59)}…` : trimmed;+}++export const logShape = defineScopedOkfRule('log-shape', LOG_SCOPE, (tree, file) => {+ let previousDate: string | undefined;++ visit(tree, 'heading', (node: Heading) => {+ if (node.depth !== 2) return;+ const text = headingText(node);++ const iso = ISO_DATE_PREFIX.exec(text);+ if (!iso) {+ file.message(+ DATE_INTENT.test(text)+ ? `Log date heading "${quote(text)}" is not in ISO 8601 YYYY-MM-DD form, the one form an Open Knowledge Format log requires of its date headings.`+ : `Log entry heading "${quote(text)}" is not a date, so it falls outside the dated-entry format an Open Knowledge Format consumer reads a log as — nothing under it reaches the change-history timeline.`,+ node,+ );+ return;+ }++ const date = `${iso[1]}-${iso[2]}-${iso[3]}`;+ if (!isRealCalendarDate(Number(iso[1]), Number(iso[2]), Number(iso[3]))) {+ file.message(+ `Log date heading "${date}" is not a real calendar date, so it is not ISO 8601 — the one form an Open Knowledge Format log requires of its date headings.`,+ node,+ );+ return;+ }++ if (previousDate !== undefined && date > previousDate) {+ file.message(+ `Log date heading "${date}" is newer than the entry above it — an Open Knowledge Format log is a flat list of date-grouped entries, newest first.`,+ node,+ );+ }+ previousDate = date;+ });+});diff --git a/packages/core/src/markdown/lint/rules/no-wiki-links.ts b/packages/core/src/markdown/lint/rules/no-wiki-links.tsnew file mode 100644index 000000000..f75a04d15--- /dev/null+++ b/packages/core/src/markdown/lint/rules/no-wiki-links.ts@@ -0,0 +1,46 @@++import type { Point } from 'unist';+import { visit } from 'unist-util-visit';+import { defineOkfRule } from '../okf-runner.ts';++const WIKI_LINK = /\[\[[^[\]\n]+\]\]/g;++function describe(matched: string): string {+ const base = `Wiki-link ${matched} won't resolve for an external Open Knowledge Format consumer — it renders as literal text and its graph edge is lost.`;+ return matched.includes('|') ? `${base} The alias "|" also splits a GFM table cell.` : base;+}++export const noWikiLinks = defineOkfRule('no-wiki-links', (tree, file) => {+ const source = typeof file.value === 'string' ? file.value : String(file.value);+ visit(tree, 'text', (node) => {+ const start = node.position?.start;+ const end = node.position?.end;+ const base = start?.offset;+ const scanned =+ base === undefined || end?.offset === undefined ? node.value : source.slice(base, end.offset);+ let cursor = 0;+ let line = start?.line ?? 0;+ let column = start?.column ?? 0;+ const advanceTo = (index: number): Point => {+ for (; cursor < index; cursor += 1) {+ if (scanned[cursor] === '\n') {+ line += 1;+ column = 1;+ } else {+ column += 1;+ }+ }+ return { line, column };+ };+ for (const match of scanned.matchAll(WIKI_LINK)) {+ const { index } = match;+ const preceding = base === undefined ? scanned[index - 1] : source[base + index - 1];+ if (preceding === '!') continue;+ const place =+ start && base !== undefined+ ? { start: advanceTo(index), end: advanceTo(index + match[0].length) }+ : undefined;+ file.message(describe(match[0]), place);+ }+ });+});diff --git a/packages/core/src/markdown/lint/rules/reserved-casing.ts b/packages/core/src/markdown/lint/rules/reserved-casing.tsnew file mode 100644index 000000000..c8b4d8f28--- /dev/null+++ b/packages/core/src/markdown/lint/rules/reserved-casing.ts@@ -0,0 +1,25 @@++import { SUPPORTED_DOC_EXTENSIONS } from '../../../constants/doc-extensions.ts';+import { defineOkfRule } from '../okf-runner.ts';++const RESERVED_STEMS = ['index', 'log'] as const;++function stemOf(docName: string): string {+ const base = docName.slice(docName.lastIndexOf('/') + 1);+ const dot = base.lastIndexOf('.');+ if (dot <= 0) return base;+ const ext = base.slice(dot).toLowerCase();+ return (SUPPORTED_DOC_EXTENSIONS as readonly string[]).includes(ext) ? base.slice(0, dot) : base;+}++export const reservedCasing = defineOkfRule('reserved-casing', (_tree, file) => {+ const docName = file.data.okfDocName;+ if (docName === undefined) return;+ const stem = stemOf(docName);+ const lower = stem.toLowerCase();+ if (!RESERVED_STEMS.includes(lower as (typeof RESERVED_STEMS)[number])) return;+ if (stem === lower) return;+ file.message(+ `This file is named "${stem}", but the Open Knowledge Format only recognizes "${lower}". On a case-sensitive filesystem a consumer reads it as an ordinary concept document rather than the reserved file it is meant to be.`,+ );+});diff --git a/packages/core/src/markdown/lint/types.ts b/packages/core/src/markdown/lint/types.tsindex 01ce4a5af..4fa9a5a27 100644--- a/packages/core/src/markdown/lint/types.ts+++ b/packages/core/src/markdown/lint/types.ts@@ -1,6 +1,8 @@+import type { BrokenLinkReason } from '../../schemas/api/agent-write.ts';+import type { OkfRuleId } from './okf-rule-meta.ts';-export const LINT_PLUGIN_IDS = ['markdownlint', 'frontmatter'] as const;+export const LINT_PLUGIN_IDS = ['markdownlint', 'frontmatter', 'okf'] as const;export type LintPluginId = (typeof LINT_PLUGIN_IDS)[number];export type LintSeverity = 'error' | 'warning' | 'info' | 'hint';@@ -98,6 +100,13 @@ export interface FrontmatterSlice {schemas: ResolvedFrontmatterSchemaEntry[];}+export interface OkfSlice {+ enabled: boolean;+ rules?: Partial<Record<OkfRuleId, boolean>>;+ generate?: { index?: boolean };+}++interface RuleOptionSpecBase {key: string;description: string;diff --git a/packages/core/src/markdown/lint/validation-counts.ts b/packages/core/src/markdown/lint/validation-counts.tsindex 98238656e..437cc539a 100644--- a/packages/core/src/markdown/lint/validation-counts.ts+++ b/packages/core/src/markdown/lint/validation-counts.ts@@ -1,3 +1,4 @@+export interface ValidationSourceCounts {errorCount: number;warningCount: number;diff --git a/packages/core/src/markdown/math-promoter.ts b/packages/core/src/markdown/math-promoter.tsindex a5b511f25..bd79424c7 100644--- a/packages/core/src/markdown/math-promoter.ts+++ b/packages/core/src/markdown/math-promoter.ts@@ -1,3 +1,4 @@+import type { Code, Root } from 'mdast';import type { Math as MdastMath } from 'mdast-util-math';import type { MdxJsxAttribute, MdxJsxFlowElement } from 'mdast-util-mdx';diff --git a/packages/core/src/markdown/mdast-to-hast-handlers.ts b/packages/core/src/markdown/mdast-to-hast-handlers.tsindex ed89371d0..00fbc0035 100644--- a/packages/core/src/markdown/mdast-to-hast-handlers.ts+++ b/packages/core/src/markdown/mdast-to-hast-handlers.ts@@ -1,3 +1,4 @@+import type { Comment, Element, ElementContent, Properties } from 'hast';import type { FootnoteDefinition, FootnoteReference } from 'mdast';import type { MdxJsxFlowElement, MdxJsxTextElement } from 'mdast-util-mdx';diff --git a/packages/core/src/markdown/mdast-to-html.ts b/packages/core/src/markdown/mdast-to-html.tsindex 8ce2b2492..df788a80d 100644--- a/packages/core/src/markdown/mdast-to-html.ts+++ b/packages/core/src/markdown/mdast-to-html.ts@@ -1,3 +1,4 @@+import type { Element, Root as HastRoot, Text as HastText } from 'hast';import type { Root as MdastRoot, Text as MdastText } from 'mdast';import type { Handler } from 'mdast-util-to-hast';diff --git a/packages/core/src/markdown/merged-walker.ts b/packages/core/src/markdown/merged-walker.tsindex 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/mermaid-promoter.ts b/packages/core/src/markdown/mermaid-promoter.tsindex 1a897fca8..17ed2b829 100644--- a/packages/core/src/markdown/mermaid-promoter.ts+++ b/packages/core/src/markdown/mermaid-promoter.ts@@ -1,3 +1,4 @@+import type { Code, Root } from 'mdast';import type { MdxJsxAttribute, MdxJsxFlowElement } from 'mdast-util-mdx';import { visit } from 'unist-util-visit';diff --git a/packages/core/src/markdown/parse-with-fallback.ts b/packages/core/src/markdown/parse-with-fallback.tsindex d988f4b8b..4aa0490c4 100644--- a/packages/core/src/markdown/parse-with-fallback.ts+++ b/packages/core/src/markdown/parse-with-fallback.ts@@ -168,6 +168,7 @@ export function parseRecursive(}}+interface VFilePlace {offset?: number;start?: { offset?: number };@@ -186,6 +187,7 @@ function extractErrorOffset(err: unknown): number | undefined {return undefined;}+interface Region {start: number;end: number;@@ -209,6 +211,7 @@ function nearestBlankLineAfter(src: string, offset: number): number | null {return null;}+export interface TagEvent {kind: 'open' | 'close' | 'self-close';name: string;@@ -355,6 +358,7 @@ function findFallbackRegion(src: string, errorOffset: number): Region {return { start: blockStart, end: blockEnd };}+interface SourceBlock {src: string;start: number;@@ -452,6 +456,7 @@ function tryPerBlockFallback(};}+function wholeDocRawText(source: string): JSONContent {return {type: 'doc',diff --git a/packages/core/src/markdown/parser-drop-closure.ts b/packages/core/src/markdown/parser-drop-closure.tsindex e6ab4fd57..43d420187 100644--- a/packages/core/src/markdown/parser-drop-closure.ts+++ b/packages/core/src/markdown/parser-drop-closure.ts@@ -1,3 +1,4 @@+export type DroppedTokenAdjudication =| {kind: 'format-dof-axis';diff --git a/packages/core/src/markdown/pipeline.ts b/packages/core/src/markdown/pipeline.tsindex 0e3224206..55736041c 100644--- a/packages/core/src/markdown/pipeline.ts+++ b/packages/core/src/markdown/pipeline.ts@@ -1,3 +1,4 @@+import {type FromProseMirrorOptions,fromProseMirror,diff --git a/packages/core/src/markdown/position-aware-join.ts b/packages/core/src/markdown/position-aware-join.tsindex 91cdf658f..ccf06e94d 100644--- a/packages/core/src/markdown/position-aware-join.ts+++ b/packages/core/src/markdown/position-aware-join.ts@@ -1,3 +1,4 @@+import type { Join } from 'mdast-util-to-markdown';import type { Position } from 'unist';import { isBlankLineParagraph } from './zero-emission-blocks.ts';diff --git a/packages/core/src/markdown/position-slice.ts b/packages/core/src/markdown/position-slice.tsindex 0f399d34c..e5b4c9eba 100644--- a/packages/core/src/markdown/position-slice.ts+++ b/packages/core/src/markdown/position-slice.ts@@ -1,3 +1,4 @@+import type { Nodes, Root } from 'mdast';import { visit } from 'unist-util-visit';import type { VFile } from 'vfile';@@ -476,7 +477,8 @@ export function applyPositionSliceToNode(const first = source[startOff];if (first !== '[' && first !== '<' && !node.title) {node.data.sourceStyle = 'gfm-autolink';- } else if (first === '[') {+ }+ else if (first === '[') {const slice = source.slice(startOff, endOff);const closeBracketIdx = slice.lastIndexOf('](');if (closeBracketIdx !== -1) {diff --git a/packages/core/src/markdown/rehype-plugins/skip-notion-whitespace.ts b/packages/core/src/markdown/rehype-plugins/skip-notion-whitespace.tsindex db10fa54b..ca225ce9b 100644--- a/packages/core/src/markdown/rehype-plugins/skip-notion-whitespace.ts+++ b/packages/core/src/markdown/rehype-plugins/skip-notion-whitespace.ts@@ -1,3 +1,4 @@+import type { Comment, Element, Root, Text } from 'hast';import type { Plugin } from 'unified';diff --git a/packages/core/src/markdown/rehype-plugins/strip-cocoa-meta.ts b/packages/core/src/markdown/rehype-plugins/strip-cocoa-meta.tsindex 34068d103..3a2524a9a 100644--- a/packages/core/src/markdown/rehype-plugins/strip-cocoa-meta.ts+++ b/packages/core/src/markdown/rehype-plugins/strip-cocoa-meta.ts@@ -1,3 +1,4 @@+import type { Element, ElementContent, Root } from 'hast';import type { Plugin } from 'unified';diff --git a/packages/core/src/markdown/rehype-plugins/strip-gdocs-wrapper.ts b/packages/core/src/markdown/rehype-plugins/strip-gdocs-wrapper.tsindex 93151d43b..2279a0189 100644--- a/packages/core/src/markdown/rehype-plugins/strip-gdocs-wrapper.ts+++ b/packages/core/src/markdown/rehype-plugins/strip-gdocs-wrapper.ts@@ -1,3 +1,4 @@+import type { Element, Root } from 'hast';import type { Plugin } from 'unified';diff --git a/packages/core/src/markdown/rehype-plugins/strip-github-hovercard.ts b/packages/core/src/markdown/rehype-plugins/strip-github-hovercard.tsindex 188f02d83..a0f467c42 100644--- a/packages/core/src/markdown/rehype-plugins/strip-github-hovercard.ts+++ b/packages/core/src/markdown/rehype-plugins/strip-github-hovercard.ts@@ -1,3 +1,4 @@+import type { Element, Root } from 'hast';import type { Plugin } from 'unified';diff --git a/packages/core/src/markdown/rehype-plugins/strip-gmail-classes.ts b/packages/core/src/markdown/rehype-plugins/strip-gmail-classes.tsindex 4ba2c3418..4e8542a21 100644--- a/packages/core/src/markdown/rehype-plugins/strip-gmail-classes.ts+++ b/packages/core/src/markdown/rehype-plugins/strip-gmail-classes.ts@@ -1,3 +1,4 @@+import type { Element, Root } from 'hast';import type { Plugin } from 'unified';diff --git a/packages/core/src/markdown/rehype-plugins/strip-gsheets-wrapper.ts b/packages/core/src/markdown/rehype-plugins/strip-gsheets-wrapper.tsindex 1a74b1272..a3c96b24a 100644--- a/packages/core/src/markdown/rehype-plugins/strip-gsheets-wrapper.ts+++ b/packages/core/src/markdown/rehype-plugins/strip-gsheets-wrapper.ts@@ -1,3 +1,4 @@+import type { Element, ElementContent, Root } from 'hast';import type { Plugin } from 'unified';diff --git a/packages/core/src/markdown/rehype-plugins/strip-mso-styles.ts b/packages/core/src/markdown/rehype-plugins/strip-mso-styles.tsindex de35e7b79..e95cf43d6 100644--- a/packages/core/src/markdown/rehype-plugins/strip-mso-styles.ts+++ b/packages/core/src/markdown/rehype-plugins/strip-mso-styles.ts@@ -1,3 +1,4 @@+import type { Comment, Element, ElementContent, Root } from 'hast';import type { Plugin } from 'unified';diff --git a/packages/core/src/markdown/rehype-plugins/strip-slack-classes.ts b/packages/core/src/markdown/rehype-plugins/strip-slack-classes.tsindex b4be1b2ea..ffdb4d5b5 100644--- a/packages/core/src/markdown/rehype-plugins/strip-slack-classes.ts+++ b/packages/core/src/markdown/rehype-plugins/strip-slack-classes.ts@@ -1,3 +1,4 @@+import type { Element, ElementContent, Root } from 'hast';import type { Plugin } from 'unified';diff --git a/packages/core/src/markdown/rehype-plugins/strip-vscode-spans.ts b/packages/core/src/markdown/rehype-plugins/strip-vscode-spans.tsindex 3c8d88b7c..e2a96d1a7 100644--- a/packages/core/src/markdown/rehype-plugins/strip-vscode-spans.ts+++ b/packages/core/src/markdown/rehype-plugins/strip-vscode-spans.ts@@ -1,3 +1,4 @@+import type { Element, Root } from 'hast';import type { Plugin } from 'unified';diff --git a/packages/core/src/markdown/resolve-image-url.ts b/packages/core/src/markdown/resolve-image-url.tsindex cf2c9da8e..0389575ac 100644--- a/packages/core/src/markdown/resolve-image-url.ts+++ b/packages/core/src/markdown/resolve-image-url.ts@@ -1,3 +1,4 @@+import { isRelativeUrl } from './safe-url.ts';function isDevDiagnosticContext(): boolean {diff --git a/packages/core/src/markdown/safe-url.ts b/packages/core/src/markdown/safe-url.tsindex 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/src/markdown/serialize-fidelity.test-helper.ts b/packages/core/src/markdown/serialize-fidelity.test-helper.tsindex 0dd54070e..96304e7a5 100644--- a/packages/core/src/markdown/serialize-fidelity.test-helper.ts+++ b/packages/core/src/markdown/serialize-fidelity.test-helper.ts@@ -1,3 +1,4 @@+import type { JSONContent } from '@tiptap/core';import type { Nodes } from 'mdast';import { expect } from 'vitest';diff --git a/packages/core/src/markdown/serialize-helpers.ts b/packages/core/src/markdown/serialize-helpers.tsindex 7cac5b042..93798cf83 100644--- a/packages/core/src/markdown/serialize-helpers.ts+++ b/packages/core/src/markdown/serialize-helpers.ts@@ -1,3 +1,4 @@+import type { Node as PmNode } from '@tiptap/pm/model';import type {MdxJsxAttribute,diff --git a/packages/core/src/markdown/single-dollar-math-promoter.ts b/packages/core/src/markdown/single-dollar-math-promoter.tsindex b012a5aff..8c08b7a04 100644--- a/packages/core/src/markdown/single-dollar-math-promoter.ts+++ b/packages/core/src/markdown/single-dollar-math-promoter.ts@@ -1,3 +1,4 @@+import type { PhrasingContent, Root, Text } from 'mdast';import type { InlineMath } from 'mdast-util-math';import { SKIP, visit } from 'unist-util-visit';diff --git a/packages/core/src/markdown/to-markdown-handlers.ts b/packages/core/src/markdown/to-markdown-handlers.tsindex 3e79f8cb6..959cc0bd2 100644--- a/packages/core/src/markdown/to-markdown-handlers.ts+++ b/packages/core/src/markdown/to-markdown-handlers.ts@@ -1,3 +1,4 @@+import type { Nodes, Parents } from 'mdast';import type { MdxJsxAttribute, MdxJsxExpressionAttribute, MdxJsxFlowElement } from 'mdast-util-mdx';import type { Handle, Info, State } from 'mdast-util-to-markdown';diff --git a/packages/core/src/markdown/underline-promoter.ts b/packages/core/src/markdown/underline-promoter.tsindex 0f1b0f27d..6e6d73400 100644--- a/packages/core/src/markdown/underline-promoter.ts+++ b/packages/core/src/markdown/underline-promoter.ts@@ -1,3 +1,4 @@+import type { Nodes, Parent, Root } from 'mdast';import type { MdxJsxTextElement } from 'mdast-util-mdx';import { visit } from 'unist-util-visit';diff --git a/packages/core/src/markdown/unknown-mdast-guard.ts b/packages/core/src/markdown/unknown-mdast-guard.tsindex 1a082bda7..932d7d2a8 100644--- a/packages/core/src/markdown/unknown-mdast-guard.ts+++ b/packages/core/src/markdown/unknown-mdast-guard.ts@@ -1,3 +1,4 @@+import type { Root as MdastRoot } from 'mdast';import type { VFile } from 'vfile';diff --git a/packages/core/src/markdown/whitespace-char-ref.ts b/packages/core/src/markdown/whitespace-char-ref.tsindex d578476a7..ac9f5239b 100644--- a/packages/core/src/markdown/whitespace-char-ref.ts+++ b/packages/core/src/markdown/whitespace-char-ref.ts@@ -1,3 +1,4 @@+const INLINE_WHITESPACE_BY_CODE: ReadonlyMap<number, string> = new Map([[0x20, ' '],[0x09, '\t'],diff --git a/packages/core/src/markdown/wiki-link-micromark.ts b/packages/core/src/markdown/wiki-link-micromark.tsindex 6dad26200..afd9936fe 100644--- a/packages/core/src/markdown/wiki-link-micromark.ts+++ b/packages/core/src/markdown/wiki-link-micromark.ts@@ -17,6 +17,7 @@ declare module 'micromark-util-types' {}}+const CODE_BANG = 33; // !const CODE_LBRACKET = 91; // [const CODE_RBRACKET = 93; // ]@@ -260,6 +261,7 @@ export function wikiLinkSyntax(): Extension {};}+function enterWikiLink(this: CompileContext, token: Token) {this.enter({@@ -385,6 +387,7 @@ export const wikiLinkToMarkdown: {unsafe: [{ character: '[', inConstruct: ['phrasing'] }],};+const MICROMARK_EXT = wikiLinkSyntax();export function remarkWikiLink(this: Processor) {diff --git a/packages/core/src/schemas/api/sync-seed.test.ts b/packages/core/src/schemas/api/sync-seed.test.tsindex f0a331ede..0104d9507 100644--- a/packages/core/src/schemas/api/sync-seed.test.ts+++ b/packages/core/src/schemas/api/sync-seed.test.ts@@ -7,6 +7,8 @@ import {PushPermissionSchema,SeedApplyRequestSchema,SeedApplySuccessSchema,+ SeedInstallPackSkillRequestSchema,+ SeedInstallPackSkillSuccessSchema,SeedPlanSuccessSchema,SyncConflictContentSuccessSchema,SyncConflictsSuccessSchema,@@ -478,6 +480,28 @@ describe('SeedApplySuccessSchema', () => {});});+describe('SeedInstallPackSkill schemas', () => {+ test('require a pack id and report created-vs-existing skills', () => {+ expect(SeedInstallPackSkillRequestSchema.safeParse({ packId: 'okf' }).success).toBe(true);+ expect(SeedInstallPackSkillRequestSchema.safeParse({}).success).toBe(false);+ expect(+ SeedInstallPackSkillSuccessSchema.safeParse({+ installedHosts: ['Claude Code'],+ skills: [{ name: 'okf-knowledge-base', created: true }],+ }).success,+ ).toBe(true);+ });++ test('rejects incomplete skill results', () => {+ expect(+ SeedInstallPackSkillSuccessSchema.safeParse({+ installedHosts: [],+ skills: [{ name: 'okf-knowledge-base' }],+ }).success,+ ).toBe(false);+ });+});+describe('InstallSkillSuccessSchema (discriminated union)', () => {test('parses installed variant — all artifact fields required', () => {expect(diff --git a/packages/core/src/schemas/api/sync-seed.ts b/packages/core/src/schemas/api/sync-seed.tsindex 821783bf4..09df3e996 100644--- a/packages/core/src/schemas/api/sync-seed.ts+++ b/packages/core/src/schemas/api/sync-seed.ts@@ -353,6 +353,33 @@ export const SeedApplySuccessSchema = z.loose() satisfies StandardSchemaV1;export type SeedApplySuccess = z.infer<typeof SeedApplySuccessSchema>;+/** Request body for installing only the companion skills shipped by a pack. */+export const SeedInstallPackSkillRequestSchema = z+ .object({+ packId: z.string().min(1),+ })+ .strict() satisfies StandardSchemaV1;+export type SeedInstallPackSkillRequest = z.infer<typeof SeedInstallPackSkillRequestSchema>;++/**+ * Success body for the explicit pack-skill install action. `created: false`+ * means a same-name project skill already existed and was preserved.+ */+export const SeedInstallPackSkillSuccessSchema = z+ .object({+ installedHosts: z.array(z.string()),+ skills: z.array(+ z+ .object({+ name: z.string().min(1),+ created: z.boolean(),+ })+ .strict(),+ ),+ })+ .strict() satisfies StandardSchemaV1;+export type SeedInstallPackSkillSuccess = z.infer<typeof SeedInstallPackSkillSuccessSchema>;+/*** Per-folder metadata inside a `SeedPackInfo.folders[]`. `summary` is a* UI-friendly first-sentence of the full folder description (the longdiff --git a/packages/core/src/seed-plan-work.ts b/packages/core/src/seed-plan-work.tsnew file mode 100644index 000000000..c1b351161--- /dev/null+++ b/packages/core/src/seed-plan-work.ts@@ -0,0 +1,31 @@+/**+ * "Would applying this seed plan change anything?" — one answer, one place.+ *+ * "Work" has three sources — a file to create, a skill to author, a plugin to+ * enable — and the set grows as packs gain capabilities. One definition, because+ * the callers sit in different packages (the seed dialog and the CLI) and a call+ * site missing a term is not cosmetic: the dialog gates its entire preview on+ * this, so a plan whose only work is enabling a plugin would render empty and+ * tell the user there is nothing to do — exactly the re-seed-after-disabling+ * case the disclosure exists for.+ *+ * Typed structurally rather than against a named plan type so the server's+ * `ScaffoldPlan` and the wire-side `OkScaffoldPlan` both satisfy it without+ * either package importing the other's declaration.+ */++/** The subset of a seed plan this predicate reads. */+export interface SeedPlanWorkShape {+ created: readonly unknown[];+ packSkills?: readonly { pending: boolean }[];+ requiredPlugins?: readonly { pending: boolean }[];+}++/** Whether applying the plan would create a file, author a skill, or enable a plugin. */+export function planHasOutstandingWork(plan: SeedPlanWorkShape): boolean {+ return (+ plan.created.length > 0 ||+ plan.packSkills?.some((skill) => skill.pending) === true ||+ plan.requiredPlugins?.some((plugin) => plugin.pending) === true+ );+}diff --git a/packages/core/src/shadow-repo-layout.test.ts b/packages/core/src/shadow-repo-layout.test.tsindex fe80e35e3..8064dcfcb 100644--- a/packages/core/src/shadow-repo-layout.test.ts+++ b/packages/core/src/shadow-repo-layout.test.ts@@ -20,6 +20,7 @@ import {getWipRefPattern,gitAuthorWriterId,MalformedGitPointerError,+ OK_GENERATOR_WRITER_ID,type OkActorEntry,parseCheckpoint,parseContributors,@@ -215,6 +216,20 @@ describe('parseWriterId (D34 taxonomy)', () => {expect(p.isAgent).toBe(null);});+ test('"ok-generator" → classified-ok-generator, isAgent null', () => {+ const p = parseWriterId(OK_GENERATOR_WRITER_ID);+ expect(p.classification).toBe('classified-ok-generator');+ expect(p.isAgent).toBe(null);+ });++ test('the generator writer id is classified, never "unknown"', () => {+ // The classification is what keeps the ref out of the GC's age-out list AND+ // out of the first-run allowlist sweep, which deletes 'unknown' refs. A+ // constant that drifted from the regex would silently make generated history+ // collectable.+ expect(parseWriterId(OK_GENERATOR_WRITER_ID).classification).not.toBe('unknown');+ });+test('gitAuthorWriterId is stable per email and case/space-insensitive', () => {const a = gitAuthorWriterId('[email protected]');const b = gitAuthorWriterId(' [email protected] ');diff --git a/packages/core/src/shadow-repo-layout.ts b/packages/core/src/shadow-repo-layout.tsindex 330a15709..1cdd7a3fd 100644--- a/packages/core/src/shadow-repo-layout.ts+++ b/packages/core/src/shadow-repo-layout.ts@@ -54,8 +54,15 @@ import { discoverGitRepository } from './git-repository.ts';* file-system → 'classified-file-system' (disk reconcile)* git-upstream → 'classified-git-upstream' (HEAD-move import boundary)* openknowledge-service → 'classified-openknowledge-service' (park / service)+ * ok-generator → 'classified-ok-generator' (OK-authored artifacts)* server, human-*, upstream → 'unknown' (legacy, swept on GC)*+ * `ok-generator` is distinct from `openknowledge-service` on purpose: the service+ * writer is the no-contributor fallback for housekeeping, while a generated+ * artifact is a deliberate authoring action that simply has no human behind it.+ * Folding the two would put generated content under the id this precedent+ * reserves for unattributable work.+ ** `git-author-<hash>` gives each distinct upstream commit author their own WIP* ref so the per-doc Timeline query (which diffs each ref's chain) attributes a* pulled change to the right author. The `<hash>` is `fnv1aDigest(email)` — one@@ -69,11 +76,20 @@ export type WriterClassification =| 'classified-file-system'| 'classified-git-upstream'| 'classified-openknowledge-service'+ | 'classified-ok-generator'| 'unknown';/** Prefix for per-author upstream-import writer ids: `git-author-<fnv1a(email)>`. */export const GIT_AUTHOR_WRITER_PREFIX = 'git-author-';+/**+ * Writer id for artifacts OK authors itself (today: the generated root `index.md`).+ * Lives here so `parseWriterId`, the ref regex, and the server's `WriterIdentity`+ * constant all read one string — a drifted copy would land commits on a ref the+ * parser classifies as 'unknown'.+ */+export const OK_GENERATOR_WRITER_ID = 'ok-generator';+/*** Stable writer id for an upstream commit author, keyed by email so the same* person reuses one ref across pulls. Non-cryptographic digest — identity only.@@ -104,12 +120,12 @@ export interface ParsedWriter {* should flow through `parseWriterId`.** Recognized ids — `agent-<uuid>`, `principal-<uuid>`, `git-author-<hash>`,- * `file-system`, `git-upstream`, `openknowledge-service`.+ * `file-system`, `git-upstream`, `openknowledge-service`, `ok-generator`.* Legacy ids (`human-*`, `upstream`, `server`) do NOT match → 'unknown',* so they are eligible for GC by the allowlist sweep.*/const WRITER_ID_RE =- /^(agent-[^/]+|principal-[^/]+|git-author-[^/]+|file-system|git-upstream|openknowledge-service)$/;+ /^(agent-[^/]+|principal-[^/]+|git-author-[^/]+|file-system|git-upstream|openknowledge-service|ok-generator)$/;/*** Compatibility view of shared repository discovery for shadow-repo callers.@@ -881,6 +897,8 @@ export function parseWriterId(id: string): ParsedWriter {return { id, classification: 'classified-git-upstream', isAgent: null };if (id === 'openknowledge-service')return { id, classification: 'classified-openknowledge-service', isAgent: null };+ if (id === OK_GENERATOR_WRITER_ID)+ return { id, classification: 'classified-ok-generator', isAgent: null };// Unreachable given the regex, but keeps the type narrowing honest.return { id, classification: 'unknown', isAgent: null };}diff --git a/packages/core/src/utils/identity.ts b/packages/core/src/utils/identity.tsindex 90a616564..091837e91 100644--- a/packages/core/src/utils/identity.ts+++ b/packages/core/src/utils/identity.ts@@ -3,6 +3,27 @@ import { randomUUID } from './random-uuid.ts';// --- Constants ---+/**+ * Display names for the classified (non-session) shadow-repo writers.+ *+ * Here, not beside the server's `WriterIdentity` constants, because BOTH sides+ * need them: the server writes these into commits, and the editor matches on+ * them to choose a timeline icon. The editor cannot reach the server's module —+ * nor `shadow-repo-layout`, which imports `node:fs` and is deliberately kept off+ * the browser-safe barrel — so a shared string has to live somewhere neutral,+ * and identity/display constants already do.+ *+ * A hand-copied string on the editor side drifts silently: the miss renders a+ * HUMAN icon next to content no human wrote, which is exactly the confusion the+ * classified writer ids exist to prevent, and nothing else in the UI flags it.+ */+export const SYSTEM_WRITER_DISPLAY_NAMES = {+ fileSystem: 'File System',+ gitUpstream: 'Git (upstream)',+ service: 'OpenKnowledge (service)',+ generator: 'OpenKnowledge (generated)',+} as const;+export const AGENT_COLORS = ['#D97757', // claude'#1B1912', // cursordiff --git a/packages/desktop/tests/smoke/okf-rule-toggle.e2e.ts b/packages/desktop/tests/smoke/okf-rule-toggle.e2e.tsnew file mode 100644index 000000000..78ee876c8--- /dev/null+++ b/packages/desktop/tests/smoke/okf-rule-toggle.e2e.ts@@ -0,0 +1,115 @@+/**+ * QA smoke: the OKF per-rule toggle round-trip, driven through the real settings+ * pane in a live Electron instance.+ *+ * This exists because the bug it covers was invisible to a payload-shaped test.+ * The pane originally re-enabled a rule by omitting its key from the map it sent;+ * a DOM test asserting "the payload was `{rules: {}}`" passed, while the config+ * walker treats an absent key as "leave alone" and only deletes on an explicit+ * `null` — so a rule switched off could never be switched back on. Only driving+ * the real pane and then reading the resulting `.ok/config.yml` catches that.+ *+ * Runs against its own tmp project and userData dir, so it never collides with a+ * developer's running app.+ */++import { existsSync, mkdirSync, mkdtempSync, readFileSync, writeFileSync } from 'node:fs';+import { tmpdir } from 'node:os';+import { dirname, join, resolve } from 'node:path';+import { fileURLToPath } from 'node:url';+import { _electron as electron } from '@playwright/test';+import { expect, test } from './_helpers/smoke-test';++const __dirname = dirname(fileURLToPath(import.meta.url));+const MAIN_ENTRY = resolve(__dirname, '..', '..', 'out', 'main', 'index.js');++const SMOKE_ENABLED = process.env.OK_DESKTOP_E2E_SMOKE === '1';+const DARWIN = process.platform === 'darwin';+const BUILD_EXISTS = existsSync(MAIN_ENTRY);++/** The rule the round-trip drives. Any registered id would do. */+const RULE = 'no-wiki-links';+const TOGGLE = `settings-okf-rule-toggle-${RULE}`;++test.describe('okf per-rule toggle round-trip', () => {+ test.skip(!SMOKE_ENABLED, 'Set OK_DESKTOP_E2E_SMOKE=1 to run Electron smoke tests.');+ test.skip(!DARWIN, 'Deep-link project open is macOS-only in v0.');+ test.skip(!BUILD_EXISTS, `Main build missing at ${MAIN_ENTRY} — run "pnpm run build:desktop".`);++ test('a rule switched off can be switched back on, and config records only the deviation', async ({+ captureStderrFor,+ }) => {+ const tmpHome = mkdtempSync(join(tmpdir(), 'ok-okf-toggle-home-'));+ const projectDir = mkdtempSync(join(tmpdir(), 'ok-okf-toggle-'));+ const configPath = join(projectDir, '.ok', 'config.yml');+ mkdirSync(join(projectDir, '.ok'), { recursive: true });+ // Plugin already enabled so the panel is reachable from the sidebar; no+ // `rules` block, which is the shape a user has before touching a switch.+ writeFileSync(+ configPath,+ "content:\n dir: '.'\n include: ['**/*.md']\n exclude: []\ncontentRules:\n okf:\n enabled: true\n",+ );+ writeFileSync(join(projectDir, 'note.md'), '# Note\n\nA [[WikiLink]] to flag.\n');++ // Open the project by passing the deep-link as ARGV, not via `open(1)`:+ // macOS Launch Services binds the `openknowledge://` scheme to the+ // REGISTERED bundle (a developer's installed app), so shelling out to+ // `open` would drive the wrong process entirely. Argv delivery routes+ // through the same second-instance URL parsing without leaving this+ // `_electron.launch()` instance. The state.json restore path is avoided+ // deliberately — under a git worktree it intermittently loses the forked+ // server (Yjs double-instance) and the project never mounts.+ const userDataDir = join(tmpHome, 'electron-userdata');+ mkdirSync(userDataDir, { recursive: true });+ const deepLink = `openknowledge://open?project=${encodeURIComponent(projectDir)}&doc=note`;++ const app = await electron.launch({+ args: [MAIN_ENTRY, deepLink, `--user-data-dir=${userDataDir}`],+ timeout: 30_000,+ });+ captureStderrFor(app, { cleanupDirs: [projectDir, tmpHome] });+ await app.firstWindow({ timeout: 15_000 });++ const settingsPage = await (async () => {+ for (let i = 0; i < 60; i++) {+ for (const page of app.windows()) {+ const hash = await page.evaluate(() => window.location.hash).catch(() => '');+ if (hash.includes('note')) return page;+ }+ await new Promise((r) => setTimeout(r, 500));+ }+ throw new Error('project window never mounted from the argv deep-link');+ })();++ await settingsPage.getByTestId('header-settings-button').click({ timeout: 15_000 });+ // The sidebar only lists a plugin's panel while that plugin is enabled,+ // which the seeded config guarantees.+ await settingsPage.getByTestId('settings-sidebar-item-plugin:okf').click({ timeout: 15_000 });++ const toggle = settingsPage.getByTestId(TOGGLE);+ await expect(toggle).toBeVisible({ timeout: 15_000 });++ // Baseline: absent from config means enabled.+ expect(await toggle.getAttribute('aria-checked')).toBe('true');+ expect(readFileSync(configPath, 'utf8')).not.toContain(RULE);++ // Off — the deviation is recorded.+ await toggle.click();+ await expect(toggle).toHaveAttribute('aria-checked', 'false', { timeout: 10_000 });+ await expect(async () => {+ expect(readFileSync(configPath, 'utf8')).toMatch(new RegExp(`${RULE}:\\s*false`));+ }).toPass({ timeout: 15_000 });++ // Back on — THE REGRESSION. Before the fix the switch stayed off and the+ // `false` never left the file, because the patch omitted the key instead of+ // sending null.+ await toggle.click();+ await expect(toggle).toHaveAttribute('aria-checked', 'true', { timeout: 10_000 });+ await expect(async () => {+ expect(readFileSync(configPath, 'utf8')).not.toMatch(new RegExp(`${RULE}:\\s*false`));+ }).toPass({ timeout: 15_000 });++ // The plugin itself is untouched by a per-rule toggle.+ expect(readFileSync(configPath, 'utf8')).toMatch(/enabled:\s*true/);+ });+});diff --git a/packages/server/assets/skills/packs/knowledge-base/SKILL.md b/packages/server/assets/skills/packs/knowledge-base/SKILL.mdindex 157e9a226..a34c56913 100644--- a/packages/server/assets/skills/packs/knowledge-base/SKILL.md+++ b/packages/server/assets/skills/packs/knowledge-base/SKILL.md@@ -2,6 +2,7 @@name: knowledge-basedescription: "How to work in a Knowledge Base project (the `knowledge-base` starter pack). Read when the project has the three-layer source-grounded layout — `external-sources/` → `research/` → `articles/` — or when asked how this project is organized. Carries the layer model, per-folder rules, status flows, and log discipline so this guidance does NOT live inside template bodies or log.md. The three procedures live elsewhere: ingest in the platform `open-knowledge` skill, research and consolidate as their own sibling skills in this pack. Complements the platform `open-knowledge` skill; does not replace it."compatibility: "Any agent host with the OpenKnowledge MCP server configured. Installed project-local by `ok seed --pack knowledge-base`."+type: Documentmetadata:pack: "knowledge-base"author: "Inkeep"@@ -38,8 +39,8 @@ Each layer has a full, STOP-gated procedure, and each ships as its own skill so| Procedure | Where it lives | When || --- | --- | --- || ingest | Platform `/open-knowledge` skill (`references/ingest-and-sources.md`) — its Grounding rule depends on it everywhere, so it ships with every project, not just this pack. | Preserve a shared URL / PDF / file verbatim, OR you fetched a URL to ground a KB claim (binary sources preserved, not scraped). |-| research | Sibling skill `/research-with-sources` | Investigate / compare / synthesize multiple sources → `status: provisional` article + `sources:`. |-| consolidate | Sibling skill `/consolidate-notes` | A decision was actually made → commit canonical source-of-truth with a `supersedes:` chain. |+| research | Sibling skill `/research-with-sources` | Investigate / compare / synthesize multiple sources → provisional article with `status: draft` + `sources:`. |+| consolidate | Sibling skill `/consolidate-notes` | A decision was actually made → commit canonical source-of-truth with `status: stable` + a `supersedes:` chain. |Typical day-2 flow: user shares a URL → **ingest** (preserve) → user asks "now research this" → **research** (provisional article, ingesting more sources as needed) → decision lands → **consolidate** (canonical article, supersedes the research).@@ -51,18 +52,22 @@ Typical day-2 flow: user shares a URL → **ingest** (preserve) → user asks "n**`external-sources/`** — Raw sources saved verbatim, not just cited: the actual fetched text of URLs, extracted text of PDFs, copies of referenced files. Each file's frontmatter carries the original URL, access date, and any author/publisher metadata. Produced by the ingest procedure (applies whether the user shared the URL or you fetched it yourself to ground a claim). Immutable after capture — update only to refresh a stale fetch. **No analysis here**; that belongs in `research/`.-**`research/`** — Provisional analysis synthesizing external sources. Produced by the `/research-with-sources` skill. Every factual claim cites a specific doc in `external-sources/` (or an inline URL if ingest was skipped); no unsourced assertions. Keep the `sources:` frontmatter list aligned with the docs actually linked in the body. Promote to `articles/` via the `/consolidate-notes` skill once the team decides the findings are stable.+**`research/`** — Provisional analysis synthesizing external sources, stored as OKF `status: draft`. Produced by the `/research-with-sources` skill. Every factual claim cites a specific doc in `external-sources/` (or an inline URL if ingest was skipped); no unsourced assertions. Keep the `sources:` frontmatter list aligned with the docs actually linked in the body. Promote to `articles/` via the `/consolidate-notes` skill once the team decides the findings are stable.-**`articles/`** — Canonical knowledge, committed after a team decision. Produced by the `/consolidate-notes` skill. Carries a `supersedes:` chain tying back to the `research/` docs it replaces (which in turn cite `external-sources/`) so the full evidence chain is traceable without leaving the repo. Source-of-truth for the domain; update only when a new decision supersedes it.+**`articles/`** — Canonical knowledge, committed after a team decision and stored as OKF `status: stable`. Produced by the `/consolidate-notes` skill. Carries a `supersedes:` chain tying back to the `research/` docs it replaces (which in turn cite `external-sources/`) so the full evidence chain is traceable without leaving the repo. Source-of-truth for the domain; update only when a new decision supersedes it.## Status flow| Layer | `status` | Set when ||---|---|---|-| `research/` | `provisional` | created |-| `articles/` | `canonical` | promoted by consolidate after a decision |+| `research/` | `draft` | created |+| `articles/` | `stable` | promoted by consolidate after a decision |-When a new article supersedes an older one, add the older article's path to the new one's `supersedes:` list.+When a new article supersedes research, set that research to `status: deprecated`, add its path to the article's `supersedes:` list, and point it back with `superseded_by:`.++## Legacy compatibility++Older projects may use `status: provisional` / `canonical` and string entries under `sources:`. Read those forms as draft / stable and source resources. Do not rewrite untouched documents; use the OKF forms above for new writes and files you are already updating.## Log discipline (MUST)diff --git a/packages/server/assets/skills/packs/knowledge-base/consolidate/SKILL.md b/packages/server/assets/skills/packs/knowledge-base/consolidate/SKILL.mdindex 31da78790..955f559b7 100644--- a/packages/server/assets/skills/packs/knowledge-base/consolidate/SKILL.md+++ b/packages/server/assets/skills/packs/knowledge-base/consolidate/SKILL.md@@ -1,7 +1,8 @@---name: consolidate-notes-description: "Promote existing research into a canonical article under `articles/` in a Knowledge Base project (the `knowledge-base` starter pack). Read when a decision has actually been made and the team wants the source-of-truth written down, or when asked to consolidate, canonicalize, promote research, or supersede an older article. Carries the decision-confirmation gate, the `supersedes:` chain that keeps the evidence trail intact, and the canonical voice. Does not conduct new research — that is the sibling `research-with-sources` skill."+description: "Promote existing research into a stable-status canonical article under `articles/` in a Knowledge Base project (the `knowledge-base` starter pack). Read when a decision has actually been made and the team wants the source-of-truth written down, or when asked to consolidate, canonicalize, promote research, or supersede an older article. Carries the decision-confirmation gate, the `supersedes:` chain that keeps the evidence trail intact, and the canonical voice. Does not conduct new research — that is the sibling `research-with-sources` skill."compatibility: "Any agent host with the OpenKnowledge MCP server configured. Installed project-local by `ok seed --pack knowledge-base`."+type: Documentmetadata:pack: "knowledge-base"author: "Inkeep"@@ -15,6 +16,8 @@ Promote existing research on a topic into a canonical article under `articles/`.The content directory is the resolved `content.dir` — read it with `config({ key: 'content.dir' })` if you don't already know it. Paths below are relative to it.+**Legacy reads:** Existing research and articles may use `status: provisional` / `canonical`, and existing `sources:` may contain string paths. Treat those as draft / stable and source resources. Do not mass-rewrite them; new writes use the OKF forms below.+## STOP gate: has a decision actually been made?Consolidation is **promotion, not creation**. If the team hasn't decided, the resulting "canonical" article lies about the team's state of understanding — future agents read it, act on it, and the false certainty compounds.@@ -80,9 +83,12 @@ Frontmatter:---title: Descriptive titledescription: One-line summary of what this article covers-status: canonical+type: article+status: stabledate: YYYY-MM-DDtags:+ - article+ - canonical- topic-tagsupersedes:- <path-to-research-article>.md@@ -141,15 +147,16 @@ Add a `supersedes:` list in the new article's frontmatter pointing at the researDo NOT delete the research articles — they remain as historical context for how the decision was reached. Edit their frontmatter to add:```yaml+status: deprecatedsuperseded_by: <path-to-new-canonical-article>.md```### 6. Verify- File exists at the chosen path under the content directory-- Has `status: canonical` frontmatter+- Has `type: article` and `status: stable` frontmatter- Lists the research articles it supersedes-- Research articles updated with `superseded_by` pointer+- Research articles updated with `status: deprecated` and a `superseded_by` pointer- `exec("ls -A <target-dir>")` shows the new file## Non-goalsdiff --git a/packages/server/assets/skills/packs/knowledge-base/research/SKILL.md b/packages/server/assets/skills/packs/knowledge-base/research/SKILL.mdindex 012111a68..f53e41181 100644--- a/packages/server/assets/skills/packs/knowledge-base/research/SKILL.md+++ b/packages/server/assets/skills/packs/knowledge-base/research/SKILL.md@@ -1,7 +1,8 @@---name: research-with-sources-description: "Investigate a topic against preserved sources and write a provisional research article under `research/` in a Knowledge Base project (the `knowledge-base` starter pack). Read when asked to research a topic, compare options, synthesize sources, gather evidence, or extend an existing research doc. Carries the full procedure: scan existing coverage, agree a research rubric, capture every source verbatim before analyzing, write the article incrementally so a crash never loses work, cite every claim, and link it back into the graph. Does not promote findings to canonical knowledge — that is the sibling `consolidate-notes` skill, after a decision lands."+description: "Investigate a topic against preserved sources and write a draft-status research article under `research/` in a Knowledge Base project (the `knowledge-base` starter pack). Read when asked to research a topic, compare options, synthesize sources, gather evidence, or extend an existing research doc. Carries the full procedure: scan existing coverage, agree a research rubric, capture every source verbatim before analyzing, write the article incrementally so a crash never loses work, cite every claim, and link it back into the graph. Does not promote findings to canonical knowledge — that is the sibling `consolidate-notes` skill, after a decision lands."compatibility: "Any agent host with the OpenKnowledge MCP server configured. Installed project-local by `ok seed --pack knowledge-base`."+type: Documentmetadata:pack: "knowledge-base"author: "Inkeep"@@ -17,12 +18,14 @@ The content directory is the resolved `content.dir` — read it with `config({ k## Three paths-- **Path A — Research article (DEFAULT):** A persistent provisional article with an inline `sources:` frontmatter list pointing at raw sources captured via the ingest procedure. This is the default unless the user explicitly opts out.+- **Path A — Research article (DEFAULT):** A persistent provisional article with `status: draft` and an inline `sources:` frontmatter list pointing at raw sources captured via the ingest procedure. This is the default unless the user explicitly opts out.- **Path B — Direct answer:** Findings delivered in conversation only. **Requires explicit user request** (e.g., "just tell me", "no doc needed", "quick answer").- **Path C — Update existing research:** Surgical additions/corrections to an existing research article. Triggered when the user references an existing research doc or says "update/refresh/extend."Path A is the default because provisional articles compound over time; spoken answers do not.+**Legacy reads:** Existing articles may use `status: provisional` and string paths under `sources:`. Treat those as draft research and source resources. Do not mass-rewrite them; new writes use the OKF shapes below.+## Autonomy mode| Mode | Behavior | How entered |@@ -240,14 +243,16 @@ Filename: descriptive, kebab-case (`crdt-alternatives-for-editor.md`, `llm-wikis---title: Descriptive titledescription: One-line summary of the research question-status: provisional+type: research-note+status: draftdate: YYYY-MM-DDtags:- research+ - provisional- <topic-tag>sources:- - <path-to-ingested-source-1>.md- - <path-to-ingested-source-2>.md+ - resource: ../external-sources/<source-1>.md+ - resource: ../external-sources/<source-2>.md---```@@ -270,7 +275,7 @@ sources:- Pros — with evidence links- Cons — with evidence links-- Evidence: [Source A](./external-sources/source-a.md), [Source B](./external-sources/source-b.md)+- Evidence: [Source A](../external-sources/source-a.md), [Source B](../external-sources/source-b.md)### Theme / Option 2@@ -308,7 +313,7 @@ Research articles are discovery surfaces. Under-linked research becomes an islan### Link discipline- Every noun-phrase that names another document is a link. Use standard markdown: `[text](./relative/path.md)`.-- Link sources inline where you cite them, not just in the frontmatter `sources:` list: `According to [LLM Agents](./external-sources/llm-agents.md)...` is stronger than a bare `sources:` entry.+- Link sources inline where you cite them, not just in the frontmatter `sources:` list: `According to [LLM Agents](../external-sources/llm-agents.md)...` is stronger than a bare `sources:` entry.- Cross-link sibling research: if an adjacent topic has its own research doc, link it under "Open questions" or inline. Readers following one thread should find the others.- After writing, update 1-2 closely-related existing pages to link back to this research (usually under "Further reading" or "See also"). This is how the research becomes discoverable via backlinks.- Never wrap links in backticks; never use HTML anchors — matches the platform skill's linking rules.@@ -318,7 +323,7 @@ Research articles are discovery surfaces. Under-linked research becomes an islanIf the user asked a specific question during the research session that produced a citable answer, capture it as its own short page alongside the research — not just as chat. Concrete questions with sourced answers are the highest-signal unit of knowledge you can produce.- Short filename: `what-does-X-mean.md`, `how-does-Y-work.md`-- Include the same `sources:` frontmatter+- Include the same object-shaped `sources:` frontmatter- Link the answer from this research doc under "Further reading"- Answers too small to justify a separate file stay in chat; don't fragment@@ -329,7 +334,7 @@ If the user asked a specific question during the research session that producedRun this checklist before marking complete:- File exists at the chosen path under the content directory-- Frontmatter has `title`, `description`, `status: provisional`, `date`, and a `sources:` list+- Frontmatter has `title`, `description`, `type: research-note`, `status: draft`, `date`, and an object-shaped `sources:` list- `exec("ls -A <dir>")` lists the new file with frontmatter enrichment- `links({ kind: 'dead', sourceDocNames: ['<path-without-ext>'] })` returns clean — zero dead links (fix or remove every one)- Every factual claim in Findings cites a source inlinediff --git a/packages/server/assets/skills/packs/okf/SKILL.md b/packages/server/assets/skills/packs/okf/SKILL.mdindex f03fe4c43..199adaf02 100644--- a/packages/server/assets/skills/packs/okf/SKILL.md+++ b/packages/server/assets/skills/packs/okf/SKILL.md@@ -1,52 +1,56 @@---name: okf-knowledge-base-description: "How to work in an OKF starter project (the `okf` starter pack): a knowledge base that is conformant with Google's Open Knowledge Format (OKF) from commit one — `concepts/`, `references/`, `notes/`, a reserved `index.md` navigation hub, and a reserved `log.md` change history. Read when the project has these folders plus reserved files, OR when asked whether a document is OKF-conformant, or to add a document to an OKF knowledge base. Carries the OKF conventions (non-empty `type` on every non-reserved doc; reserved files carry no frontmatter) as guidance, not enforcement. Complements the platform `open-knowledge` skill; does not replace it."-compatibility: "Any agent host with the OpenKnowledge MCP server configured. Installed project-local by `ok seed --pack okf`."-# `type` keeps this skill doc OKF-conformant: it installs as project-local-# markdown under each detected agent's skills dir, which OK admits into the-# content corpus — so without a non-empty `type` it would be a non-reserved-# doc that violates the pack's own "every non-reserved doc has a `type`" contract.+description: "Open Knowledge Format (OKF) v0.2 guidance. Use when creating, reading, reviewing, or maintaining an OKF bundle; responding to OpenKnowledge `okf` plugin warnings; or choosing types, provenance, links, indexes, or logs."+compatibility: "Any agent host with the OpenKnowledge MCP server configured. The optional `okf` plugin provides continuous conformance feedback."+# This skill may live inside an OKF bundle, so it carries the required type.type: Documentmetadata:- pack: "okf"+ plugin: "okf"author: "Inkeep"repository: "https://github.com/inkeep/open-knowledge-skills"----# OKF starter pack — how to work here+# Open Knowledge Format (OKF)-This project was scaffolded to be conformant with **Google's Open Knowledge Format (OKF) v0.1** from the first commit — markdown + YAML frontmatter, a standard-markdown link graph, and two reserved files. Conformance here is pre-populated, **not enforced**: OpenKnowledge's native frontmatter schema stays open-shaped, nothing is linted, and you are free to author however you like. This skill explains the conventions so the kit stays OKF-portable as it grows.+[OKF v0.2](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) is a portable format for agent-readable knowledge: Markdown files, YAML frontmatter, and standard links. The `/open-knowledge` skill governs tool use; this skill covers OKF semantics.-> This skill is pack guidance. The platform `/open-knowledge` skill (read/write/preview/linking/grounding rules) still governs every markdown operation — this layers the OKF conventions on top.+## Core rules-## The one rule (keep the kit conformant)+- A bundle is a directory tree of `.md` files. Each non-reserved file is one concept; its path without `.md` is its ID.+- Every concept needs parseable frontmatter with a non-empty string `type`. No other field is always required.+- Types are an open vocabulary. Consumers must accept unfamiliar types and metadata.+- Use standard Markdown links for portable relationships. Broken links and a missing index are allowed.+- `index.md` and `log.md` are reserved at every level. Use lowercase filenames.+- An `index.md` normally has no frontmatter; only the root index may declare `okf_version: "0.2"`.+- A `log.md` is newest-first; entry headings begin `## YYYY-MM-DD: Summary`.+- OKF consumers read `.md`, not `.mdx`.-OKF requires exactly one thing of every **non-reserved** document: a **non-empty `type`** in its frontmatter. That is the whole conformance contract for your content.+## Authoring judgment-- The value is **yours to choose** — `concept`, `reference`, `note`, `person`, `event`, anything that fits. There is no blessed taxonomy.-- `Document` is a fine **generic fallback** when nothing more specific fits (it is just a non-empty value, not a special keyword).-- The folder templates already set a sensible `type` per section — create docs with `write({ document: { path, template: "<name>" } })` and you inherit it.+- Make each concept the smallest useful link or citation target. Choose a stable, descriptive type; `Document` is only a generic fallback.+- Do not invent facts, relationships, resources, sources, verification, or history. Missing knowledge is better than false structure.+- Use `title`, `description`, `resource`, and `tags` only when they add real information.+- Record provenance in `sources`. Join claim-level citations with matching `sources[].id` and Markdown footnotes.+- Keep authorship and verification separate: `generated` says who produced content; `verified` says who confirmed it. Use exact lowercase `human:` and `process:` prefixes when applicable.+- Treat `status: deprecated` and expired `stale_after` values as trust signals, not validation errors.+- For `type: Attested Computation`, follow the declared runtime and parameters. Do not rewrite the sanctioned computation.-## Folders+## Read and maintain a bundle-- **`concepts/`** — durable ideas and definitions, one file per concept (`type: concept`).-- **`references/`** — external sources and citations you rely on (`type: reference`).-- **`notes/`** — working notes and observations (`type: note`).+- Start with the nearest `index.md`, inspect frontmatter, then follow only relevant links.+- Prefer current, verified sources, but tolerate unknown types and incomplete links.+- If the bundle conflicts with an assumption, trust the bundle; if it is missing or inconsistent, say so.+- Write durable discoveries back to the relevant concept and authored enumerations.+- Add a truthful dated `log.md` entry after durable changes when the bundle uses a log.+- Read legacy `timestamp` and body citations, but prefer v0.2 `generated.at` and `sources` when updating a concept. Never invent provenance while migrating.-Link liberally with **standard markdown links** (`[text](./path.md)`) — the value is the graph that emerges from the links between typed docs, and standard links keep that graph portable to any OKF consumer. (OpenKnowledge also accepts `[[wiki-link]]` shorthand as a native superset and preserves it byte-for-byte — but seeded content uses standard links so the bundle is conformant as-is.)+## OpenKnowledge's `okf` plugin-## Reserved files (keep them frontmatter-free)+The optional project plugin provides continuous portability feedback without blocking writes:-OKF reserves two lowercase files at the project root. **Neither carries frontmatter** — adding any frontmatter to a reserved file breaks OKF conformance.+- Write-time warnings and project audits check structure, frontmatter, reserved files, links, and `.mdx` use.+- `.ok/okf/*.schema.json` contains the precise field contracts. Read these generated files instead of guessing; do not edit them.+- Deterministic lint findings establish conformance. Agent judgment still establishes whether metadata is true and useful.+- Optional index generation maintains `index.md` files. Generated indexes are machine-owned: never edit them, because OpenKnowledge replaces their contents.+- `log.md` remains authored, not generated.-- **`index.md`** (OKF §6) — the navigation hub: a link-list to the key docs and sections. Keep it current as you add important docs; it is how a reader (or a strict OKF consumer) finds their way in.-- **`log.md`** (OKF §7) — the change history: newest-first dated entries shaped `## YYYY-MM-DD: <summary>`. Add an entry whenever you create, edit, or restructure content. The seed ships a prose instruction documenting this format — add your first dated entry on your first edit.--The tool does not keep these live for you (that would be enforcement) — maintaining them is part of authoring here.--## What stays OKF-portable--- Every non-reserved doc has a non-empty `type`. ✅-- `index.md` / `log.md` stay lowercase and frontmatter-free. ✅-- Links use standard markdown / wiki-link syntax. ✅--If you ever want to hand this knowledge base to a strict OKF consumer, those three habits are all it takes.+The plugin is off by default and each rule can be disabled. Its value is early warning when OpenKnowledge-native content would be misread by another OKF consumer.diff --git a/packages/server/assets/skills/project/references/ingest-and-sources.md b/packages/server/assets/skills/project/references/ingest-and-sources.mdindex 0b7cf349d..b49ee8d5f 100644--- a/packages/server/assets/skills/project/references/ingest-and-sources.md+++ b/packages/server/assets/skills/project/references/ingest-and-sources.md@@ -118,6 +118,7 @@ Write a markdown wrapper at `external-sources/<slug>.md`. **Declare the full tag---title: Original title of the source (from <title>, Content-Disposition filename, or your best read)description: One-line summary from the source (their words, not yours)+type: sourcesource_url: https://example.com/path/to/file.pdfsource_path: ./<slug>.<ext> # relative to this wrappermedia_type: application/pdf # RFC 6838 type/subtype, from HEAD Content-Type@@ -152,6 +153,7 @@ Frontmatter shape:---title: Original title of the sourcedescription: One-line summary from the source (their words, not yours)+type: sourcesource_url: https://example.com/articlemedia_type: text/htmldate_fetched: YYYY-MM-DD@@ -191,7 +193,7 @@ For text wrappers:## Step 4: Verify- File(s) exist under the sources folder (binary + wrapper, or wrapper alone for text).-- Valid frontmatter (at minimum `title`, `description`, `source_url`, `preservation`, and the full `tags` list — plus `source_path` for binary wrappers).+- Valid frontmatter (at minimum `title`, `description`, `type: source`, `source_url`, `preservation`, and the full `tags` list — plus `source_path` for binary wrappers).- For binary preservation: `sha256` and `bytes` recorded; `media_type` matches what the HEAD response returned.- `exec("ls -A <content-dir>/external-sources/")` lists the new file(s) with enrichment.diff --git a/packages/server/measure-generated-index-sweep.test.ts b/packages/server/measure-generated-index-sweep.test.tsnew file mode 100644index 000000000..0b5eb39fb--- /dev/null+++ b/packages/server/measure-generated-index-sweep.test.ts@@ -0,0 +1,125 @@+import { describe, expect, test } from 'vitest';+import {+ buildMeasurementResult,+ distributeDocuments,+ parseMeasurementArgs,+ summarizeDurations,+} from './measure-generated-index-sweep.ts';++describe('generated-index sweep measurement rig', () => {+ test('parses an explicit comparable campaign', () => {+ expect(+ parseMeasurementArgs([+ '--directories',+ '1,10,100',+ '--documents',+ '1000',+ '--repetitions',+ '5',+ '--warmups',+ '1',+ ]),+ ).toEqual({+ directoryCounts: [1, 10, 100],+ documentCount: 1000,+ repetitions: 5,+ warmupRuns: 1,+ });+ });++ test('accepts the argument separator forwarded through pnpm scripts', () => {+ expect(parseMeasurementArgs(['--', '--directories', '1'])).toMatchObject({+ directoryCounts: [1],+ });+ });++ test.each([+ [['--directories', ''], 'non-empty comma-separated list'],+ [['--directories', '0,10'], 'positive integers'],+ [['--directories', '10,10'], 'unique'],+ [['--documents', '3', '--directories', '1,4'], 'at least the largest directory count'],+ [['--repetitions', '0'], 'positive integer'],+ [['--warmups', '-1'], 'non-negative integer'],+ [['--unknown', '1'], 'unknown argument'],+ ])('rejects invalid arguments: %j', (argv, message) => {+ expect(() => parseMeasurementArgs(argv)).toThrow(message);+ });++ test('keeps document count fixed while distributing at least one document per directory', () => {+ const counts = distributeDocuments(10, 4);+ expect(counts).toEqual([3, 3, 2, 2]);+ expect(counts.reduce((total, count) => total + count, 0)).toBe(10);+ expect(counts.every((count) => count > 0)).toBe(true);+ });++ test('summarizes raw durations without hiding run-to-run spread', () => {+ expect(summarizeDurations([12.41, 11.98, 12.22, 12.08, 12.35])).toEqual({+ samples: [12.41, 11.98, 12.22, 12.08, 12.35],+ median: 12.22,+ min: 11.98,+ max: 12.41,+ });+ expect(summarizeDurations([4, 2])).toMatchObject({ median: 3 });+ });++ test('emits a schema-versioned result with index-count and duration cells', () => {+ const result = buildMeasurementResult({+ args: {+ directoryCounts: [1, 10],+ documentCount: 100,+ repetitions: 2,+ warmupRuns: 1,+ },+ capturedAt: '2026-08-06T12:00:00.000Z',+ commit: 'abc1234',+ runtime: {+ nodeVersion: 'v24.0.0',+ platform: 'darwin',+ arch: 'arm64',+ cpuModel: 'Test CPU',+ },+ samples: new Map([+ [+ 1,+ [+ { durationMs: 2.25, indexCount: 2 },+ { durationMs: 2.75, indexCount: 2 },+ ],+ ],+ [+ 10,+ [+ { durationMs: 8.5, indexCount: 11 },+ { durationMs: 9.5, indexCount: 11 },+ ],+ ],+ ]),+ });++ expect(result).toMatchObject({+ schemaVersion: 1,+ benchmark: 'generated-index-full-sweep',+ fixture: {+ topology: 'flat',+ documentCount: 100,+ directoryCounts: [1, 10],+ warmupRuns: 1,+ repetitions: 2,+ },+ cells: [+ {+ directoryCount: 1,+ expectedIndexCount: 2,+ indexCount: 2,+ sweepDurationMs: { samples: [2.25, 2.75], median: 2.5, min: 2.25, max: 2.75 },+ },+ {+ directoryCount: 10,+ expectedIndexCount: 11,+ indexCount: 11,+ sweepDurationMs: { samples: [8.5, 9.5], median: 9, min: 8.5, max: 9.5 },+ },+ ],+ });+ });+});diff --git a/packages/server/measure-generated-index-sweep.ts b/packages/server/measure-generated-index-sweep.tsnew file mode 100644index 000000000..ca3c6576d--- /dev/null+++ b/packages/server/measure-generated-index-sweep.ts@@ -0,0 +1,379 @@+import { execFile } from 'node:child_process';+import { existsSync, mkdirSync, mkdtempSync, realpathSync, rmSync, writeFileSync } from 'node:fs';+import { arch, cpus, platform, tmpdir } from 'node:os';+import { join, resolve } from 'node:path';+import { pathToFileURL } from 'node:url';+import { promisify } from 'node:util';+import { stringify as stringifyYaml } from 'yaml';+import { type BootedServer, bootServer } from './src/boot.ts';+import { getBootTimings } from './src/boot-timings.ts';+import { ConfigSchema } from './src/config/schema.ts';+import { loggerFactory } from './src/logger.ts';+import { ensureProjectGit } from './src/project-git.ts';++const execFileAsync = promisify(execFile);+const RESULT_PREFIX = 'GENERATED_INDEX_SWEEP_RESULT ';++export interface MeasurementArgs {+ directoryCounts: number[];+ documentCount: number;+ repetitions: number;+ warmupRuns: number;+}++interface MeasurementSample {+ durationMs: number;+ indexCount: number;+}++interface RuntimeIdentity {+ nodeVersion: string;+ platform: string;+ arch: string;+ cpuModel: string;+}++interface BuildMeasurementResultOptions {+ args: MeasurementArgs;+ capturedAt: string;+ commit: string;+ runtime: RuntimeIdentity;+ samples: Map<number, MeasurementSample[]>;+}++class CampaignInterruptedError extends Error {}++const DEFAULT_ARGS: MeasurementArgs = {+ directoryCounts: [1, 10, 100, 500],+ documentCount: 1000,+ repetitions: 5,+ warmupRuns: 1,+};++function parseInteger(value: string, name: string, allowZero: boolean): number {+ const parsed = Number(value);+ const valid = Number.isInteger(parsed) && (allowZero ? parsed >= 0 : parsed > 0);+ if (!valid) {+ throw new Error(`${name} must be a ${allowZero ? 'non-negative' : 'positive'} integer`);+ }+ return parsed;+}++function takeValue(argv: string[], index: number): string {+ const value = argv[index + 1];+ if (value === undefined || value.startsWith('--')) {+ throw new Error(`${argv[index]} requires a value`);+ }+ return value;+}++export function parseMeasurementArgs(argv: string[]): MeasurementArgs {+ const normalizedArgv = argv[0] === '--' ? argv.slice(1) : argv;+ const args: MeasurementArgs = {+ ...DEFAULT_ARGS,+ directoryCounts: [...DEFAULT_ARGS.directoryCounts],+ };++ for (let index = 0; index < normalizedArgv.length; index += 2) {+ const flag = normalizedArgv[index];+ const value = takeValue(normalizedArgv, index);+ switch (flag) {+ case '--directories': {+ if (value.length === 0) {+ throw new Error('--directories requires a non-empty comma-separated list');+ }+ const directoryCounts = value.split(',').map((part) => Number(part));+ if (!directoryCounts.every((count) => Number.isInteger(count) && count > 0)) {+ throw new Error('--directories values must be positive integers');+ }+ if (new Set(directoryCounts).size !== directoryCounts.length) {+ throw new Error('--directories values must be unique');+ }+ args.directoryCounts = directoryCounts;+ break;+ }+ case '--documents':+ args.documentCount = parseInteger(value, '--documents', false);+ break;+ case '--repetitions':+ args.repetitions = parseInteger(value, '--repetitions', false);+ break;+ case '--warmups':+ args.warmupRuns = parseInteger(value, '--warmups', true);+ break;+ default:+ throw new Error(`unknown argument: ${flag}`);+ }+ }++ if (args.documentCount < Math.max(...args.directoryCounts)) {+ throw new Error('--documents must be at least the largest directory count');+ }+ return args;+}++export function distributeDocuments(documentCount: number, directoryCount: number): number[] {+ const quotient = Math.floor(documentCount / directoryCount);+ const remainder = documentCount % directoryCount;+ return Array.from(+ { length: directoryCount },+ (_, index) => quotient + (index < remainder ? 1 : 0),+ );+}++function roundHundredths(value: number): number {+ return Math.round(value * 100) / 100;+}++export function summarizeDurations(samples: number[]): {+ samples: number[];+ median: number;+ min: number;+ max: number;+} {+ if (samples.length === 0) throw new Error('duration samples must not be empty');+ const sorted = [...samples].sort((left, right) => left - right);+ const middle = Math.floor(sorted.length / 2);+ const median =+ sorted.length % 2 === 0 ? (sorted[middle - 1] + sorted[middle]) / 2 : sorted[middle];+ return {+ samples: [...samples],+ median: roundHundredths(median),+ min: sorted[0],+ max: sorted.at(-1) as number,+ };+}++export function buildMeasurementResult(options: BuildMeasurementResultOptions) {+ return {+ schemaVersion: 1,+ benchmark: 'generated-index-full-sweep',+ capturedAt: options.capturedAt,+ commit: options.commit,+ runtime: options.runtime,+ fixture: {+ topology: 'flat',+ documentCount: options.args.documentCount,+ directoryCounts: options.args.directoryCounts,+ warmupRuns: options.args.warmupRuns,+ repetitions: options.args.repetitions,+ },+ cells: options.args.directoryCounts.map((directoryCount) => {+ const expectedIndexCount = directoryCount + 1;+ const samples = options.samples.get(directoryCount);+ if (!samples || samples.length === 0) {+ throw new Error(`missing measurement samples for ${directoryCount} directories`);+ }+ const indexCounts = new Set(samples.map((sample) => sample.indexCount));+ if (indexCounts.size !== 1 || !indexCounts.has(expectedIndexCount)) {+ throw new Error(+ `expected ${expectedIndexCount} generated indexes for ${directoryCount} directories, got ${[+ ...indexCounts,+ ].join(',')}`,+ );+ }+ return {+ directoryCount,+ expectedIndexCount,+ indexCount: expectedIndexCount,+ sweepDurationMs: summarizeDurations(samples.map((sample) => sample.durationMs)),+ };+ }),+ };+}++function writeFixture(projectDir: string, documentCount: number, directoryCount: number): void {+ const okDir = join(projectDir, '.ok');+ mkdirSync(okDir, { recursive: true });+ writeFileSync(+ join(okDir, 'config.yml'),+ stringifyYaml({+ contentRules: { okf: { enabled: true, generate: { index: true } } },+ telemetry: { localSink: { enabled: false } },+ }),+ 'utf8',+ );+ writeFileSync(join(okDir, '.gitignore'), 'local/\n', 'utf8');++ const distribution = distributeDocuments(documentCount, directoryCount);+ const documentWidth = String(documentCount).length;+ const directoryWidth = String(directoryCount).length;+ let documentNumber = 0;+ for (const [directoryIndex, count] of distribution.entries()) {+ const directoryName = `directory-${String(directoryIndex + 1).padStart(directoryWidth, '0')}`;+ const directoryPath = join(projectDir, directoryName);+ mkdirSync(directoryPath, { recursive: true });+ for (let index = 0; index < count; index += 1) {+ documentNumber += 1;+ const label = String(documentNumber).padStart(documentWidth, '0');+ writeFileSync(+ join(directoryPath, `document-${label}.md`),+ `---\ntitle: Document ${label}\ntype: note\n---\n\n# Document ${label}\n`,+ 'utf8',+ );+ }+ }+}++let activeServer: BootedServer | undefined;+let activeProjectDir: string | undefined;++async function cleanupActiveSample(): Promise<void> {+ const server = activeServer;+ activeServer = undefined;+ if (server) await server.destroy().catch(() => undefined);+ const projectDir = activeProjectDir;+ activeProjectDir = undefined;+ if (projectDir) rmSync(projectDir, { recursive: true, force: true });+}++async function measureCell(+ documentCount: number,+ directoryCount: number,+): Promise<MeasurementSample> {+ const projectDir = realpathSync(mkdtempSync(join(tmpdir(), 'ok-generated-index-sweep-')));+ activeProjectDir = projectDir;+ try {+ writeFixture(projectDir, documentCount, directoryCount);+ await ensureProjectGit(projectDir);+ const config = ConfigSchema.parse({+ contentRules: { okf: { enabled: true, generate: { index: true } } },+ telemetry: { localSink: { enabled: false } },+ });+ activeServer = await bootServer({+ config,+ contentDir: projectDir,+ projectDir,+ host: '127.0.0.1',+ port: 0,+ quiet: true,+ gitEnabled: true,+ skipAutoInit: true,+ idleShutdownMs: null,+ skipStateManifestCheck: true,+ });+ await activeServer.ready;+ await activeServer.generatedIndexSweepReady;++ const timings = getBootTimings();+ const durationMs = timings?.generatedIndexSweepMs;+ const indexCount = timings?.generatedIndexCount;+ if (+ typeof durationMs !== 'number' ||+ !Number.isFinite(durationMs) ||+ indexCount === undefined+ ) {+ throw new Error('boot did not report generated-index sweep timings');+ }+ const expectedIndexCount = directoryCount + 1;+ if (indexCount !== expectedIndexCount) {+ throw new Error(`expected ${expectedIndexCount} generated indexes, got ${indexCount}`);+ }+ if (!existsSync(join(projectDir, 'index.md'))) {+ throw new Error('root generated index was not written');+ }+ for (let directoryIndex = 1; directoryIndex <= directoryCount; directoryIndex += 1) {+ const directoryWidth = String(directoryCount).length;+ const directoryName = `directory-${String(directoryIndex).padStart(directoryWidth, '0')}`;+ if (!existsSync(join(projectDir, directoryName, 'index.md'))) {+ throw new Error(`generated index was not written for ${directoryName}`);+ }+ }+ return {+ durationMs,+ indexCount,+ };+ } finally {+ await cleanupActiveSample();+ }+}++async function resolveCommit(): Promise<string> {+ try {+ const { stdout } = await execFileAsync('git', ['rev-parse', '--short', 'HEAD'], {+ cwd: resolve(import.meta.dirname, '../..'),+ });+ return stdout.trim();+ } catch {+ return 'unknown';+ }+}++function assertCampaignActive(signal: AbortSignal): void {+ if (signal.aborted) throw new CampaignInterruptedError('measurement interrupted');+}++async function runCampaign(args: MeasurementArgs, signal: AbortSignal): Promise<void> {+ for (let warmup = 0; warmup < args.warmupRuns; warmup += 1) {+ for (const directoryCount of args.directoryCounts) {+ assertCampaignActive(signal);+ process.stderr.write(+ `warmup ${warmup + 1}/${args.warmupRuns}: ${directoryCount} directories\n`,+ );+ await measureCell(args.documentCount, directoryCount);+ assertCampaignActive(signal);+ }+ }++ const samples = new Map<number, MeasurementSample[]>(+ args.directoryCounts.map((directoryCount) => [directoryCount, []]),+ );+ for (let repetition = 0; repetition < args.repetitions; repetition += 1) {+ const order = repetition % 2 === 0 ? args.directoryCounts : [...args.directoryCounts].reverse();+ for (const directoryCount of order) {+ assertCampaignActive(signal);+ process.stderr.write(+ `measurement ${repetition + 1}/${args.repetitions}: ${directoryCount} directories\n`,+ );+ samples.get(directoryCount)?.push(await measureCell(args.documentCount, directoryCount));+ assertCampaignActive(signal);+ }+ }++ assertCampaignActive(signal);+ const result = buildMeasurementResult({+ args,+ capturedAt: new Date().toISOString(),+ commit: await resolveCommit(),+ runtime: {+ nodeVersion: process.version,+ platform: platform(),+ arch: arch(),+ cpuModel: cpus()[0]?.model ?? 'unknown',+ },+ samples,+ });+ assertCampaignActive(signal);+ process.stdout.write(`${RESULT_PREFIX}${JSON.stringify(result)}\n`);+}++async function main(): Promise<void> {+ loggerFactory.configure({ pinoConfig: { options: { level: 'silent' } } });+ const abortController = new AbortController();+ const shutdown = (exitCode: number) => {+ process.exitCode = exitCode;+ abortController.abort();+ void cleanupActiveSample().catch(() => undefined);+ };+ const handleSigint = () => shutdown(130);+ const handleSigterm = () => shutdown(143);+ process.once('SIGINT', handleSigint);+ process.once('SIGTERM', handleSigterm);+ try {+ await runCampaign(parseMeasurementArgs(process.argv.slice(2)), abortController.signal);+ } finally {+ process.off('SIGINT', handleSigint);+ process.off('SIGTERM', handleSigterm);+ await cleanupActiveSample();+ }+}++if (process.argv[1] && pathToFileURL(resolve(process.argv[1])).href === import.meta.url) {+ main().catch((error: unknown) => {+ const interrupted = process.exitCode === 130 || process.exitCode === 143;+ if (!interrupted) {+ process.exitCode = 1;+ process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);+ }+ });+}diff --git a/packages/server/package.json b/packages/server/package.jsonindex 29d4c0586..52910e913 100644--- a/packages/server/package.json+++ b/packages/server/package.json@@ -72,7 +72,8 @@"build": "tsdown && pnpm run build:skill-bundles","build:skill-bundles": "tsx scripts/build-skill-bundles.ts","typecheck": "tsc --noEmit",- "test": "vitest run"+ "test": "vitest run",+ "measure:generated-index-sweep": "node --import tsx --conditions=development measure-generated-index-sweep.ts"},"devDependencies": {"@types/mdast": "^4.0.4",diff --git a/packages/server/src/api-extension.ts b/packages/server/src/api-extension.tsindex 987572157..9af18ddca 100644--- a/packages/server/src/api-extension.ts+++ b/packages/server/src/api-extension.ts@@ -170,6 +170,8 @@ import {SearchSuccessSchema,SeedApplyRequestSchema,SeedApplySuccessSchema,+ SeedInstallPackSkillRequestSchema,+ SeedInstallPackSkillSuccessSchema,SeedListPacksSuccessSchema,SeedPlanSuccessSchema,SemanticIndexStatusSchema,@@ -679,6 +681,7 @@ import {import {applySeed,coercePackId,+ installPackSkillOnDemand,listStarterPacks,planSeed,type ScaffoldPlan,@@ -2401,6 +2404,20 @@ async function renameTrackedPathInGit(});}+const GeneratedIndexSettingsStatusSchema = z.object({+ enabled: z.boolean(),+ active: z.boolean(),+ git: z.object({+ state: z.enum(['not-applicable', 'ready', 'missing', 'conflict', 'unavailable']),+ ownership: z.enum(['open-knowledge', 'existing']).optional(),+ }),+ applied: z.boolean().optional(),+ reason: z.enum(['git-conflict', 'git-unavailable', 'config-write']).optional(),+});+const GeneratedIndexSettingsRequestSchema = z.object({ enabled: z.boolean() }).strict();++export type GeneratedIndexSettingsStatus = z.infer<typeof GeneratedIndexSettingsStatusSchema>;+export interface ApiExtensionOptions {/*** The boot-built ingress policy. Drives the browser-Origin allowlists (the@@ -2413,6 +2430,9 @@ export interface ApiExtensionOptions {durabilityState: DocumentDurabilityState;sessionManager: AgentSessionManager;contentDir: string;+ /** Read and mutate the config + Git-attribute joint admission state. */+ getGeneratedIndexSettingsStatus?: () => GeneratedIndexSettingsStatus;+ setGeneratedIndexEnabled?: (enabled: boolean) => Promise<GeneratedIndexSettingsStatus>;/*** No-project ephemeral single-file mode. When `true`, the contentDir-tree* write handlers (`PUT /api/folder-config`, `PUT /api/template`) are inert —@@ -2842,6 +2862,8 @@ export function createApiExtension(hocuspocus,sessionManager,contentDir,+ getGeneratedIndexSettingsStatus,+ setGeneratedIndexEnabled,serverInstanceId,getFileIndex,getAttachmentFolderPath,@@ -12246,6 +12268,46 @@ export function createApiExtension(},);+ /**+ * `POST /api/seed/install-pack-skill` — install only a pack's companion+ * skills. It deliberately skips scaffold files and required-plugin changes:+ * the settings card is a separate user-owned install action, not a replay of+ * `ok seed` and not a side effect of the plugin toggle.+ */+ const handleSeedInstallPackSkill = withValidation(+ SeedInstallPackSkillRequestSchema,+ async (_req, res, body) => {+ const packId = coercePackId(body.packId);+ if (packId === undefined) {+ errorResponse(res, 400, 'urn:ok:error:invalid-request', 'Unknown packId.', {+ handler: 'seed-install-pack-skill',+ detail: `Pack id "${body.packId}" is not registered.`,+ });+ return;+ }+ try {+ const result = await installPackSkillOnDemand(contentDir, packId);+ successResponse(res, 200, SeedInstallPackSkillSuccessSchema, result, {+ handler: 'seed-install-pack-skill',+ });+ } catch (err) {+ errorResponse(+ res,+ 500,+ 'urn:ok:error:internal-server-error',+ 'Failed to install pack skill.',+ { handler: 'seed-install-pack-skill', cause: err },+ );+ }+ },+ {+ handler: 'seed-install-pack-skill',+ method: 'POST',+ preBodyGate: (req, res) =>+ checkLocalOpSecurity(req, res, { handler: 'seed-install-pack-skill' }),+ },+ );+/*** `GET /api/seed/packs` — enumerate available starter packs. Static data;* no project context required. The picker UI fetches once on dialog mount.@@ -21946,9 +22008,56 @@ export function createApiExtension(handleSkillsResolveRef,} = createSkillsShHandlers({ log, skillsHome, projectDir, contentDir, resolveSkillDirForRead });+ const handleGetGeneratedIndexSettings = withValidation(+ EmptyRequestSchema,+ async (_req, res) => {+ if (!getGeneratedIndexSettingsStatus) {+ errorResponse(res, 404, 'urn:ok:error:not-found', 'Not found.', {+ handler: 'generated-index-settings-get',+ });+ return;+ }+ successResponse(+ res,+ 200,+ GeneratedIndexSettingsStatusSchema,+ getGeneratedIndexSettingsStatus(),+ {+ handler: 'generated-index-settings-get',+ extraHeaders: { 'Cache-Control': 'no-store' },+ },+ );+ },+ { handler: 'generated-index-settings-get', method: 'GET', skipBodyParse: true },+ );++ const handleSetGeneratedIndexSettings = withValidation(+ GeneratedIndexSettingsRequestSchema,+ async (_req, res, body) => {+ if (!setGeneratedIndexEnabled) {+ errorResponse(res, 404, 'urn:ok:error:not-found', 'Not found.', {+ handler: 'generated-index-settings-set',+ });+ return;+ }+ const result = await setGeneratedIndexEnabled(body.enabled);+ successResponse(res, 200, GeneratedIndexSettingsStatusSchema, result, {+ handler: 'generated-index-settings-set',+ extraHeaders: { 'Cache-Control': 'no-store' },+ });+ },+ { handler: 'generated-index-settings-set', method: 'POST' },+ );++ const handleGeneratedIndexSettings = methodRouter(+ { GET: handleGetGeneratedIndexSettings, POST: handleSetGeneratedIndexSettings },+ { handler: 'generated-index-settings' },+ );+const routes: Record<string, (req: IncomingMessage, res: ServerResponse) => Promise<void>> = {'/api/config': handleApiConfig,'/api/config/diagnostics': handleConfigDiagnostics,+ '/api/generated-index/settings': handleGeneratedIndexSettings,'/api/comments': handleCommentsRoute,'/api/comment': handleCommentRoute,'/api/asset': handleAsset,@@ -22052,6 +22161,7 @@ export function createApiExtension('/api/skill/install-state': handleSkillInstallState,'/api/seed/plan': handleSeedPlan,'/api/seed/apply': handleSeedApply,+ '/api/seed/install-pack-skill': handleSeedInstallPackSkill,'/api/seed/packs': handleSeedPacks,'/api/client-logs': handleClientLogs,};@@ -22076,6 +22186,7 @@ export function createApiExtension('/api/lint/markdownlint-config','/api/lint/frontmatter-schema','/api/lint/fix',+ '/api/generated-index/settings','/api/create-page','/api/create-folder','/api/duplicate-path',@@ -22126,6 +22237,7 @@ export function createApiExtension('/api/skills/resolve-ref','/api/skill-targets','/api/seed/apply',+ '/api/seed/install-pack-skill','/api/client-logs',]);// Every `/api/local-op/*` endpoint mutates local filesystem state ordiff --git a/packages/server/src/boot-timings.test.ts b/packages/server/src/boot-timings.test.tsindex 75328a6d4..362459d6f 100644--- a/packages/server/src/boot-timings.test.ts+++ b/packages/server/src/boot-timings.test.ts@@ -28,6 +28,8 @@ describe('boot-timings', () => {expect(t?.httpListenMs).toBeUndefined();expect(t?.readyMs).toBeUndefined();expect(t?.fileCount).toBeUndefined();+ expect(t?.generatedIndexSweepMs).toBeUndefined();+ expect(t?.generatedIndexCount).toBeUndefined();// The monotonic clock is armed, so bootElapsedMs is a finite number.expect(typeof bootElapsedMs()).toBe('number');expect(bootElapsedMs()).toBeGreaterThanOrEqual(0);@@ -46,6 +48,7 @@ describe('boot-timings', () => {recordBootPhase('httpListenMs', 12);recordBootPhase('seedWalkMs', 34);recordBootPhase('indexesMs', 56);+ recordBootPhase('generatedIndexSweepMs', 67.5);recordBootPhase('readyMs', 78);const t = getBootTimings();expect(t).toMatchObject({@@ -53,20 +56,24 @@ describe('boot-timings', () => {httpListenMs: 12,seedWalkMs: 34,indexesMs: 56,+ generatedIndexSweepMs: 67.5,readyMs: 78,});});- test('setBootField records the bounded file count', () => {+ test('setBootField records bounded boot counts', () => {startBootTimings('2026-06-30T00:00:00.000Z');setBootField('fileCount', 42);+ setBootField('generatedIndexCount', 7);expect(getBootTimings()?.fileCount).toBe(42);+ expect(getBootTimings()?.generatedIndexCount).toBe(7);});test('recordBootPhase / setBootField are no-ops before startBootTimings', () => {resetBootTimingsForTest();recordBootPhase('httpListenMs', 99);setBootField('fileCount', 99);+ setBootField('generatedIndexCount', 99);expect(getBootTimings()).toBeUndefined();});@@ -81,9 +88,13 @@ describe('boot-timings', () => {test('a fresh startBootTimings drops prior phase values', () => {startBootTimings('2026-06-30T00:00:00.000Z');recordBootPhase('httpListenMs', 12);+ recordBootPhase('generatedIndexSweepMs', 23);+ setBootField('generatedIndexCount', 4);startBootTimings('2026-06-30T01:00:00.000Z');const t = getBootTimings();expect(t?.startedAt).toBe('2026-06-30T01:00:00.000Z');expect(t?.httpListenMs).toBeUndefined();+ expect(t?.generatedIndexSweepMs).toBeUndefined();+ expect(t?.generatedIndexCount).toBeUndefined();});});diff --git a/packages/server/src/boot-timings.ts b/packages/server/src/boot-timings.tsindex fbd2b899f..849ce68fd 100644--- a/packages/server/src/boot-timings.ts+++ b/packages/server/src/boot-timings.ts@@ -9,7 +9,7 @@* record independently without passing a context object through the boot* call graph.*- * All fields are BOUNDED numbers — millisecond durations, a file count, and+ * All fields are BOUNDED numbers — millisecond durations, boot counts, and* one ISO wall-clock string for cross-process alignment. No raw paths, doc* content, or free-form strings ever land here, so the object is safe to put* on the `/api/server-info` envelope and (downstream) on the desktop startup@@ -28,10 +28,14 @@ export interface BootTimings {seedWalkMs?: number;/** Combined duration of the boot-time index phases (backlink + tag + basename). */indexesMs?: number;+ /** Duration of the generated-index full sweep performed during boot. */+ generatedIndexSweepMs?: number;/** Time from boot start until the `ready` promise resolved (end of initAsync). */readyMs?: number;/** Number of markdown files in the watcher's file index at ready time. */fileCount?: number;+ /** Number of generated indexes selected by the boot-time full sweep. */+ generatedIndexCount?: number;}let current: BootTimings | undefined;@@ -61,12 +65,12 @@ export function bootElapsedMs(): number | undefined {/*** Record a single phase duration (ms). No-op if {@link startBootTimings} hasn't- * run. The key excludes `fileCount` (a count, not a duration) so the- * duration/count boundary is enforced at compile time — counts go through+ * run. The key excludes count fields so the duration/count boundary is+ * enforced at compile time — counts go through* {@link setBootField}.*/export function recordBootPhase(- name: Exclude<keyof BootTimings, 'startedAt' | 'fileCount'>,+ name: Exclude<keyof BootTimings, 'startedAt' | 'fileCount' | 'generatedIndexCount'>,ms: number,): void {if (!current) return;@@ -74,10 +78,10 @@ export function recordBootPhase(}/**- * Set a non-duration bounded field (e.g. `fileCount`). Kept distinct from+ * Set a non-duration bounded count. Kept distinct from* {@link recordBootPhase} so the duration-only fields stay typed as such.*/-export function setBootField(name: 'fileCount', value: number): void {+export function setBootField(name: 'fileCount' | 'generatedIndexCount', value: number): void {if (!current) return;current[name] = value;}diff --git a/packages/server/src/boot.ts b/packages/server/src/boot.tsindex 679031ff6..ff5b920a5 100644--- a/packages/server/src/boot.ts+++ b/packages/server/src/boot.ts@@ -382,6 +382,8 @@ export interface BootedServer {port: number;/** Resolves when async server init (shadow repo, file watcher subscription) completes. */ready: Promise<void>;+ /** Settles after the post-readiness generated-index boot sweep. */+ generatedIndexSweepReady: ServerInstance['generatedIndexSweepReady'];/** Subsystems that failed to initialize — read AFTER `ready` for a stable list. */degraded: readonly string[];/** `true` if `autoInitFn` scaffolded anything during this boot. */@@ -1450,6 +1452,7 @@ async function bootServerInner(opts: BootServerOptions): Promise<BootedServer> {contentDir: opts.contentDir,port: realPort,ready,+ generatedIndexSweepReady: serverInstance.generatedIndexSweepReady,degraded,didAutoInit,serverInstance,diff --git a/packages/server/src/bridge-loss-suppression.ts b/packages/server/src/bridge-loss-suppression.tsindex 2d979c9ec..0f7aab087 100644--- a/packages/server/src/bridge-loss-suppression.ts+++ b/packages/server/src/bridge-loss-suppression.ts@@ -58,6 +58,10 @@ export const PAIRED_INTAKE_DETECTION: Record<string, PairedIntakeDetectionEntry>mode: 'suppress',why: 'A read-only snapshot capture that makes no Y.Doc mutation, so no content can be lost.',},+ 'generated-index': {+ mode: 'suppress',+ why: 'A rebuild of a file OK authors: its content is derived from the other documents, and replacing a hand edit is the stated contract of generating it, not a loss.',+ },};/**diff --git a/packages/server/src/content/enrichment.test.ts b/packages/server/src/content/enrichment.test.tsindex 74dcf26bb..636ce143c 100644--- a/packages/server/src/content/enrichment.test.ts+++ b/packages/server/src/content/enrichment.test.ts@@ -2,6 +2,7 @@ import { mkdirSync, utimesSync, writeFileSync } from 'node:fs';import { mkdtemp, rm } from 'node:fs/promises';import { tmpdir } from 'node:os';import { resolve } from 'node:path';+import { okfAdvertisedSchemaMappings } from '@inkeep/open-knowledge-core';import { commitWip, initShadowRepo, type WriterIdentity } from '@inkeep/open-knowledge-server';import simpleGit from 'simple-git';import { afterEach, beforeEach, describe, expect, test } from 'vitest';@@ -336,6 +337,64 @@ describe('schemas_applicable — read-time schema advertisement', () => {expect(meta.schemas_applicable).toEqual(['.ok/schemas/doc.schema.json']);});+ test('the OKF profile advertises by path, scoped per document', async () => {+ // The OKF plugin contributes built-in schemas with no files on disk, so they+ // advertise under `okf:` identifiers instead of paths. Enrichment must treat+ // them as ordinary mappings — this is the only automated proof that the+ // built-in profile reaches an agent at read time at all.+ const project = await bootstrapProject();+ mkdirSync(resolve(project, 'notes'), { recursive: true });+ writeFileSync(resolve(project, 'notes', 'concept.md'), '---\ntype: Metric\n---\n');+ writeFileSync(resolve(project, 'index.md'), '---\nokf_version: "0.2"\n---\n');+ writeFileSync(resolve(project, 'notes', 'index.md'), '# Notes\n');+ writeFileSync(resolve(project, 'log.md'), '---\ntype: Log\n---\n');++ const advertise = async (path: string) =>+ (+ await enrichPath(path, {+ projectDir: project,+ frontmatterSchemas: okfAdvertisedSchemaMappings(undefined),+ })+ ).schemas_applicable;++ // A concept is governed by the four unscoped families. Advertised by PATH, so an+ // agent that sees one of these can open it and read the contract.+ expect(await advertise('notes/concept.md')).toEqual([+ '.ok/okf/required.schema.json',+ '.ok/okf/recommended.schema.json',+ '.ok/okf/provenance.schema.json',+ '.ok/okf/computation.schema.json',+ ]);+ // The two index scopes are disjoint: root gets the version schema, nested+ // gets the no-frontmatter one, and neither gets both — which is what keeps+ // them from being jointly unsatisfiable on the root index.+ expect(await advertise('index.md')).toEqual(['.ok/okf/root-index.schema.json']);+ expect(await advertise('notes/index.md')).toEqual(['.ok/okf/reserved-index.schema.json']);+ // A log carries no frontmatter schema at all, so it advertises nothing.+ expect(await advertise('log.md')).toBeUndefined();+ });++ test('a rule switched off stops advertising its schema', async () => {+ // Advertisement and enforcement read the same toggle map, so a rule the user+ // turned off must not still be announced as governing the document.+ const project = await bootstrapProject();+ mkdirSync(resolve(project, 'notes'), { recursive: true });+ writeFileSync(resolve(project, 'notes', 'concept.md'), '---\ntype: Metric\n---\n');+ const meta = await enrichPath('notes/concept.md', {+ projectDir: project,+ // No cast here on purpose: the rule-id keys are typed, so a stale or+ // misspelled id is a compile error rather than a silently-ignored key.+ frontmatterSchemas: okfAdvertisedSchemaMappings({+ 'frontmatter-provenance': false,+ 'frontmatter-computation': false,+ }),+ });+ expect(meta.schemas_applicable).toEqual([+ '.ok/okf/required.schema.json',+ '.ok/okf/recommended.schema.json',+ ]);+ });+test('a disabled mapping is not advertised', async () => {// A parked mapping still resolves (the schema editor reads it) but must// not reach agents, or a toggled-off schema would read as governing.diff --git a/packages/server/src/content/generate-index-conformance.test.ts b/packages/server/src/content/generate-index-conformance.test.tsnew file mode 100644index 000000000..47684cc44--- /dev/null+++ b/packages/server/src/content/generate-index-conformance.test.ts@@ -0,0 +1,200 @@+/**+ * The acceptance harness for the generator: whatever it emits must satisfy the+ * `okf` plugin that checks for it, and every link it writes must resolve.+ *+ * Both halves matter independently. The lint half proves the output conforms to+ * the format; the link half proves it conforms to THIS substrate — a bare folder+ * href passes every OKF rule while reading as broken to our own validator,+ * which is exactly the trap the hand-written seeded index fell into.+ */++import {+ DEFAULT_LINTER_CONFIG,+ type LinterConfig,+ lintDocument,+} from '@inkeep/open-knowledge-core';+import { describe, expect, test } from 'vitest';+import { computeBrokenOutboundLinks } from '../backlink-index.ts';+import { buildIndexMarkdown, type IndexEntry } from './generate-index.ts';++// Only `okf` is on: this suite is about OKF conformance, and folding in+// markdownlint or frontmatter findings would blur which contract regressed.+const OKF_LINT_CONFIG: LinterConfig = {+ ...DEFAULT_LINTER_CONFIG,+ enabled: true,+ plugins: { ...DEFAULT_LINTER_CONFIG.plugins, okf: { enabled: true } },+};++/** A bundle broad enough to exercise every branch the formatter has. */+const ENTRIES: IndexEntry[] = [+ {+ path: 'welcome.md',+ title: 'Welcome',+ description: 'what this knowledge base is and how it is organized',+ type: 'note',+ },+ {+ path: 'concepts/bounded-context.md',+ title: 'Bounded Context',+ description: 'where a model stops applying',+ type: 'concept',+ },+ {+ path: 'concepts/ubiquitous-language.md',+ title: 'Ubiquitous Language',+ description: undefined,+ type: 'concept',+ },+ { path: 'scratch.md', title: 'Scratch', description: undefined, type: undefined },+];++const ADMITTED = ['index', ...ENTRIES.map((e) => e.path.replace(/\.md$/, ''))];++describe('generated index — OKF conformance', () => {+ test('the generated root index produces zero okf findings', async () => {+ const markdown = buildIndexMarkdown(ENTRIES, { isRoot: true });++ // Lint under the reserved name, since index-shape, frontmatter-root-index+ // and reserved-casing are all name-scoped — linting it as any other doc+ // would silently skip the rules this output has to satisfy.+ const findings = await lintDocument(markdown, OKF_LINT_CONFIG, 'index.md');+ const detail = findings+ .map((f) => `${f.code} @ ${f.range.start.line + 1} — ${f.message}`)+ .join('; ');++ expect(findings, `generated root index produced okf findings: ${detail}`).toEqual([]);+ });++ test('a generated non-root index produces zero okf findings', async () => {+ // Not generated today (scope is root-only), but the formatter already takes+ // isRoot and the rule that governs a nested index is stricter than the+ // root's: frontmatter-reserved-index pins maxProperties 0, so a stray+ // okf_version here would warn. Pin it now, while the branch is cheap.+ const markdown = buildIndexMarkdown(ENTRIES, { isRoot: false });+ const findings = await lintDocument(markdown, OKF_LINT_CONFIG, 'concepts/index.md');++ expect(findings.map((f) => f.code)).toEqual([]);+ });++ test('an empty bundle still yields a conformant root index', async () => {+ const markdown = buildIndexMarkdown([], { isRoot: true });+ const findings = await lintDocument(markdown, OKF_LINT_CONFIG, 'index.md');+ expect(findings.map((f) => f.code)).toEqual([]);+ });++ test('every link in the generated index resolves', () => {+ const markdown = buildIndexMarkdown(ENTRIES, { isRoot: true });+ const broken = computeBrokenOutboundLinks(markdown, 'index', ADMITTED);++ expect(+ broken,+ `generated index emitted unresolvable links: ${broken.map((b) => b.href).join(', ')}`,+ ).toEqual([]);+ });++ test('a bare folder href would be caught — the guard is not vacuous', () => {+ // The discriminating check: prove computeBrokenOutboundLinks actually fires+ // on the form we deliberately avoid. Without this, the assertion above+ // passes just as well against a generator that emits nothing at all.+ const withFolderLink = ['# concept', '', '* [concepts/](./concepts/) - a folder', ''].join(+ '\n',+ );+ const broken = computeBrokenOutboundLinks(withFolderLink, 'index', ADMITTED);++ expect(broken.map((b) => b.href)).toEqual(['./concepts/']);+ });+});++// Kept separate from the okf-only config above rather than folded into it: which+// contract a finding belongs to stays legible, and these are different claims.+// The okf suite asks whether the output conforms to the FORMAT; this one asks+// whether it conforms to the LINT PROFILE the author is running, which is what+// decides if a generated file they cannot hand-edit shows up in their Problems+// list. Conforming to one does not imply the other — multiple level-one section+// headings satisfy every okf rule and are MD025.+const DEFAULT_PROFILE_LINT_CONFIG: LinterConfig = {+ ...DEFAULT_LINTER_CONFIG,+ enabled: true,+ plugins: {+ ...DEFAULT_LINTER_CONFIG.plugins,+ markdownlint: { ...DEFAULT_LINTER_CONFIG.plugins.markdownlint, enabled: true },+ okf: { enabled: true },+ },+};++async function findingCodes(markdown: string, docName: string): Promise<string[]> {+ const findings = await lintDocument(markdown, DEFAULT_PROFILE_LINT_CONFIG, docName);+ return findings.map((f) => `${f.code} @ ${f.range.start.line + 1} — ${f.message}`);+}++describe('generated index — default lint profile', () => {+ test('the generated root index is clean under markdownlint defaults', async () => {+ expect(await findingCodes(buildIndexMarkdown(ENTRIES, { isRoot: true }), 'index.md')).toEqual(+ [],+ );+ });++ test('a generated non-root index is clean under markdownlint defaults', async () => {+ expect(+ await findingCodes(buildIndexMarkdown(ENTRIES, { isRoot: false }), 'concepts/index.md'),+ ).toEqual([]);+ });++ test('an empty bundle is clean under markdownlint defaults', async () => {+ expect(await findingCodes(buildIndexMarkdown([], { isRoot: true }), 'index.md')).toEqual([]);+ });++ test('a Subdirectories document type plus a child directory is clean under markdownlint defaults', async () => {+ const markdown = buildIndexMarkdown(+ [+ {+ path: 'concepts/directory-notes.md',+ title: 'Directory notes',+ type: 'Subdirectories',+ },+ ],+ {+ isRoot: false,+ directory: 'concepts',+ subdirectories: [{ path: 'concepts/nested/index.md', title: 'nested' }],+ },+ );++ expect(await findingCodes(markdown, 'concepts/index.md')).toEqual([]);+ });++ test('level-one sections would be caught — the guard is not vacuous', async () => {+ // The shape this generator used to emit. Proving it still fires is what+ // keeps the assertions above from passing under a linter that silently+ // stopped running markdownlint at all — the exact way this gap went unseen.+ const levelOneSections = [+ '---',+ 'okf_version: "0.2"',+ '---',+ '',+ '# concept',+ '',+ '* [Bounded Context](./concepts/bounded-context.md) - where a model stops applying',+ '',+ '# note',+ '',+ '* [Welcome](./welcome.md) - what this knowledge base is',+ '',+ ].join('\n');++ expect(await findingCodes(levelOneSections, 'index.md')).toEqual([+ expect.stringContaining('MD025'),+ ]);+ });++ test('demoting sections without a title would be caught too', async () => {+ // The other half of the squeeze: sections at level two and no level-one+ // heading trips MD041 instead. Pinning both is what makes the title and the+ // section level jointly load-bearing rather than one arbitrary choice.+ const noTitle = ['## concept', '', '* [Bounded Context](./concepts/bounded-context.md)', ''];++ expect(await findingCodes(noTitle.join('\n'), 'concepts/index.md')).toEqual([+ expect.stringContaining('MD041'),+ ]);+ });+});diff --git a/packages/server/src/content/generate-index.test.ts b/packages/server/src/content/generate-index.test.tsnew file mode 100644index 000000000..0dfbfbe10--- /dev/null+++ b/packages/server/src/content/generate-index.test.ts@@ -0,0 +1,322 @@+import { describe, expect, test } from 'vitest';+import { buildIndexMarkdown, type IndexEntry } from './generate-index.ts';++function entry(overrides: Partial<IndexEntry> & Pick<IndexEntry, 'path' | 'title'>): IndexEntry {+ return { description: undefined, type: undefined, ...overrides };+}++describe('buildIndexMarkdown', () => {+ test('groups entries under a heading per declared type', () => {+ const out = buildIndexMarkdown(+ [+ entry({ path: 'concepts/a.md', title: 'Alpha', type: 'concept' }),+ entry({ path: 'notes/b.md', title: 'Beta', type: 'note' }),+ entry({ path: 'concepts/c.md', title: 'Gamma', type: 'concept' }),+ ],+ { isRoot: false },+ );++ expect(out).toBe(+ [+ '# Index',+ '',+ '## concept',+ '',+ '* [Alpha](./concepts/a.md)',+ '* [Gamma](./concepts/c.md)',+ '',+ '## note',+ '',+ '* [Beta](./notes/b.md)',+ '',+ ].join('\n'),+ );+ });++ test('exactly one top-level heading, whatever the entries', () => {+ // Several level-one headings in one file is MD025, which markdownlint's+ // default profile has on. The section level is therefore load-bearing, not+ // cosmetic: it is what keeps a generated file from lighting up the Problems+ // list in a project the author cannot edit their way out of.+ for (const entries of [+ [],+ [entry({ path: 'a.md', title: 'A', type: 'note' })],+ [+ entry({ path: 'a.md', title: 'A', type: 'note' }),+ entry({ path: 'b.md', title: 'B', type: 'concept' }),+ entry({ path: 'c.md', title: 'C' }),+ ],+ ]) {+ for (const isRoot of [true, false]) {+ const out = buildIndexMarkdown(entries, { isRoot });+ expect(out.match(/^# .+$/gm), `isRoot=${isRoot}, ${entries.length} entries`).toEqual([+ '# Index',+ ]);+ }+ }+ });++ test('a document with no type lands in Other', () => {+ const out = buildIndexMarkdown([entry({ path: 'scratch.md', title: 'Scratch' })], {+ isRoot: false,+ });+ expect(out).toContain('## Other');+ });++ test('a blank or whitespace-only type is treated as absent, not as its own section', () => {+ const out = buildIndexMarkdown(+ [+ entry({ path: 'a.md', title: 'A', type: ' ' }),+ entry({ path: 'b.md', title: 'B', type: '' }),+ ],+ { isRoot: false },+ );+ expect(out.match(/^## .+$/gm)).toEqual(['## Other']);+ });++ test('sections sort alphabetically and entries sort by title case-insensitively', () => {+ const out = buildIndexMarkdown(+ [+ entry({ path: 'z.md', title: 'zebra', type: 'note' }),+ entry({ path: 'a.md', title: 'Apple', type: 'note' }),+ entry({ path: 'm.md', title: 'mango', type: 'concept' }),+ ],+ { isRoot: false },+ );++ const headings = out.match(/^## .+$/gm);+ expect(headings).toEqual(['## concept', '## note']);+ // 'Apple' before 'zebra' requires the comparison to ignore case; a+ // case-sensitive sort puts every capitalized title first.+ expect(out.indexOf('Apple')).toBeLessThan(out.indexOf('zebra'));+ });++ test('the description suffix is omitted entirely when there is no description', () => {+ const out = buildIndexMarkdown(+ [+ entry({ path: 'a.md', title: 'A', type: 'note', description: 'has one' }),+ entry({ path: 'b.md', title: 'B', type: 'note' }),+ ],+ { isRoot: false },+ );++ expect(out).toContain('* [A](./a.md) - has one');+ expect(out).toContain('* [B](./b.md)\n');+ expect(out).not.toContain('* [B](./b.md) -');+ });++ test('a multi-line description collapses to one line so it cannot break the list item', () => {+ const out = buildIndexMarkdown(+ [entry({ path: 'a.md', title: 'A', type: 'note', description: 'first\nsecond third' })],+ { isRoot: false },+ );++ expect(out).toContain('* [A](./a.md) - first second third');+ expect(out.split('\n').filter((line) => line.startsWith('* '))).toHaveLength(1);+ });++ test('the root index carries a quoted okf_version and a non-root index carries no frontmatter', () => {+ const entries = [entry({ path: 'a.md', title: 'A', type: 'note' })];++ const root = buildIndexMarkdown(entries, { isRoot: true });+ expect(root.startsWith('---\nokf_version: "0.2"\n---\n\n')).toBe(true);++ const nested = buildIndexMarkdown(entries, { isRoot: false });+ expect(nested.startsWith('---')).toBe(false);+ });++ test('links are relative with the extension retained, never a bare folder', () => {+ const out = buildIndexMarkdown(+ [entry({ path: 'concepts/nested/deep.md', title: 'Deep', type: 'concept' })],+ { isRoot: false },+ );++ expect(out).toContain('](./concepts/nested/deep.md)');+ // A trailing-slash href resolves to a DOCUMENT of that name — there is no+ // folder variant in ClassifiedLinkTarget — so it would read as broken.+ expect(out).not.toMatch(/]\(\.\/[^)]*\/\)/);+ });++ test('an empty project yields the title alone rather than an invented section', () => {+ expect(buildIndexMarkdown([], { isRoot: true })).toBe(+ '---\nokf_version: "0.2"\n---\n\n# Index\n',+ );+ expect(buildIndexMarkdown([], { isRoot: false })).toBe('# Index\n');+ });++ test('the same entries in any input order produce identical bytes', () => {+ const entries = [+ entry({ path: 'b.md', title: 'Beta', type: 'note', description: 'second' }),+ entry({ path: 'a.md', title: 'Alpha', type: 'concept' }),+ entry({ path: 'c.md', title: 'Gamma', type: 'note' }),+ ];++ // The write guard compares bytes to decide whether to touch the file, so an+ // ordering that depends on input order would make every rebuild a write.+ const forward = buildIndexMarkdown(entries, { isRoot: true });+ const reversed = buildIndexMarkdown([...entries].reverse(), { isRoot: true });+ expect(reversed).toBe(forward);+ });++ test('escapes link labels and encodes path segments without changing separators', () => {+ const out = buildIndexMarkdown(+ [+ entry({+ path: 'notes/team plan (draft) #1.md',+ title: 'A [plan]\nfor \\ everyone',+ type: 'note',+ }),+ ],+ { isRoot: false },+ );++ expect(out).toContain(+ '* [A \\[plan\\] for \\\\ everyone](./notes/team%20plan%20%28draft%29%20%231.md)',+ );+ });++ test('equal case-folded titles use normalized paths as a deterministic tie-breaker', () => {+ const entries = [+ entry({ path: 'zeta.md', title: 'Same', type: 'note' }),+ entry({ path: 'alpha.md', title: 'same', type: 'note' }),+ ];++ const forward = buildIndexMarkdown(entries, { isRoot: false });+ const reversed = buildIndexMarkdown([...entries].reverse(), { isRoot: false });++ expect(reversed).toBe(forward);+ expect(forward.indexOf('./alpha.md')).toBeLessThan(forward.indexOf('./zeta.md'));+ });++ test('collapses multiline section names into one heading', () => {+ const out = buildIndexMarkdown([entry({ path: 'a.md', title: 'A', type: 'project\n plan' })], {+ isRoot: false,+ });++ expect(out.match(/^## .+$/gm)).toEqual(['## project plan']);+ });++ test('renders a subdirectory section alongside type sections, relative to the index directory', () => {+ const out = buildIndexMarkdown(+ [+ entry({ path: 'concepts/bounded-context.md', title: 'Bounded Context', type: 'concept' }),+ entry({ path: 'concepts/aggregate.md', title: 'Aggregate', type: 'concept' }),+ ],+ {+ isRoot: false,+ directory: 'concepts',+ subdirectories: [{ path: 'concepts/nested/index.md', title: 'nested' }],+ },+ );++ expect(out).toBe(+ [+ '# Index',+ '',+ '## concept',+ '',+ // Rebased to the index's own directory: 'concepts/aggregate.md' -> './aggregate.md'.+ '* [Aggregate](./aggregate.md)',+ '* [Bounded Context](./bounded-context.md)',+ '',+ '## Subdirectories',+ '',+ '* [nested](./nested/index.md)',+ '',+ ].join('\n'),+ );+ });++ test('merges documents typed Subdirectories with child-directory links under one heading', () => {+ const out = buildIndexMarkdown(+ [+ entry({+ path: 'concepts/directory-notes.md',+ title: 'Directory notes',+ type: 'Subdirectories',+ }),+ ],+ {+ isRoot: false,+ directory: 'concepts',+ subdirectories: [{ path: 'concepts/nested/index.md', title: 'nested' }],+ },+ );++ expect(out).toBe(+ [+ '# Index',+ '',+ '## Subdirectories',+ '',+ '* [Directory notes](./directory-notes.md)',+ '* [nested](./nested/index.md)',+ '',+ ].join('\n'),+ );+ expect(out.match(/^## Subdirectories$/gm)).toHaveLength(1);+ });++ test('a container directory with markdown only below it lists subdirectories and no type section', () => {+ const out = buildIndexMarkdown([], {+ isRoot: false,+ directory: 'concepts',+ subdirectories: [{ path: 'concepts/nested/index.md', title: 'nested' }],+ });++ expect(out).toBe(+ ['# Index', '', '## Subdirectories', '', '* [nested](./nested/index.md)', ''].join('\n'),+ );+ // A child link targets the child index document; a trailing-slash folder+ // href resolves to a document of that name and reads as broken.+ expect(out).not.toMatch(/]\(\.\/[^)]*\/\)/);+ expect(out.match(/^# .+$/gm)).toEqual(['# Index']);+ });++ test('exactly one top-level heading even when a subdirectory section is present', () => {+ for (const isRoot of [true, false]) {+ const out = buildIndexMarkdown(+ [+ entry({ path: 'concepts/a.md', title: 'A', type: 'note' }),+ entry({ path: 'concepts/b.md', title: 'B', type: 'concept' }),+ entry({ path: 'concepts/c.md', title: 'C' }),+ ],+ {+ isRoot,+ directory: 'concepts',+ subdirectories: [+ { path: 'concepts/x/index.md', title: 'x' },+ { path: 'concepts/y/index.md', title: 'y' },+ ],+ },+ );++ expect(out.match(/^# .+$/gm), `isRoot=${isRoot}`).toEqual(['# Index']);+ expect(out).toContain('## Subdirectories');+ }+ });++ test('subdirectories and entries in any input order produce identical bytes', () => {+ const entries = [+ entry({ path: 'concepts/b.md', title: 'Beta', type: 'note' }),+ entry({ path: 'concepts/a.md', title: 'Alpha', type: 'concept' }),+ ];+ const subdirectories = [+ { path: 'concepts/zeta/index.md', title: 'zeta' },+ { path: 'concepts/alpha/index.md', title: 'alpha' },+ ];++ const forward = buildIndexMarkdown(entries, {+ isRoot: false,+ directory: 'concepts',+ subdirectories,+ });+ const reversed = buildIndexMarkdown([...entries].reverse(), {+ isRoot: false,+ directory: 'concepts',+ subdirectories: [...subdirectories].reverse(),+ });++ expect(reversed).toBe(forward);+ });+});diff --git a/packages/server/src/content/generate-index.ts b/packages/server/src/content/generate-index.tsnew file mode 100644index 000000000..6e9e69300--- /dev/null+++ b/packages/server/src/content/generate-index.ts@@ -0,0 +1,248 @@+/**+ * Builds the body of a generated OKF `index.md`.+ *+ * The rule, stated once so widening the scope later does not restate it:+ *+ * An index lists every document at or below its folder that is not already+ * covered by a nested index, grouped by `type`. It links to a subdirectory+ * only when that subdirectory has its own index.+ *+ * Each index lists the documents directly in its own directory and links to the+ * immediate child directories that carry their own index. Paths arrive+ * content-root-relative and render relative to the index's directory, so an+ * index in `concepts/` links `./bounded-context.md`, not `./concepts/...`.+ *+ * Grouping by `type` follows the group indexes in the bundles vendored under+ * `../markdown/lint/rules/okf-reference/`, which head each section with the+ * `type` its directory holds. Their ROOT indexes do something different — a+ * single `Subdirectories` section linking to child indexes — which is what a+ * container directory here renders alongside its type sections.+ *+ * Formatting is pure and lives here alone; the write path is+ * `regenerate-index.ts`. Splitting them keeps every shape decision testable+ * without a server, a disk, or a Y.Doc.+ */++/** One document as the index renders it. `path` is content-root-relative. */+export interface IndexEntry {+ path: string;+ title: string;+ description?: string | undefined;+ type?: string | undefined;+}++/**+ * One immediate child directory, linking to its own generated index. `path` is+ * the content-root-relative path of that child's index document, so it rebases+ * exactly like a document entry; a bare folder path would read as broken (see+ * `toHref`).+ */+export interface SubdirectoryEntry {+ path: string;+ /** Link label — the child directory's name. */+ title: string;+}++export interface BuildIndexOptions {+ /**+ * Root indexes are the only ones the format permits frontmatter on, and the+ * only place `okf_version` may appear. A non-root index carrying any key at+ * all is a violation (`frontmatter-reserved-index` pins `maxProperties: 0`).+ */+ isRoot: boolean;+ /**+ * Content-root-relative directory this index lives in; '' (the default) is the+ * root. Entry and subdirectory paths render relative to it. Kept distinct from+ * `isRoot` because that flag governs frontmatter while this governs rebasing.+ */+ directory?: string | undefined;+ /**+ * Immediate child directories that have an index of their own. Rendered as a+ * single `## Subdirectories` section; a directory with none omits the section.+ */+ subdirectories?: readonly SubdirectoryEntry[] | undefined;+}++/**+ * The version this generator writes. A quoted `major.minor` string, which is+ * what `frontmatter-root-index` pins via `^[0-9]+\.[0-9]+$` — unquoted, YAML+ * reads `0.2` as a float and a trailing zero would not survive a round trip.+ */+const GENERATED_OKF_VERSION = '0.2';++/** Section for documents whose frontmatter declares no `type`. */+const UNTYPED_SECTION = 'Other';++/**+ * Heading for the section that links to child directories. Named for the+ * relationship rather than a `type`, matching the reference agent's root index.+ */+const SUBDIRECTORY_SECTION = 'Subdirectories';++/**+ * The index's one top-level heading; `type` sections sit under it at level two.+ *+ * Sections cannot themselves be level one. Several of them in one file is+ * `MD025`, and markdownlint's default profile — which OK matches 1:1 and layers+ * nothing onto — has that rule on. Demoting sections without adding a title+ * instead trips `MD041`, which wants the first line to be a top-level heading.+ * One title plus level-two sections satisfies both, and is the shape the+ * hand-written index this generator replaced already used.+ *+ * Not localized, and not merely because this is file content rather than UI: the+ * bytes are the fixed point the write guard compares against, so a title that+ * varied by host locale would make every rebuild a write on a differently+ * configured machine — the same failure the locale-independent sort avoids.+ */+const INDEX_TITLE = 'Index';++/** The shared shape a link line renders from — a document or a subdirectory. */+interface RenderableLink {+ path: string;+ title: string;+ description?: string | undefined;+}++/** `type` as written, trimmed; `Other` when absent or blank. */+function sectionOf(entry: IndexEntry): string {+ const declared = entry.type === undefined ? '' : toSingleLine(entry.type);+ return declared ? declared : UNTYPED_SECTION;+}++/**+ * Descriptions are single-line by construction — a bullet is one line, and a+ * newline mid-entry would end the list item and strand the rest as a paragraph+ * that no longer belongs to any entry.+ */+function toSingleLine(value: string): string {+ return value.replace(/\s+/g, ' ').trim();+}++/** Fixed code-point order — independent of the host's locale and ICU data. */+function compareCodePoints(left: string, right: string): number {+ if (left < right) return -1;+ if (left > right) return 1;+ return 0;+}++function normalizedSortKey(value: string): string {+ return toSingleLine(value).normalize('NFC').toLowerCase();+}++function compareSections(left: string, right: string): number {+ return (+ compareCodePoints(normalizedSortKey(left), normalizedSortKey(right)) ||+ compareCodePoints(left.normalize('NFC'), right.normalize('NFC'))+ );+}++function compareLinks(left: RenderableLink, right: RenderableLink): number {+ return (+ compareCodePoints(normalizedSortKey(left.title), normalizedSortKey(right.title)) ||+ compareCodePoints(+ left.path.replaceAll('\\', '/').normalize('NFC'),+ right.path.replaceAll('\\', '/').normalize('NFC'),+ )+ );+}++/** Escape the characters that can terminate or alter a Markdown link label. */+function escapeLinkLabel(value: string): string {+ return toSingleLine(value).replace(/[\\[\]]/g, '\\$&');+}++/** RFC 3986 segment encoding keeps `/` as hierarchy and neutralizes `()`/spaces. */+function encodePathSegment(segment: string): string {+ return encodeURIComponent(segment).replace(+ /[!'()*]/g,+ (char) => `%${char.codePointAt(0)?.toString(16).toUpperCase()}`,+ );+}++/**+ * Strip the index's own directory prefix so a content-root-relative path renders+ * relative to where the index lives. Entries are always at or below `directory`+ * by construction, so a path that does not start with it is passed through.+ */+function relativeTo(directory: string, path: string): string {+ const normalizedPath = path.replaceAll('\\', '/');+ const normalizedDir = directory.replaceAll('\\', '/').replace(/\/+$/, '');+ if (normalizedDir === '') return normalizedPath;+ const prefix = `${normalizedDir}/`;+ return normalizedPath.startsWith(prefix) ? normalizedPath.slice(prefix.length) : normalizedPath;+}++/**+ * Link form: relative, `./`-prefixed, extension retained. Precedent #56 names+ * relative the recommended default, and the extension keeps the link working in+ * GitHub, Obsidian, and an editor that never loaded OK.+ *+ * Deliberately never a bare folder (`./concepts/`): `ClassifiedLinkTarget` has+ * no folder variant, so a trailing slash resolves to a *document* of that name+ * and a folder link reads as broken to our own link validator. A subdirectory+ * link therefore targets the child index document, not the folder.+ */+function toHref(relativePath: string): string {+ const normalized = relativePath.replaceAll('\\', '/');+ return `./${normalized.split('/').map(encodePathSegment).join('/')}`;+}++function renderLink(link: RenderableLink, directory: string): string {+ const anchor = `* [${escapeLinkLabel(link.title)}](${toHref(relativeTo(directory, link.path))})`;+ const description = link.description === undefined ? '' : toSingleLine(link.description);+ return description ? `${anchor} - ${description}` : anchor;+}++/**+ * Group into `## <type>` sections (plus a `## Subdirectories` section when child+ * directories are supplied) under the index title, and render.+ *+ * Sections sort alphabetically by heading and entries sort by title+ * case-insensitively, both matching the reference generator. Ordering is what+ * makes the output a fixed point: two runs over the same content must produce+ * identical bytes, or the write guard never settles and every rebuild churns the+ * file.+ */+export function buildIndexMarkdown(+ entries: readonly IndexEntry[],+ options: BuildIndexOptions,+): string {+ const directory = options.directory ?? '';+ const subdirectories = options.subdirectories ?? [];++ const grouped = new Map<string, RenderableLink[]>();+ for (const entry of entries) {+ const section = sectionOf(entry);+ const bucket = grouped.get(section);+ if (bucket) bucket.push(entry);+ else grouped.set(section, [entry]);+ }++ if (subdirectories.length > 0) {+ // `Subdirectories` is also a valid document type. Sharing its bucket keeps+ // the semantic heading unique when documents and child indexes coexist.+ const bucket = grouped.get(SUBDIRECTORY_SECTION);+ if (bucket) bucket.push(...subdirectories);+ else grouped.set(SUBDIRECTORY_SECTION, [...subdirectories]);+ }++ const blocks = [...grouped]+ .sort(([left], [right]) => compareSections(left, right))+ .map(([heading, links]) => {+ const body = links+ .slice()+ .sort(compareLinks)+ .map((link) => renderLink(link, directory))+ .join('\n');+ return `## ${heading}\n\n${body}`;+ });++ const header = options.isRoot ? `---\nokf_version: "${GENERATED_OKF_VERSION}"\n---\n\n` : '';++ // An empty bundle keeps the title and gains no section: an empty `## Other`+ // would claim a grouping that describes nothing, while the title alone reads+ // as a bundle with no documents yet. Holding the title in both cases is what+ // makes "exactly one top-level heading" unconditional rather than a property+ // that lapses whenever the bundle happens to be empty.+ return `${header}${[`# ${INDEX_TITLE}`, ...blocks].join('\n\n')}\n`;+}diff --git a/packages/server/src/content/generated-artifact.test.ts b/packages/server/src/content/generated-artifact.test.tsnew file mode 100644index 000000000..5bb47391a--- /dev/null+++ b/packages/server/src/content/generated-artifact.test.ts@@ -0,0 +1,216 @@+/**+ * The write dispatch, exercised without a server.+ *+ * Before the extraction this logic could only run inside a booted server with a+ * real watcher and shadow repo, which is why its two most important properties+ * — the disk path's bookkeeping and the fact that BOTH paths attribute — went+ * unverified long enough to ship broken.+ *+ * The CRDT branch uses a real `Y.Doc`: `replaceRawBody` is imported rather than+ * injected (paired writes must route through a sanctioned primitive, enforced+ * by a static scan), so there is nothing to fake there and no reason to.+ */++import { describe, expect, test } from 'vitest';+import * as Y from 'yjs';+import type { PairedWriteOrigin } from '../server-observers.ts';+import type { WriterIdentity } from '../shadow-repo.ts';+import { type GeneratedArtifactEnv, writeGeneratedArtifact } from './generated-artifact.ts';++const WRITER: WriterIdentity = {+ id: 'ok-generator',+ name: 'OpenKnowledge (generated)',+ email: '[email protected]',+};++const ORIGIN = Object.freeze({+ source: 'local' as const,+ skipStoreHooks: false,+ context: Object.freeze({ origin: 'generated-test', paired: true as const }),+}) satisfies PairedWriteOrigin;++interface Recorded {+ disk: Array<{ absPath: string; markdown: string }>;+ registered: string[];+ indexed: Array<{ kind: 'create' | 'update'; docName: string }>;+ signals: number;+ attributed: Array<{ docName: string; writer: string }>;+}++function harness(document?: Y.Doc): { env: GeneratedArtifactEnv; rec: Recorded } {+ const rec: Recorded = {+ disk: [],+ registered: [],+ indexed: [],+ signals: 0,+ attributed: [],+ };+ const env: GeneratedArtifactEnv = {+ origin: ORIGIN,+ writer: WRITER,+ isConflict: () => false,+ getDocument: () => document,+ writeDisk: (absPath, markdown) => rec.disk.push({ absPath, markdown }),+ registerWrite: (absPath) => rec.registered.push(absPath),+ noteFileIndex: (e) => rec.indexed.push({ kind: e.kind, docName: e.docName }),+ signalFiles: () => {+ rec.signals += 1;+ },+ attribute: async (docName, writer) => {+ rec.attributed.push({ docName, writer: writer.id });+ },+ };+ return { env, rec };+}++const WRITE = {+ docName: 'index',+ absPath: '/project/content/index.md',+ markdown: '# Index\n\n* [A](./a.md)\n',+};++describe('writeGeneratedArtifact', () => {+ test('a tracked conflict blocks an unloaded artifact without side effects', async () => {+ const { env, rec } = harness();+ env.isConflict = (docName) => docName === WRITE.docName;++ const outcome = await writeGeneratedArtifact(+ { ...WRITE, currentMarkdown: '# Conflict bytes\n' },+ env,+ );++ expect(outcome).toBe('blocked-conflict');+ expect(rec).toEqual({ disk: [], registered: [], indexed: [], signals: 0, attributed: [] });+ });++ test('identical bytes perform no write at all', async () => {+ const { env, rec } = harness();++ const outcome = await writeGeneratedArtifact(+ { ...WRITE, currentMarkdown: WRITE.markdown },+ env,+ );++ expect(outcome).toBe('unchanged');+ // Not merely "no disk write" — no file-index mutation and no broadcast+ // either. Those are trigger surfaces; performing them for an unchanged+ // rebuild is what would keep a tracked file permanently dirty.+ expect(rec).toEqual({ disk: [], registered: [], indexed: [], signals: 0, attributed: [] });+ });++ test('an unloaded artifact goes to disk with its full bookkeeping', async () => {+ const { env, rec } = harness();++ const outcome = await writeGeneratedArtifact({ ...WRITE, currentMarkdown: null }, env);++ expect(outcome).toBe('disk');+ expect(rec.disk).toEqual([{ absPath: WRITE.absPath, markdown: WRITE.markdown }]);+ // Registration is what stops the watcher re-entering our own write as an+ // external change.+ expect(rec.registered).toEqual([WRITE.absPath]);+ expect(rec.signals).toBe(1);+ });++ test('a first write is a create and a rewrite is an update', async () => {+ const first = harness();+ await writeGeneratedArtifact({ ...WRITE, currentMarkdown: null }, first.env);+ expect(first.rec.indexed).toEqual([{ kind: 'create', docName: 'index' }]);++ const second = harness();+ await writeGeneratedArtifact({ ...WRITE, currentMarkdown: '# Stale\n' }, second.env);+ expect(second.rec.indexed).toEqual([{ kind: 'update', docName: 'index' }]);+ });++ test('a loaded artifact is written through the document, not to disk', async () => {+ const doc = new Y.Doc();+ const { env, rec } = harness(doc);++ const outcome = await writeGeneratedArtifact({ ...WRITE, currentMarkdown: '# Stale\n' }, env);++ expect(outcome).toBe('document');+ // Going to disk behind a loaded document's back is the bug this branch+ // exists to avoid — the editor would sit on stale bytes.+ expect(rec.disk).toEqual([]);+ expect(rec.registered).toEqual([]);+ expect(rec.indexed).toEqual([]);+ expect(doc.getText('source').toString()).toContain('[A](./a.md)');+ });++ test('both paths attribute the write, to the same writer', async () => {+ const unloaded = harness();+ await writeGeneratedArtifact({ ...WRITE, currentMarkdown: null }, unloaded.env);++ const loaded = harness(new Y.Doc());+ await writeGeneratedArtifact({ ...WRITE, currentMarkdown: '# Stale\n' }, loaded.env);++ // The asymmetry that shipped: one path claimed the write and the other did+ // not, so the same rebuild was credited differently depending on whether a+ // window happened to be open.+ const expected = [{ docName: 'index', writer: 'ok-generator' }];+ expect(unloaded.rec.attributed).toEqual(expected);+ expect(loaded.rec.attributed).toEqual(expected);+ });++ test('the CRDT write carries the paired origin it was given', async () => {+ const doc = new Y.Doc();+ const { env } = harness(doc);+ const origins: unknown[] = [];+ doc.on('update', (_u: Uint8Array, origin: unknown) => origins.push(origin));++ await writeGeneratedArtifact({ ...WRITE, currentMarkdown: '# Stale\n' }, env);++ // Not decoration: the origin is how the observer bridge knows this was a+ // paired write and must not be amplified back through the other CRDT.+ expect(origins).toContain(ORIGIN);+ });++ test('resident CRDT bytes are authoritative over an equal disk snapshot', async () => {+ const doc = new Y.Doc();+ doc.getText('source').insert(0, '# Unsaved human edit\n');+ const { env, rec } = harness(doc);++ const outcome = await writeGeneratedArtifact(+ { ...WRITE, currentMarkdown: WRITE.markdown },+ env,+ );++ expect(outcome).toBe('document');+ expect(doc.getText('source').toString()).toBe(WRITE.markdown);+ expect(rec.attributed).toEqual([{ docName: 'index', writer: 'ok-generator' }]);+ });++ test('resident matching bytes settle even when the disk snapshot is stale', async () => {+ const doc = new Y.Doc();+ doc.getText('source').insert(0, WRITE.markdown);+ const { env, rec } = harness(doc);++ const outcome = await writeGeneratedArtifact(+ { ...WRITE, currentMarkdown: '# Stale on disk\n' },+ env,+ );++ expect(outcome).toBe('unchanged');+ expect(rec).toEqual({ disk: [], registered: [], indexed: [], signals: 0, attributed: [] });+ });++ test('awaits an asynchronous disk publication before bookkeeping and attribution', async () => {+ const { env, rec } = harness();+ let release!: () => void;+ env.writeDisk = async () => {+ await new Promise<void>((resolve) => {+ release = resolve;+ });+ rec.disk.push({ absPath: WRITE.absPath, markdown: WRITE.markdown });+ };++ const pending = writeGeneratedArtifact({ ...WRITE, currentMarkdown: null }, env);+ await Promise.resolve();+ expect(rec.registered).toEqual([]);+ expect(rec.attributed).toEqual([]);++ release();+ await expect(pending).resolves.toBe('disk');+ expect(rec.registered).toEqual([WRITE.absPath]);+ expect(rec.attributed).toEqual([{ docName: 'index', writer: 'ok-generator' }]);+ });+});diff --git a/packages/server/src/content/generated-artifact.ts b/packages/server/src/content/generated-artifact.tsnew file mode 100644index 000000000..02e58be8d--- /dev/null+++ b/packages/server/src/content/generated-artifact.ts@@ -0,0 +1,139 @@+/**+ * Writing a document OK authors itself.+ *+ * The generated root `index.md` is the first of these; the shape is deliberately+ * not about indexes. What an artifact IS — which documents it lists, when it is+ * worth rebuilding — belongs to the artifact. What every artifact shares is the+ * awkward part: a generated file can be open in an editor, so there are two+ * write paths, and each carries bookkeeping that is easy to omit and silent when+ * omitted.+ *+ * Three things live here because getting any of them wrong fails quietly:+ *+ * - **The fixed point.** Identical bytes perform NO write — not a rewrite with+ * the same content. Writing mutates the file index and signals `files`, both+ * of which are trigger surfaces, so an unconditional writer keeps a tracked+ * file permanently dirty and, if a future trigger ever fires on its own+ * write, spins.+ * - **The path split.** A resident document is written through the CRDT so the+ * open editor converges; going to disk behind its back would leave it on+ * stale bytes until something else reconciled it. A doc that is not resident+ * has no CRDT to be authoritative, so disk plus its bookkeeping is the job.+ * - **Authorship.** The bytes reach the commit either way — the shadow repo's+ * tree is a sweep of the whole content root — but the CREDIT comes only from+ * an explicit contributor record. Without one they land under whichever+ * writer drains next, which is a human when someone has the file open.+ *+ * The caller supplies the collaborators rather than importing them, so the whole+ * dispatch is exercisable without booting a server.+ */++import type * as Y from 'yjs';+import { replaceRawBody } from '../bridge-intake.ts';+import type { PairedWriteOrigin } from '../server-observers.ts';+import type { WriterIdentity } from '../shadow-repo.ts';++/** The bounded result of a write attempt, including deliberate conflict refusal. */+export type GeneratedWriteOutcome = 'unchanged' | 'document' | 'disk' | 'blocked-conflict';++export interface GeneratedArtifactEnv {+ /**+ * The origin for the CRDT branch. Typed rather than loose because the static+ * scan that audits paired writes cannot resolve a parameter — this type is+ * what keeps the `paired: true` requirement enforced at the seam.+ */+ origin: PairedWriteOrigin;+ /** Who the write is credited to. */+ writer: WriterIdentity;+ /** Whether the authoritative conflict registry currently owns this doc. */+ isConflict(docName: string): boolean;+ /** The resident document for a docName, or undefined when it is not loaded. */+ getDocument(docName: string): Y.Doc | undefined;+ /** Create the parent directory and atomically publish the file. */+ writeDisk(absPath: string, markdown: string): void | Promise<void>;+ /**+ * Tell the watcher this write was ours so it does not re-enter as an external+ * change. Disk path only — the CRDT path reaches disk through persistence,+ * which does its own registration.+ */+ registerWrite(absPath: string, markdown: string): void;+ /** Keep the in-memory file index in step with the write we just did. */+ noteFileIndex(event: {+ kind: 'create' | 'update';+ absPath: string;+ docName: string;+ markdown: string;+ }): void;+ /** Broadcast that the file set changed. */+ signalFiles(): void;+ /** Claim the write for `writer`, then push it to the shadow repo. */+ attribute(docName: string, writer: WriterIdentity): Promise<void>;+}++export interface GeneratedArtifactWrite {+ /** Extension-less docName (`index`), as every docName is. */+ docName: string;+ /** Absolute path the docName resolves to. */+ absPath: string;+ /** The bytes the artifact should hold. */+ markdown: string;+ /** What is on disk now, or null when the file does not exist yet. */+ currentMarkdown: string | null;+}++/**+ * Land a generated artifact's bytes, doing nothing when they already match.+ *+ * Attribution runs AFTER a successful write on both paths, never before: a+ * contributor recorded for a write that then threw would commit a rebuild that+ * never happened.+ */+export async function writeGeneratedArtifact(+ write: GeneratedArtifactWrite,+ env: GeneratedArtifactEnv,+): Promise<GeneratedWriteOutcome> {+ const { docName, absPath, markdown, currentMarkdown } = write;++ // Conflict ownership is independent of residency. An unopened document has+ // no lifecycle Y.Map to consult, but its ConflictStore entry is still the+ // authoritative signal that only the resolver may replace its disk bytes.+ if (env.isConflict(docName)) return 'blocked-conflict';++ const document = env.getDocument(docName);+ if (document) {+ // The conflict lifecycle owns both the banner and resolution. The resident+ // source may still hold clean pre-conflict bytes while disk holds markers;+ // treating that split as an ordinary equality or write would bypass the+ // user's explicit conflict decision.+ if (document.getMap('lifecycle').get('status') === 'conflict') {+ return 'blocked-conflict';+ }+ // A resident Y.Doc is authoritative over its last disk snapshot. Comparing+ // disk first can discard a newer live edit merely because the older file+ // already happens to equal the generated bytes.+ if (document.getText('source').toString() === markdown) return 'unchanged';+ // `replaceRawBody` is imported, not injected: paired writes must route+ // through a sanctioned bridge primitive, and that is enforced by a static+ // scan which cannot follow an injected function. Making this a collaborator+ // would buy a slightly easier unit test and silently disable a STOP rule.+ document.transact(() => {+ replaceRawBody(document, markdown);+ }, env.origin);+ await env.attribute(docName, env.writer);+ return 'document';+ }++ if (currentMarkdown === markdown) return 'unchanged';++ await env.writeDisk(absPath, markdown);+ env.registerWrite(absPath, markdown);+ env.noteFileIndex({+ kind: currentMarkdown === null ? 'create' : 'update',+ absPath,+ docName,+ markdown,+ });+ env.signalFiles();+ await env.attribute(docName, env.writer);+ return 'disk';+}diff --git a/packages/server/src/content/generated-index-git-attributes.test.ts b/packages/server/src/content/generated-index-git-attributes.test.tsnew file mode 100644index 000000000..a69152121--- /dev/null+++ b/packages/server/src/content/generated-index-git-attributes.test.ts@@ -0,0 +1,358 @@+import { execFileSync } from 'node:child_process';+import {+ existsSync,+ mkdirSync,+ mkdtempSync,+ readFileSync,+ symlinkSync,+ unlinkSync,+ writeFileSync,+} from 'node:fs';+import { tmpdir } from 'node:os';+import { join } from 'node:path';+import { afterEach, describe, expect, test, vi } from 'vitest';+import { getLogger } from '../logger.ts';+import {+ inspectGeneratedIndexGitAttributes,+ updateGeneratedIndexGitAttributes,+} from './generated-index-git-attributes.ts';++afterEach(() => vi.restoreAllMocks());++function makeProject(contentSubdir = '.'): { projectDir: string; contentDir: string } {+ const projectDir = mkdtempSync(join(tmpdir(), 'ok-generated-index-attrs-'));+ execFileSync('git', ['init', '-q'], { cwd: projectDir });+ if (contentSubdir !== '.') mkdirSync(join(projectDir, contentSubdir), { recursive: true });+ return {+ projectDir,+ contentDir: contentSubdir === '.' ? projectDir : join(projectDir, contentSubdir),+ };+}++const generatedDocNames = ['index', 'guides/index'];++describe('generated-index git attributes', () => {+ test('is not applicable outside a Git working tree', async () => {+ const projectDir = mkdtempSync(join(tmpdir(), 'ok-generated-index-no-git-'));+ const result = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir: projectDir,+ generatedDocNames,+ enabled: true,+ });++ expect(result.ok).toBe(true);+ expect(result.status).toEqual({ state: 'not-applicable' });+ expect(existsSync(join(projectDir, '.gitattributes'))).toBe(false);+ });++ test('adds a content-scoped union rule that covers root and nested indexes only', async () => {+ const { projectDir, contentDir } = makeProject('knowledge base');+ const result = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: true,+ });++ expect(result.ok).toBe(true);+ expect(result.status).toEqual({ state: 'ready', ownership: 'open-knowledge' });+ const attributes = readFileSync(join(projectDir, '.gitattributes'), 'utf-8');+ expect(attributes).toContain('"/knowledge base/index.md" merge=union');+ expect(attributes).toContain('"/knowledge base/**/index.md" merge=union');++ const values = ['knowledge base/index.md', 'knowledge base/guides/index.md', 'index.md'].map(+ (path) =>+ execFileSync('git', ['check-attr', 'merge', '--', path], {+ cwd: projectDir,+ encoding: 'utf-8',+ }).trim(),+ );+ expect(values).toEqual([+ 'knowledge base/index.md: merge: union',+ 'knowledge base/guides/index.md: merge: union',+ 'index.md: merge: unspecified',+ ]);+ });++ test('the installed rule union-merges divergent generated index changes', async () => {+ const { projectDir, contentDir } = makeProject('knowledge base');+ const result = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: true,+ });+ expect(result.ok).toBe(true);++ const indexPath = join(contentDir, 'index.md');+ const commit = (message: string): void => {+ execFileSync(+ 'git',+ [+ '-c',+ 'user.name=Open Knowledge Test',+ '-c',+ '[email protected]',+ 'commit',+ '-qm',+ message,+ ],+ { cwd: projectDir },+ );+ };++ writeFileSync(indexPath, '# Index\n\n## Notes\n', 'utf-8');+ execFileSync('git', ['add', '.gitattributes', 'knowledge base/index.md'], {+ cwd: projectDir,+ });+ commit('base');+ const baseBranch = execFileSync('git', ['branch', '--show-current'], {+ cwd: projectDir,+ encoding: 'utf-8',+ }).trim();++ execFileSync('git', ['switch', '-qc', 'generated-left'], { cwd: projectDir });+ writeFileSync(indexPath, '# Index\n\n## Notes\n\n* [Left](./left.md)\n', 'utf-8');+ execFileSync('git', ['add', 'knowledge base/index.md'], { cwd: projectDir });+ commit('left index');++ execFileSync('git', ['switch', '-q', baseBranch], { cwd: projectDir });+ writeFileSync(indexPath, '# Index\n\n## Notes\n\n* [Right](./right.md)\n', 'utf-8');+ execFileSync('git', ['add', 'knowledge base/index.md'], { cwd: projectDir });+ commit('right index');++ execFileSync(+ 'git',+ [+ '-c',+ 'user.name=Open Knowledge Test',+ '-c',+ '[email protected]',+ 'merge',+ '--no-edit',+ 'generated-left',+ ],+ { cwd: projectDir },+ );++ expect(readFileSync(indexPath, 'utf-8')).toContain('* [Left](./left.md)');+ expect(readFileSync(indexPath, 'utf-8')).toContain('* [Right](./right.md)');+ expect(+ execFileSync('git', ['diff', '--name-only', '--diff-filter=U'], {+ cwd: projectDir,+ encoding: 'utf-8',+ }).trim(),+ ).toBe('');+ });++ test('accepts an existing effective union rule without claiming ownership', async () => {+ const { projectDir, contentDir } = makeProject();+ writeFileSync(join(projectDir, '.gitattributes'), 'index.md merge=union\n', 'utf-8');++ const result = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: true,+ });++ expect(result.ok).toBe(true);+ expect(result.status).toEqual({ state: 'ready', ownership: 'existing' });+ expect(result.changed).toBe(false);+ expect(readFileSync(join(projectDir, '.gitattributes'), 'utf-8')).toBe(+ 'index.md merge=union\n',+ );+ });++ test('recreates a tracked union rule that is deleted from the working tree', async () => {+ const { projectDir, contentDir } = makeProject();+ const attributesPath = join(projectDir, '.gitattributes');+ writeFileSync(attributesPath, 'index.md merge=union\n', 'utf-8');+ execFileSync('git', ['add', '.gitattributes'], { cwd: projectDir });+ unlinkSync(attributesPath);++ expect(+ inspectGeneratedIndexGitAttributes({ projectDir, contentDir, generatedDocNames }),+ ).toEqual({ state: 'missing' });++ const result = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: true,+ });++ expect(result.ok).toBe(true);+ expect(result.status).toEqual({ state: 'ready', ownership: 'open-knowledge' });+ expect(result.changed).toBe(true);+ expect(readFileSync(attributesPath, 'utf-8')).toContain('/**/index.md merge=union');+ });++ test('does not override a conflicting merge attribute', async () => {+ const { projectDir, contentDir } = makeProject();+ writeFileSync(join(projectDir, '.gitattributes'), 'index.md merge=ours\n', 'utf-8');++ const result = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: true,+ });++ expect(result).toEqual({ ok: false, status: { state: 'conflict' } });+ expect(readFileSync(join(projectDir, '.gitattributes'), 'utf-8')).toBe('index.md merge=ours\n');+ });++ test.skipIf(process.platform === 'win32')(+ 'refuses to follow a .gitattributes symlink',+ async () => {+ const { projectDir, contentDir } = makeProject();+ const targetPath = join(projectDir, 'attributes-target');+ writeFileSync(targetPath, '*.png binary\n', 'utf-8');+ symlinkSync(targetPath, join(projectDir, '.gitattributes'));+ const warn = vi+ .spyOn(getLogger('generated-index-git-attributes'), 'warn')+ .mockImplementation(() => {});++ expect(+ inspectGeneratedIndexGitAttributes({ projectDir, contentDir, generatedDocNames }),+ ).toEqual({ state: 'unavailable' });++ const result = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: true,+ });++ expect(result).toEqual({ ok: false, status: { state: 'unavailable' } });+ expect(readFileSync(targetPath, 'utf-8')).toBe('*.png binary\n');+ expect(warn).toHaveBeenNthCalledWith(+ 1,+ expect.objectContaining({+ err: expect.any(Error),+ path: expect.stringContaining('.gitattributes'),+ }),+ 'failed to inspect generated-index Git attributes',+ );+ expect(warn).toHaveBeenNthCalledWith(+ 2,+ expect.objectContaining({+ err: expect.any(Error),+ path: expect.stringContaining('.gitattributes'),+ }),+ 'failed to read generated-index Git attributes',+ );+ },+ );++ test('rolls back its root rule when a nested attribute still overrides a generated index', async () => {+ const { projectDir, contentDir } = makeProject();+ mkdirSync(join(projectDir, 'guides'), { recursive: true });+ writeFileSync(join(projectDir, 'guides', '.gitattributes'), 'index.md merge=ours\n', 'utf-8');++ const result = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: true,+ });++ expect(result).toEqual({ ok: false, status: { state: 'conflict' } });+ expect(existsSync(join(projectDir, '.gitattributes'))).toBe(false);+ });++ test('disable removes only the Open Knowledge block and rollback restores it', async () => {+ const { projectDir, contentDir } = makeProject();+ writeFileSync(join(projectDir, '.gitattributes'), '*.png binary\n', 'utf-8');+ await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: true,+ });++ const disabled = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: false,+ });++ expect(disabled.ok).toBe(true);+ if (!disabled.ok) throw new Error('expected successful disable');+ expect(readFileSync(join(projectDir, '.gitattributes'), 'utf-8')).toBe('*.png binary\n');++ await disabled.rollback();+ expect(+ inspectGeneratedIndexGitAttributes({ projectDir, contentDir, generatedDocNames }),+ ).toEqual({ state: 'ready', ownership: 'open-knowledge' });+ });++ test('accepts and removes an Open Knowledge block checked out with CRLF endings', async () => {+ const { projectDir, contentDir } = makeProject();+ const attributesPath = join(projectDir, '.gitattributes');+ const enabled = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: true,+ });+ expect(enabled.ok).toBe(true);+ writeFileSync(+ attributesPath,+ readFileSync(attributesPath, 'utf-8').replace(/\n/g, '\r\n'),+ 'utf-8',+ );++ expect(+ inspectGeneratedIndexGitAttributes({ projectDir, contentDir, generatedDocNames }),+ ).toEqual({ state: 'ready', ownership: 'open-knowledge' });++ const disabled = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: false,+ });+ expect(disabled.ok).toBe(true);+ expect(existsSync(attributesPath)).toBe(false);+ });++ test('rollback refuses to overwrite a later project edit', async () => {+ const { projectDir, contentDir } = makeProject();+ const enabled = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: true,+ });+ if (!enabled.ok) throw new Error('expected successful enable');++ const attributesPath = join(projectDir, '.gitattributes');+ const userEdit = `${readFileSync(attributesPath, 'utf-8')}*.png binary\n`;+ writeFileSync(attributesPath, userEdit, 'utf-8');++ await expect(enabled.rollback()).rejects.toThrow('changed after Open Knowledge updated it');+ expect(readFileSync(attributesPath, 'utf-8')).toBe(userEdit);+ });++ test('disable preserves an equivalent rule owned by the project', async () => {+ const { projectDir, contentDir } = makeProject();+ writeFileSync(join(projectDir, '.gitattributes'), 'index.md merge=union\n', 'utf-8');++ const result = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames,+ enabled: false,+ });++ expect(result.ok).toBe(true);+ expect(result.changed).toBe(false);+ expect(readFileSync(join(projectDir, '.gitattributes'), 'utf-8')).toBe(+ 'index.md merge=union\n',+ );+ });+});diff --git a/packages/server/src/content/generated-index-git-attributes.ts b/packages/server/src/content/generated-index-git-attributes.tsnew file mode 100644index 000000000..b23b57d83--- /dev/null+++ b/packages/server/src/content/generated-index-git-attributes.ts@@ -0,0 +1,378 @@+import { spawnSync } from 'node:child_process';+import { existsSync, lstatSync, readFileSync, realpathSync } from 'node:fs';+import { relative, resolve, sep } from 'node:path';+import { atomicWriteFile } from '@inkeep/open-knowledge-core/server';+import { normalizeFsPath, tracedAtomicFs, tracedRm } from '../fs-traced.ts';+import { getLogger } from '../logger.ts';++const MANAGED_BLOCK_START = '# BEGIN OpenKnowledge generated indexes';+const MANAGED_BLOCK_END = '# END OpenKnowledge generated indexes';+const MANAGED_BLOCK_NOTE = '# Required while Open Knowledge maintains generated index.md files.';+const log = getLogger('generated-index-git-attributes');++export type GeneratedIndexGitAttributesStatus =+ | { state: 'not-applicable' }+ | { state: 'ready'; ownership: 'open-knowledge' | 'existing' }+ | { state: 'missing' }+ | { state: 'conflict' }+ | { state: 'unavailable' };++export type GeneratedIndexGitAttributesUpdate =+ | {+ ok: true;+ status: GeneratedIndexGitAttributesStatus;+ changed: boolean;+ rollback: () => Promise<void>;+ }+ | { ok: false; status: GeneratedIndexGitAttributesStatus };++interface GitContext {+ gitRoot: string;+ attributesPath: string;+ generatedPaths: string[];+ expectedBlock: string;+}++interface ManagedBlockMatch {+ start: number;+ end: number;+ text: string;+ recognizable: boolean;+}++function normalizeLineEndings(content: string): string {+ return content.replace(/\r\n?/g, '\n');+}++function runGit(cwd: string, args: string[], input?: string): ReturnType<typeof spawnSync> {+ return spawnSync('git', ['-C', cwd, ...args], {+ encoding: 'utf-8',+ input,+ timeout: 10_000,+ windowsHide: true,+ });+}++function gitContext(+ projectDir: string,+ contentDir: string,+ generatedDocNames: Iterable<string>,+): GitContext | GeneratedIndexGitAttributesStatus {+ const rootResult = runGit(projectDir, ['rev-parse', '--show-toplevel']);+ if (rootResult.error) return { state: 'unavailable' };+ if (rootResult.status !== 0) {+ const diagnostic = `${rootResult.stderr ?? ''}${rootResult.stdout ?? ''}`;+ return /not a git repository/i.test(diagnostic)+ ? { state: 'not-applicable' }+ : { state: 'unavailable' };+ }++ const canonical = (path: string): string => {+ try {+ return realpathSync(path);+ } catch {+ return resolve(path);+ }+ };+ const gitRoot = canonical(String(rootResult.stdout).trim());+ const canonicalContentDir = canonical(contentDir);+ const contentRelative = relative(gitRoot, canonicalContentDir);+ if (contentRelative === '..' || contentRelative.startsWith(`..${sep}`)) {+ return { state: 'not-applicable' };+ }++ const generatedPaths = [...generatedDocNames]+ .map((docName) => `${docName}.md`)+ .map((path) => relative(gitRoot, resolve(canonicalContentDir, path)).split(sep).join('/'))+ .filter((path) => path !== '..' && !path.startsWith('../'));+ if (generatedPaths.length === 0) {+ generatedPaths.push(+ relative(gitRoot, resolve(canonicalContentDir, 'index.md')).split(sep).join('/'),+ );+ }++ const escapedContentPath = contentRelative+ .split(sep)+ .filter(Boolean)+ .map(escapeAttributePatternSegment)+ .join('/');+ const prefix = escapedContentPath.length > 0 ? `/${escapedContentPath}` : '';+ const patterns = [+ `${formatAttributePattern(`${prefix}/index.md`)} merge=union`,+ `${formatAttributePattern(`${prefix}/**/index.md`)} merge=union`,+ ];+ const expectedBlock = [+ MANAGED_BLOCK_START,+ MANAGED_BLOCK_NOTE,+ ...patterns,+ MANAGED_BLOCK_END,+ '',+ ].join('\n');++ return {+ gitRoot,+ attributesPath: resolve(gitRoot, '.gitattributes'),+ generatedPaths: [...new Set(generatedPaths)].sort(),+ expectedBlock,+ };+}++function escapeAttributePatternSegment(segment: string): string {+ return segment.replace(/[\\!?*[\]]/g, (character) => `\\${character}`);+}++function formatAttributePattern(pattern: string): string {+ if (!/\s/.test(pattern)) return pattern;+ return `"${pattern.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;+}++function assertWritableAttributesPath(path: string): void {+ try {+ if (lstatSync(path).isSymbolicLink()) {+ throw new Error('refusing to follow a .gitattributes symlink');+ }+ } catch (error) {+ if ((error as NodeJS.ErrnoException).code === 'ENOENT') return;+ throw error;+ }+}++function readAttributes(path: string): string | null {+ assertWritableAttributesPath(path);+ return existsSync(path) ? readFileSync(path, 'utf-8') : null;+}++function findManagedBlock(content: string): ManagedBlockMatch | null | 'malformed' {+ const starts = [...content.matchAll(new RegExp(`^${MANAGED_BLOCK_START}$`, 'gm'))];+ const ends = [...content.matchAll(new RegExp(`^${MANAGED_BLOCK_END}$`, 'gm'))];+ if (starts.length === 0 && ends.length === 0) return null;+ if (starts.length !== 1 || ends.length !== 1) return 'malformed';++ const start = starts[0]?.index;+ const endMarkerStart = ends[0]?.index;+ if (start === undefined || endMarkerStart === undefined || endMarkerStart < start) {+ return 'malformed';+ }+ const markerEnd = endMarkerStart + MANAGED_BLOCK_END.length;+ const newlineLength = content.startsWith('\r\n', markerEnd)+ ? 2+ : /[\r\n]/.test(content[markerEnd] ?? '')+ ? 1+ : 0;+ const end = markerEnd + newlineLength;+ const text = content.slice(start, end);+ const lines = text+ .split('\n')+ .map((line) => line.trim())+ .filter(Boolean);+ const body = lines.slice(1, -1);+ const recognizable =+ body[0] === MANAGED_BLOCK_NOTE &&+ body.slice(1).length > 0 &&+ body.slice(1).every((line) => line.endsWith(' merge=union'));+ return { start, end, text, recognizable };+}++function effectiveMergeValues(context: GitContext): string[] | null {+ const result = runGit(+ context.gitRoot,+ ['check-attr', '-z', '--stdin', 'merge'],+ `${context.generatedPaths.join('\0')}\0`,+ );+ if (result.error || result.status !== 0) return null;+ const fields = String(result.stdout).split('\0');+ const values: string[] = [];+ for (let index = 0; index + 2 < fields.length; index += 3) {+ values.push(fields[index + 2] ?? 'unspecified');+ }+ return values.length === context.generatedPaths.length ? values : null;+}++function inspectWithContext(+ context: GitContext,+ content: string | null,+): GeneratedIndexGitAttributesStatus {+ const block = findManagedBlock(content ?? '');+ if (block === 'malformed') return { state: 'conflict' };+ if (block && !block.recognizable) return { state: 'conflict' };++ const values = effectiveMergeValues(context);+ if (values === null) return { state: 'unavailable' };+ const allUnion = values.every((value) => value === 'union');+ const hasConflict = values.some((value) => value !== 'union' && value !== 'unspecified');++ if (block) {+ if (+ normalizeLineEndings(block.text).trimEnd() !==+ normalizeLineEndings(context.expectedBlock).trimEnd()+ ) {+ return { state: 'missing' };+ }+ return allUnion ? { state: 'ready', ownership: 'open-knowledge' } : { state: 'conflict' };+ }+ if (hasConflict) return { state: 'conflict' };+ if (content === null) return { state: 'missing' };+ return allUnion ? { state: 'ready', ownership: 'existing' } : { state: 'missing' };+}++export function inspectGeneratedIndexGitAttributes(options: {+ projectDir: string;+ contentDir: string;+ generatedDocNames: Iterable<string>;+}): GeneratedIndexGitAttributesStatus {+ const context = gitContext(options.projectDir, options.contentDir, options.generatedDocNames);+ if (!('gitRoot' in context)) return context;+ try {+ return inspectWithContext(context, readAttributes(context.attributesPath));+ } catch (error) {+ log.warn(+ { err: error, path: normalizeFsPath(context.attributesPath) },+ 'failed to inspect generated-index Git attributes',+ );+ return { state: 'unavailable' };+ }+}++function appendManagedBlock(content: string | null, block: string): string {+ if (content === null || content.length === 0) return block;+ const separator = content.endsWith('\n\n') ? '' : content.endsWith('\n') ? '\n' : '\n\n';+ return `${content}${separator}${block}`;+}++function replaceManagedBlock(content: string, match: ManagedBlockMatch, block: string): string {+ return `${content.slice(0, match.start)}${block}${content.slice(match.end)}`;+}++function removeManagedBlock(content: string, match: ManagedBlockMatch): string {+ const before = content+ .slice(0, match.start)+ .replace(/(?:\r?\n){2,}$/, (newlines) => (newlines.endsWith('\r\n') ? '\r\n' : '\n'));+ const after = content.slice(match.end).replace(/^(?:\r?\n)+/, '');+ return `${before}${after}`;+}++async function restoreAttributes(+ path: string,+ previous: string | null,+ expectedCurrent: string | null,+): Promise<void> {+ const current = readAttributes(path);+ if (current === previous) return;+ if (current !== expectedCurrent) {+ throw new Error('.gitattributes changed after Open Knowledge updated it');+ }+ if (previous === null) {+ await tracedRm(path);+ return;+ }+ await atomicWriteFile(path, previous, { fs: tracedAtomicFs });+}++export async function updateGeneratedIndexGitAttributes(options: {+ projectDir: string;+ contentDir: string;+ generatedDocNames: Iterable<string>;+ enabled: boolean;+}): Promise<GeneratedIndexGitAttributesUpdate> {+ const context = gitContext(options.projectDir, options.contentDir, options.generatedDocNames);+ if (!('gitRoot' in context)) {+ if (context.state === 'not-applicable') {+ return { ok: true, status: context, changed: false, rollback: async () => {} };+ }+ return { ok: false, status: context };+ }++ let previous: string | null;+ try {+ previous = readAttributes(context.attributesPath);+ } catch (error) {+ log.warn(+ { err: error, path: normalizeFsPath(context.attributesPath) },+ 'failed to read generated-index Git attributes',+ );+ return { ok: false, status: { state: 'unavailable' } };+ }+ const beforeStatus = inspectWithContext(context, previous);++ if (!options.enabled) {+ const match = findManagedBlock(previous ?? '');+ if (match === null) {+ return { ok: true, status: beforeStatus, changed: false, rollback: async () => {} };+ }+ if (match === 'malformed' || !match.recognizable) {+ return { ok: false, status: { state: 'conflict' } };+ }+ const next = removeManagedBlock(previous ?? '', match);+ try {+ if (readAttributes(context.attributesPath) !== previous) {+ return { ok: false, status: { state: 'unavailable' } };+ }+ if (next.length === 0) {+ await tracedRm(context.attributesPath);+ } else {+ await atomicWriteFile(context.attributesPath, next, { fs: tracedAtomicFs });+ }+ return {+ ok: true,+ status: inspectWithContext(context, next.length === 0 ? null : next),+ changed: true,+ rollback: () =>+ restoreAttributes(context.attributesPath, previous, next.length === 0 ? null : next),+ };+ } catch (error) {+ log.warn(+ { err: error, path: normalizeFsPath(context.attributesPath) },+ 'failed to remove generated-index Git attributes',+ );+ return { ok: false, status: { state: 'unavailable' } };+ }+ }++ if (beforeStatus.state === 'ready' && previous !== null) {+ return { ok: true, status: beforeStatus, changed: false, rollback: async () => {} };+ }+ if (beforeStatus.state === 'conflict' || beforeStatus.state === 'unavailable') {+ return { ok: false, status: beforeStatus };+ }++ const existingMatch = findManagedBlock(previous ?? '');+ if (existingMatch === 'malformed' || (existingMatch && !existingMatch.recognizable)) {+ return { ok: false, status: { state: 'conflict' } };+ }+ const next = existingMatch+ ? replaceManagedBlock(previous ?? '', existingMatch, context.expectedBlock)+ : appendManagedBlock(previous, context.expectedBlock);+ try {+ if (readAttributes(context.attributesPath) !== previous) {+ return { ok: false, status: { state: 'unavailable' } };+ }+ await atomicWriteFile(context.attributesPath, next, { fs: tracedAtomicFs });+ const afterStatus = inspectWithContext(context, next);+ if (afterStatus.state !== 'ready') {+ await restoreAttributes(context.attributesPath, previous, next);+ return { ok: false, status: afterStatus };+ }+ return {+ ok: true,+ status: afterStatus,+ changed: true,+ rollback: () => restoreAttributes(context.attributesPath, previous, next),+ };+ } catch (error) {+ try {+ await restoreAttributes(context.attributesPath, previous, next);+ } catch (rollbackError) {+ log.warn(+ { err: rollbackError, path: normalizeFsPath(context.attributesPath) },+ 'failed to roll back generated-index Git attributes',+ );+ // The caller still receives unavailable; a second write cannot make the+ // original setup trustworthy enough to enable generation.+ }+ log.warn(+ { err: error, path: normalizeFsPath(context.attributesPath) },+ 'failed to update generated-index Git attributes',+ );+ return { ok: false, status: { state: 'unavailable' } };+ }+}diff --git a/packages/server/src/content/regenerate-index.test.ts b/packages/server/src/content/regenerate-index.test.tsnew file mode 100644index 000000000..2633e903d--- /dev/null+++ b/packages/server/src/content/regenerate-index.test.ts@@ -0,0 +1,369 @@+import { describe, expect, test } from 'vitest';+import {+ collectIndexDirectories,+ type DirectoryIndexDeps,+ directoryChainToRoot,+ type IndexSourceDoc,+ indexedFieldsChanged,+ indexedMetadataChanged,+ isGeneratedIndexDocName,+ planDirectoryIndexRegenerations,+} from './regenerate-index.ts';++/** Sets carry no meaningful order; compare membership as a sorted array. */+function sorted(directories: Set<string>): string[] {+ return [...directories].sort();+}++describe('collectIndexDirectories', () => {+ test('every ancestor of a document is included, even containers with no direct markdown', () => {+ // `guide` and `guide/deep` hold no markdown directly, only below them, yet+ // each is a navigation waypoint and gets an index.+ expect(sorted(collectIndexDirectories(['guide/deep/note']))).toEqual([+ '',+ 'guide',+ 'guide/deep',+ ]);+ });++ test('a directory with no admitted markdown at any depth is excluded', () => {+ // `archive` holds only a reserved `index`, so it never becomes a directory+ // that needs one of its own.+ const directories = collectIndexDirectories(['docs/guide', 'archive/index']);+ expect(sorted(directories)).toEqual(['', 'docs']);+ expect(directories.has('archive')).toBe(false);+ });++ test('reserved-stem documents do not earn their directory an index; a real sibling does', () => {+ expect(sorted(collectIndexDirectories(['wiki/index', 'wiki/log']))).toEqual(['']);+ expect(sorted(collectIndexDirectories(['wiki/index', 'wiki/real']))).toEqual(['', 'wiki']);+ });++ test('infrastructure under dot-directories contributes no directories', () => {+ const directories = collectIndexDirectories([+ '.ok/templates/note',+ 'concepts/.ok/templates/card',+ 'real/doc',+ ]);+ expect(sorted(directories)).toEqual(['', 'real']);+ });++ test('the root is always present — an empty bundle or one holding only reserved files', () => {+ expect(sorted(collectIndexDirectories([]))).toEqual(['']);+ expect(sorted(collectIndexDirectories(['index', 'log']))).toEqual(['']);+ });++ test('the same documents in any order derive the same set', () => {+ const forward = collectIndexDirectories(['a/one', 'a/b/two', 'c/three']);+ const reverse = collectIndexDirectories(['c/three', 'a/b/two', 'a/one']);+ expect(sorted(forward)).toEqual(sorted(reverse));+ expect(sorted(forward)).toEqual(['', 'a', 'a/b', 'c']);+ });+});++describe('planDirectoryIndexRegenerations', () => {+ function directoryDeps(+ docs: Record<string, IndexSourceDoc>,+ currentMarkdownFor: (directory: string) => string | null = () => null,+ ): DirectoryIndexDeps {+ return { docs: Object.entries(docs), docExtension: () => '.md', currentMarkdownFor };+ }++ const TREE: Record<string, IndexSourceDoc> = {+ welcome: { title: 'Welcome', type: 'note' },+ 'concepts/aggregate': { title: 'Aggregate', type: 'concept' },+ 'concepts/nested/deep': { title: 'Deep', type: 'concept' },+ };++ test('produces one decision per directory, deepest-first, each scoped to its own directory', () => {+ const decisions = planDirectoryIndexRegenerations(directoryDeps(TREE));++ // Paths rebase to each index's own directory, the root alone carries+ // frontmatter, and a parent links the child's index document rather than a+ // bare folder. Deepest-first: the child directory precedes its parent.+ expect(decisions).toEqual([+ {+ directory: 'concepts/nested',+ changed: true,+ markdown: '# Index\n\n## concept\n\n* [Deep](./deep.md)\n',+ },+ {+ directory: 'concepts',+ changed: true,+ markdown:+ '# Index\n\n## concept\n\n* [Aggregate](./aggregate.md)\n\n## Subdirectories\n\n* [nested](./nested/index.md)\n',+ },+ {+ directory: '',+ changed: true,+ markdown:+ '---\nokf_version: "0.2"\n---\n\n# Index\n\n## note\n\n* [Welcome](./welcome.md)\n\n## Subdirectories\n\n* [concepts](./concepts/index.md)\n',+ },+ ]);+ });++ test('feeding each directory its own bytes back settles the whole set with no churn', () => {+ const first = planDirectoryIndexRegenerations(directoryDeps(TREE));+ const settled = new Map(first.map((d) => [d.directory, d.markdown]));++ // The fixed point, per directory: each index compared against its own output+ // reports unchanged, so a converged bundle sitting idle writes nothing.+ const second = planDirectoryIndexRegenerations(+ directoryDeps(TREE, (directory) => settled.get(directory) ?? null),+ );++ expect(second.some((d) => d.changed)).toBe(false);+ expect(second.map((d) => d.markdown)).toEqual(first.map((d) => d.markdown));+ });++ test('each decision compares against its own directory, not the root', () => {+ const rootBytes = planDirectoryIndexRegenerations(directoryDeps(TREE)).find(+ (d) => d.directory === '',+ )?.markdown;++ // Every directory is handed the ROOT's current bytes. Only the root matches;+ // a nested index compared against the root's bytes would wrongly settle.+ const changed = new Map(+ planDirectoryIndexRegenerations(directoryDeps(TREE, () => rootBytes ?? null)).map((d) => [+ d.directory,+ d.changed,+ ]),+ );++ expect(changed.get('')).toBe(false);+ expect(changed.get('concepts')).toBe(true);+ expect(changed.get('concepts/nested')).toBe(true);+ });++ test('a directory whose bytes already match is unchanged while a differing sibling rebuilds', () => {+ const conceptsBytes =+ planDirectoryIndexRegenerations(directoryDeps(TREE)).find((d) => d.directory === 'concepts')+ ?.markdown ?? null;++ const changed = new Map(+ planDirectoryIndexRegenerations(+ directoryDeps(TREE, (directory) => (directory === 'concepts' ? conceptsBytes : null)),+ ).map((d) => [d.directory, d.changed]),+ );++ expect(changed.get('concepts')).toBe(false);+ expect(changed.get('')).toBe(true);+ expect(changed.get('concepts/nested')).toBe(true);+ });++ test('a container directory with markdown only below it lists subdirectories and no type section', () => {+ // `guide` holds no document directly — only `guide/ddd/note` beneath it — so+ // its index is a pure navigation waypoint into `guide/ddd`.+ const guide = planDirectoryIndexRegenerations(+ directoryDeps({ 'guide/ddd/note': { title: 'Note', type: 'concept' } }),+ ).find((d) => d.directory === 'guide');++ expect(guide?.markdown).toBe('# Index\n\n## Subdirectories\n\n* [ddd](./ddd/index.md)\n');+ });++ test('the same documents in any input order produce identical decisions', () => {+ // Same-depth siblings exercise the tie-break: without a stable order among+ // equal depths, reversing the input would swap `alpha` and `beta`.+ const docs: Record<string, IndexSourceDoc> = {+ 'alpha/one': { title: 'One', type: 'note' },+ 'beta/two': { title: 'Two', type: 'note' },+ };+ const forward = planDirectoryIndexRegenerations(directoryDeps(docs));+ const reversed = planDirectoryIndexRegenerations(+ directoryDeps(Object.fromEntries(Object.entries(docs).reverse())),+ );++ expect(reversed).toEqual(forward);+ expect(forward.map((d) => d.directory)).toEqual(['alpha', 'beta', '']);+ });++ test('planning is complete even when docs is a single-use iterator', () => {+ function* once(): Generator<readonly [string, IndexSourceDoc]> {+ yield ['welcome', { title: 'Welcome', type: 'note' }];+ yield ['concepts/aggregate', { title: 'Aggregate', type: 'concept' }];+ }++ const decisions = planDirectoryIndexRegenerations({+ docs: once(),+ docExtension: () => '.md',+ currentMarkdownFor: () => null,+ });++ // A planner that iterated `docs` twice without materializing would see the+ // documents once (deriving the directory set) and an empty stream on the+ // second pass (the entries), yielding indexes that link to nothing.+ expect(decisions.map((d) => d.directory).sort()).toEqual(['', 'concepts']);+ expect(decisions.find((d) => d.directory === 'concepts')?.markdown).toContain(+ '* [Aggregate](./aggregate.md)',+ );+ expect(decisions.find((d) => d.directory === '')?.markdown).toContain(+ '* [Welcome](./welcome.md)',+ );+ });+});++/**+ * The gate on the highest-volume trigger. `onDiskFlush` fires on every settled+ * keystroke burst in the project, and this predicate is the only thing standing+ * between that and a rebuild — so both directions are load-bearing. Too eager+ * rewrites a tracked file while someone types prose; too lax and the feature+ * goes quietly dead.+ */+describe('indexedFieldsChanged', () => {+ const BODY = '\n# Heading\n\nSome prose.\n';+ const doc = (fm: string, body = BODY) => `---\n${fm}\n---\n${body}`;++ test('a title change schedules a rebuild', () => {+ const before = doc('title: Old\ntype: note');+ const after = doc('title: New\ntype: note');+ expect(indexedFieldsChanged(before, after, 'notes/a')).toBe(true);+ });++ test('a description change schedules a rebuild', () => {+ const before = doc('title: A\ndescription: Before\ntype: note');+ const after = doc('title: A\ndescription: After\ntype: note');+ expect(indexedFieldsChanged(before, after, 'notes/a')).toBe(true);+ });++ test('a type change schedules a rebuild — it moves the entry between sections', () => {+ const before = doc('title: A\ntype: note');+ const after = doc('title: A\ntype: concept');+ expect(indexedFieldsChanged(before, after, 'notes/a')).toBe(true);+ });++ test('editing only the body does NOT schedule a rebuild', () => {+ const fm = 'title: A\ndescription: D\ntype: note';+ const before = doc(fm, '\n# Heading\n\nSome prose.\n');+ const after = doc(+ fm,+ '\n# Heading\n\nSome prose, considerably extended.\n\nAnd a new paragraph.\n',+ );+ expect(indexedFieldsChanged(before, after, 'notes/a')).toBe(false);+ });++ test('adding a heading below the first does NOT schedule a rebuild', () => {+ // Only the FIRST heading can feed the title ladder; a later one changes+ // nothing the index renders.+ const fm = 'title: A\ntype: note';+ const before = doc(fm, '\n# Heading\n\nProse.\n');+ const after = doc(fm, '\n# Heading\n\nProse.\n\n## A later section\n\nMore.\n');+ expect(indexedFieldsChanged(before, after, 'notes/a')).toBe(false);+ });++ test('a frontmatter key the index never renders does NOT schedule a rebuild', () => {+ const before = doc('title: A\ntype: note\ntags: [x]');+ const after = doc('title: A\ntype: note\ntags: [x, y, z]');+ expect(indexedFieldsChanged(before, after, 'notes/a')).toBe(false);+ });++ test('an identical write does NOT schedule a rebuild', () => {+ const same = doc('title: A\ndescription: D\ntype: note');+ expect(indexedFieldsChanged(same, same, 'notes/a')).toBe(false);+ });++ test('a first write schedules a rebuild with no special case for absent previous bytes', () => {+ const after = doc('title: A\ntype: note');+ // Both shapes the caller can produce for "there was nothing here before".+ expect(indexedFieldsChanged(null, after, 'notes/a')).toBe(true);+ expect(indexedFieldsChanged(undefined, after, 'notes/a')).toBe(true);+ });++ test('a title arriving via the first-heading fallback schedules a rebuild', () => {+ // No frontmatter title on either side, so the title resolves from the H1 —+ // the ladder has to be walked, not just the frontmatter compared.+ const before = '# Old heading\n\nProse.\n';+ const after = '# New heading\n\nProse.\n';+ expect(indexedFieldsChanged(before, after, 'notes/a')).toBe(true);+ });+});++// The API mutation seam has no old bytes to diff — the file index cached the+// document's rendered fields before the write, so invalidation compares those+// cached fields against the new bytes instead.+describe('indexedMetadataChanged', () => {+ const BODY = '\n# Heading\n\nSome prose.\n';+ const doc = (fm: string, body = BODY) => `---\n${fm}\n---\n${body}`;++ test('absent cached fields schedule a rebuild', () => {+ // Where the seam lands when the file index holds no entry for the doc —+ // scheduling is the safe default the write layer's byte compare then absorbs.+ expect(indexedMetadataChanged(undefined, doc('title: A\ntype: note'), 'notes/a')).toBe(true);+ });++ test('cached fields matching the new bytes do NOT schedule a rebuild', () => {+ // The prose-only write: the body moved but every rendered field held.+ const previous = { title: 'A', description: 'D', type: 'note' };+ const after = doc('title: A\ndescription: D\ntype: note', '\n# A\n\nRewritten prose.\n');+ expect(indexedMetadataChanged(previous, after, 'notes/a')).toBe(false);+ });++ test('a title change schedules a rebuild', () => {+ const previous = { title: 'Old', type: 'note' };+ expect(indexedMetadataChanged(previous, doc('title: New\ntype: note'), 'notes/a')).toBe(true);+ });++ test('a description change schedules a rebuild', () => {+ const previous = { title: 'A', description: 'Before', type: 'note' };+ const after = doc('title: A\ndescription: After\ntype: note');+ expect(indexedMetadataChanged(previous, after, 'notes/a')).toBe(true);+ });++ test('a type change schedules a rebuild — it moves the entry between sections', () => {+ const previous = { title: 'A', type: 'note' };+ expect(indexedMetadataChanged(previous, doc('title: A\ntype: concept'), 'notes/a')).toBe(true);+ });++ test('an unenriched cached entry with a titled document schedules a rebuild', () => {+ // A cached entry built without enrichment carries undefined fields; the new+ // document resolves a real title, so they differ and a rebuild is scheduled.+ const previous = { title: undefined, description: undefined, type: undefined };+ expect(indexedMetadataChanged(previous, doc('title: A\ntype: note'), 'notes/a')).toBe(true);+ });+});++describe('directoryChainToRoot', () => {+ test('a nested directory yields itself then each ancestor, ending at root', () => {+ expect(directoryChainToRoot('a/b/c')).toEqual(['a/b/c', 'a/b', 'a', '']);+ });++ test('a top-level directory yields itself then root', () => {+ expect(directoryChainToRoot('a')).toEqual(['a', '']);+ });++ test('the root yields only itself', () => {+ expect(directoryChainToRoot('')).toEqual(['']);+ });+});++// The predicate behind the self-trigger guard: it must recognize a generated+// index by its basename at any depth, since a child index is what a+// root-name-only check would miss and let schedule its own rebuild.+describe('isGeneratedIndexDocName', () => {+ test('the root index is a generated index', () => {+ expect(isGeneratedIndexDocName('index')).toBe(true);+ });++ test('a child index one level down is a generated index', () => {+ expect(isGeneratedIndexDocName('concepts/index')).toBe(true);+ });++ test('a deeply nested index is a generated index', () => {+ expect(isGeneratedIndexDocName('a/b/c/index')).toBe(true);+ });++ test('an ordinary document is not a generated index', () => {+ expect(isGeneratedIndexDocName('concepts/bounded-context')).toBe(false);+ });++ test('the reserved log stem is not a generated index', () => {+ // `log` is reserved from entries but is not an index; its write must still+ // schedule a rebuild, which the byte comparison then absorbs.+ expect(isGeneratedIndexDocName('log')).toBe(false);+ expect(isGeneratedIndexDocName('concepts/log')).toBe(false);+ });++ test('a document whose name merely begins with index is not a generated index', () => {+ expect(isGeneratedIndexDocName('index-of-terms')).toBe(false);+ expect(isGeneratedIndexDocName('concepts/indexing')).toBe(false);+ });+});diff --git a/packages/server/src/content/regenerate-index.ts b/packages/server/src/content/regenerate-index.tsnew file mode 100644index 000000000..dda31e406--- /dev/null+++ b/packages/server/src/content/regenerate-index.ts@@ -0,0 +1,316 @@+/**+ * Decides whether the generated root `index.md` needs rewriting, and what its+ * bytes should be.+ *+ * Deliberately decides but does not write. The write is two different+ * operations depending on whether the document is open in an editor (a CRDT+ * paired write) or not (a disk write plus its index/durability ceremony), and+ * both live where their helpers do. Keeping the decision separate means the+ * part with all the rules is testable with a plain object instead of a booted+ * server.+ *+ * The returned `changed: false` is load-bearing, not an optimization. Writing+ * the index calls the same file-index and broadcast paths that trigger+ * regeneration, so a generator that always writes re-triggers itself. Comparing+ * bytes first turns that into a fixed point: an unchanged index performs no+ * write, mutates no index, and signals nothing.+ */++import { extractPageDescription, extractPageTitle, extractPageType } from '../page-identity.ts';+import { buildIndexMarkdown, type IndexEntry, type SubdirectoryEntry } from './generate-index.ts';++/** The bundle-root index, as a docName (extension-less, like every docName). */+export const ROOT_INDEX_DOC_NAME = 'index';++/**+ * Reserved stems are navigation and history for the bundle, not entries in it.+ * Excluding `index` also breaks the most direct self-trigger: an index that+ * listed itself would change its own inputs by existing.+ */+const RESERVED_STEMS: ReadonlySet<string> = new Set(['index', 'log']);++/**+ * The metadata the index needs from a document.+ *+ * Two callers supply it from different places, which is why this is an+ * interface rather than a read of the file index: the runtime generator passes+ * the watcher's cached entries, and `seed/apply.ts` passes the entries a pack+ * is about to scaffold, before any server exists. Keeping the source abstract+ * is what lets one builder serve both.+ */+export interface IndexSourceDoc {+ title?: string | undefined;+ description?: string | undefined;+ type?: string | undefined;+}++/** Cached fields captured before a watcher update mutates the file index. */+export interface PreviousIndexedFields {+ title?: string | undefined;+ description?: string | undefined;+ type?: string | undefined;+}++export interface DirectoryIndexDeps {+ /** Every markdown doc the content filter admits, keyed by docName. */+ docs: Iterable<readonly [string, IndexSourceDoc]>;+ /** `.md` or `.mdx` for a docName — links carry the real extension. */+ docExtension: (docName: string) => string;+ /**+ * Current bytes of the index in `directory` ('' for root, otherwise+ * content-root-relative), or `null` when it does not exist yet. Reading disk+ * or a resident document is the caller's job; the decision layer stays+ * server-free, so each directory's bytes arrive through this accessor rather+ * than one shared string.+ */+ currentMarkdownFor: (directory: string) => string | null;+}++export interface DirectoryIndexDecision {+ /** Content-root-relative directory this index lives in; '' for the root. */+ directory: string;+ /** False when the existing bytes already match — do nothing at all. */+ changed: boolean;+ /** The bytes the index should hold, whether or not they differ. */+ markdown: string;+}++/**+ * Infrastructure lives in dot-directories — `.ok/templates`, an installed pack+ * skill under `.claude/skills`. Those are markdown, and a consumer walking the+ * tree does see them, but they are not the bundle's knowledge and listing them+ * in a navigation index buries the content that is.+ */+function isInfrastructurePath(docName: string): boolean {+ return docName.split('/').some((segment) => segment.startsWith('.'));+}++function basenameOf(docName: string): string {+ return docName.split('/').pop() ?? docName;+}++/**+ * The immediate parent of a slash-separated path — a docName or a directory;+ * '' for anything at the root. Exported because the scheduler resolves a+ * document event to the directory whose index owns it.+ */+export function directoryOf(docName: string): string {+ const slash = docName.lastIndexOf('/');+ return slash === -1 ? '' : docName.slice(0, slash);+}++/**+ * A directory and every ancestor above it, ending at the root ''.+ *+ * The parent chain an event must invalidate when a directory's set of children+ * changes: each ancestor index carries links downward, so a created or deleted+ * subdirectory can move any index between the change and the root. An ancestor+ * with no index of its own produces no decision and is absorbed by the byte+ * comparison, so passing the whole chain is safe rather than exact.+ */+export function directoryChainToRoot(directory: string): string[] {+ const chain: string[] = [];+ let current = directory;+ while (current !== '') {+ chain.push(current);+ current = directoryOf(current);+ }+ chain.push('');+ return chain;+}++/**+ * Whether a docName names a generated index — the reserved `index` basename at+ * any depth (`index` at the root, `<dir>/index` below it).+ *+ * The self-trigger guard turns on this. A generated index is itself a file, and+ * writing a resident one reaches disk through the persistence flush, whose+ * completion hook re-enters the scheduler with the index's own docName; an index+ * that accepted that write would schedule its own rebuild forever. Matching only+ * the root name lets every generated child slip through. `log` — the other+ * reserved stem — is deliberately not matched: a `log` write moves no index+ * entry, so its rebuild is absorbed by the byte comparison rather than refused.+ */+export function isGeneratedIndexDocName(docName: string): boolean {+ return basenameOf(docName) === ROOT_INDEX_DOC_NAME;+}++/**+ * A document the index counts: neither a reserved stem nor infrastructure. The+ * entry list and the directory set filter on this one predicate, so "a directory+ * earns an index on the same terms a document earns an entry" is a code fact+ * rather than two rules kept in step by hand.+ */+function isAdmittedEntry(docName: string): boolean {+ return !RESERVED_STEMS.has(basenameOf(docName)) && !isInfrastructurePath(docName);+}++/**+ * Shape one admitted document as the index renders it. Shared by the root-only+ * collector and the per-directory planner so both emit byte-identical entries —+ * the title fallback and the extension-carrying path stay one code fact rather+ * than two that can drift.+ */+function toIndexEntry(+ docName: string,+ meta: IndexSourceDoc,+ docExtension: (docName: string) => string,+): IndexEntry {+ return {+ path: `${docName}${docExtension(docName)}`,+ // The file index resolves title through the full ladder (frontmatter, then+ // first heading) and falls back to the docName, so an absent title here+ // means an entry built without enrichment rather than an untitled document.+ // The docName is the same floor `/api/pages` uses.+ title: meta.title ?? basenameOf(docName),+ description: meta.description,+ type: meta.type,+ };+}++/**+ * The set of directories that should carry a generated index: the root always,+ * plus every ancestor directory of an admitted document.+ *+ * Root is unconditional — it is the bundle's entry point and exists even for a+ * bundle with no documents yet. A non-root directory earns an index only by+ * holding an admitted document somewhere at or below it, so a directory whose+ * only content is reserved files or infrastructure never appears.+ *+ * Derived from document keys alone — each key walked to its ancestors — so it+ * reads no directory and touches no disk. Deriving from the keys rather than the+ * watcher's folder index is what keeps empty directories out: the folder index+ * registers a directory whether or not any markdown lives in it, while the keys+ * are exactly the admitted-document set the entries come from.+ */+export function collectIndexDirectories(docNames: Iterable<string>): Set<string> {+ const directories = new Set<string>(['']);++ for (const docName of docNames) {+ if (!isAdmittedEntry(docName)) continue;++ const segments = docName.split('/');+ segments.pop();+ let directory = '';+ for (const segment of segments) {+ directory = directory === '' ? segment : `${directory}/${segment}`;+ directories.add(directory);+ }+ }++ return directories;+}++/** Path depth for deepest-first ordering; the root ('') is 0. */+function depthOf(directory: string): number {+ return directory === '' ? 0 : directory.split('/').length;+}++/**+ * Plan a rebuild decision for every directory that should carry an index.+ *+ * One decision per directory in the set, each built only from the documents+ * directly in that directory plus links to the immediate child directories, and+ * each compared against its own current bytes. That per-directory comparison is+ * what lets every index reach its own fixed point independently: an unchanged+ * directory reports `changed: false` and its consumer writes nothing.+ *+ * A child is listed by set membership, not by probing whether its index is+ * already on disk. Every directory in the set gets a decision in this same plan,+ * so the whole tree is internally consistent at once and a cold boot converges+ * without a second corrective pass. Decisions come back deepest-first so a+ * consumer writing them in order lands each child before the parent that links+ * it, never leaving a parent index pointing at an index not yet written.+ */+export function planDirectoryIndexRegenerations(+ deps: DirectoryIndexDeps,+): DirectoryIndexDecision[] {+ // Consumed twice below — once for the directory set, once to bucket entries —+ // so materialize it; a single-use iterator would be spent after the first pass.+ const docs = [...deps.docs];+ const directories = collectIndexDirectories(docs.map(([docName]) => docName));++ const entriesByDirectory = new Map<string, IndexEntry[]>();+ for (const [docName, meta] of docs) {+ if (!isAdmittedEntry(docName)) continue;+ const directory = directoryOf(docName);+ const bucket = entriesByDirectory.get(directory);+ if (bucket) bucket.push(toIndexEntry(docName, meta, deps.docExtension));+ else entriesByDirectory.set(directory, [toIndexEntry(docName, meta, deps.docExtension)]);+ }++ const childrenByParent = new Map<string, string[]>();+ for (const directory of directories) {+ if (directory === '') continue; // the root is nobody's child+ const parent = directoryOf(directory);+ const bucket = childrenByParent.get(parent);+ if (bucket) bucket.push(directory);+ else childrenByParent.set(parent, [directory]);+ }++ const decisions = [...directories].map((directory): DirectoryIndexDecision => {+ const entries = entriesByDirectory.get(directory) ?? [];+ // A subdirectory links to the child's generated index document. That index+ // is always written `.md` (never `.mdx`), so the target is fixed rather than+ // resolved through `docExtension`, which is for admitted documents.+ const subdirectories: SubdirectoryEntry[] = (childrenByParent.get(directory) ?? []).map(+ (child) => ({ path: `${child}/${ROOT_INDEX_DOC_NAME}.md`, title: basenameOf(child) }),+ );+ const markdown = buildIndexMarkdown(entries, {+ isRoot: directory === '',+ directory,+ subdirectories,+ });+ return { directory, changed: deps.currentMarkdownFor(directory) !== markdown, markdown };+ });++ // Deepest-first, with a code-point tie-break so the order is a pure function+ // of the directory set rather than of document iteration order.+ return decisions.sort(+ (left, right) =>+ depthOf(right.directory) - depthOf(left.directory) ||+ (left.directory < right.directory ? -1 : left.directory > right.directory ? 1 : 0),+ );+}++/**+ * Whether a write changed anything the index would show.+ *+ * The index renders exactly three fields, so every other edit — a paragraph, a+ * heading below the first, an unrelated frontmatter key — must not schedule a+ * rebuild. Editing prose is the common case by a wide margin, and treating it+ * as a trigger would rewrite the index on nearly every keystroke burst.+ *+ * A first write has no previous bytes; the title moves from nothing to+ * something, so a new document schedules a rebuild without a special case.+ */+export function indexedFieldsChanged(+ previousMarkdown: string | null | undefined,+ nextMarkdown: string,+ docName: string,+): boolean {+ const previous = previousMarkdown ?? '';+ return (+ extractPageTitle(previous, docName) !== extractPageTitle(nextMarkdown, docName) ||+ extractPageDescription(previous) !== extractPageDescription(nextMarkdown) ||+ extractPageType(previous) !== extractPageType(nextMarkdown)+ );+}++/**+ * Semantic invalidation for external watcher updates, whose old full bytes are+ * no longer available after classification but whose cached rendered fields+ * were captured before the file-index mutation.+ */+export function indexedMetadataChanged(+ previous: PreviousIndexedFields | undefined,+ nextMarkdown: string,+ docName: string,+): boolean {+ if (previous === undefined) return true;+ return (+ previous.title !== extractPageTitle(nextMarkdown, docName) ||+ previous.description !== extractPageDescription(nextMarkdown) ||+ previous.type !== extractPageType(nextMarkdown)+ );+}diff --git a/packages/server/src/file-watcher.test.ts b/packages/server/src/file-watcher.test.tsindex d81ad47f4..57f571517 100644--- a/packages/server/src/file-watcher.test.ts+++ b/packages/server/src/file-watcher.test.ts@@ -169,7 +169,20 @@ describe('isSelfWrite', () => {registerWrite(path, contentHash('hello'));expect(isSelfWrite(path, contentHash('world'))).toBe(false);- expect(writeTracker.has(path)).toBe(true);+ expect(writeTracker.has(path)).toBe(false);+ });++ test('a later matching write consumes coalesced registrations before it', () => {+ const path = '/content/test.md';+ const first = contentHash('first');+ const second = contentHash('second');+ const third = contentHash('third');+ registerWrite(path, first);+ registerWrite(path, second);+ registerWrite(path, third);++ expect(isSelfWrite(path, second)).toBe(true);+ expect(writeTracker.get(path)?.map((entry) => entry.hash)).toEqual([third]);});});@@ -1179,6 +1192,54 @@ describe('file-watcher ContentFilter refcount hooks', () => {);});+ test('a collapsed folder delete synthesizes deletes for indexed descendants', async () => {+ const folderIndex = new Map();+ const fileIndex = new Map();+ const collected: DiskEvent[] = [];+ const notesDir = resolve(contentDir, 'notes');+ const nestedDir = resolve(notesDir, 'nested');+ const notePath = resolve(nestedDir, 'note.md');+ mkdirSync(nestedDir, { recursive: true });+ writeFileSync(notePath, '# Note\n');++ await handleRawEvents(+ [+ { type: 'create', path: notesDir },+ { type: 'create', path: nestedDir },+ { type: 'create', path: notePath },+ ],+ contentDir,+ undefined,+ fileIndex,+ folderIndex,+ async (event) => {+ collected.push(event);+ },+ );+ expect(fileIndex.has('notes/nested/note')).toBe(true);++ collected.length = 0;+ await rm(notesDir, { recursive: true, force: true });+ await handleRawEvents(+ [{ type: 'delete', path: notesDir }],+ contentDir,+ undefined,+ fileIndex,+ folderIndex,+ async (event) => {+ collected.push(event);+ },+ );++ expect(fileIndex.has('notes/nested/note')).toBe(false);+ expect(collected).toContainEqual(+ expect.objectContaining({ kind: 'delete', docName: 'notes/nested/note' }),+ );+ expect(collected).toContainEqual(+ expect.objectContaining({ kind: 'folder-delete', relativePath: 'notes' }),+ );+ });+test('mkdir -p race: single create event for parent surfaces folder-create for all pre-existing subdirs', async () => {// On Linux, `mkdir -p deep/nested/empty` creates all three levels faster// than parcel-watcher can call inotify_add_watch on each new directory,diff --git a/packages/server/src/file-watcher.ts b/packages/server/src/file-watcher.tsindex 2b2c3bf4d..f46a5189e 100644--- a/packages/server/src/file-watcher.ts+++ b/packages/server/src/file-watcher.ts@@ -39,7 +39,12 @@ import {import { classifyFsPath, normalizeFsPath } from './fs-traced.ts';import { errnoCode } from './http/handler-utils.ts';import { getLogger } from './logger.ts';-import { extractPageIcon, extractPageTitle } from './page-identity.ts';+import {+ extractPageDescription,+ extractPageIcon,+ extractPageTitle,+ extractPageType,+} from './page-identity.ts';import { toPosix } from './path-utils.ts';import { containsConflictMarkers } from './reconciliation.ts';import { getMeter, withSpan } from './telemetry.ts';@@ -58,7 +63,18 @@ type WatcherBackend = 'parcel' | 'chokidar';// Subset of DiskEvent that classifyEvents emits — markdown-only.type MarkdownDiskEvent =| { kind: 'create'; path: string; docName: string; content: string }- | { kind: 'update'; path: string; docName: string; content: string }+ | {+ kind: 'update';+ path: string;+ docName: string;+ content: string;+ /** Rendered index fields before this update replaced the cached entry. */+ previousIndexedFields?: {+ title?: string;+ description?: string;+ type?: string;+ };+ }| { kind: 'delete'; path: string; docName: string }| {kind: 'rename';@@ -155,6 +171,15 @@ export interface FileIndexEntry {*/title?: string;icon?: string;+ /**+ * Frontmatter `description` and `type`, cached on the same terms as `title`:+ * derived from content already in hand, never a extra read. The generated+ * root index groups by `type` and renders `description`, and it rebuilds on+ * every qualifying write — re-reading every document per rebuild is the cost+ * this avoids. Both stay `undefined` when the frontmatter omits them.+ */+ description?: string;+ type?: string;}export interface FolderIndexEntry {@@ -173,8 +198,18 @@ export interface FolderIndexEntry {function derivePageMeta(content: string,docName: string,-): { title: string; icon: string | undefined } {- return { title: extractPageTitle(content, docName), icon: extractPageIcon(content) };+): {+ title: string;+ icon: string | undefined;+ description: string | undefined;+ type: string | undefined;+} {+ return {+ title: extractPageTitle(content, docName),+ icon: extractPageIcon(content),+ description: extractPageDescription(content),+ type: extractPageType(content),+ };}/**@@ -817,8 +852,19 @@ export function isSelfWrite(filePath: string, hash: string): boolean {const queue = writeTracker.get(filePath);if (!queue) return false;const idx = queue.findIndex((e) => e.hash === hash);- if (idx < 0) return false;- queue.splice(idx, 1);+ if (idx < 0) {+ // The file has moved to bytes we did not author. Any older registrations+ // for this path describe writes that the filesystem has already passed,+ // even when a backend coalesced away their individual events. Retaining+ // them could misclassify a later external edit that happens to restore+ // those bytes as one of our own writes.+ writeTracker.delete(filePath);+ return false;+ }+ // Reaching a later queued hash also proves every earlier registered write+ // has been observed or coalesced. Keep only registrations for writes that+ // were made after the matching one.+ queue.splice(0, idx + 1);if (queue.length === 0) writeTracker.delete(filePath);return true;}@@ -1440,7 +1486,25 @@ export async function handleRawEvents();}}- const fileEvents = rescuedCreates.length > 0 ? safeEvents.concat(rescuedCreates) : safeEvents;+ // Linux can collapse `rm -r folder` to one unlinkDir event. Re-expand that+ // event from the last trustworthy file-index snapshot so descendants leave+ // every downstream index even when the backend emitted no per-file unlink.+ // Explicit child deletes already present in the batch win, and the normal+ // classifier handles rename pairing when the folder was moved rather than+ // destroyed.+ const batchPaths = new Set(safeEvents.map((event) => event.path));+ const collapsedDeletes: RawFileEvent[] = [];+ for (const folderEvent of folderEvents) {+ if (folderEvent.kind !== 'folder-delete') continue;+ const prefix = `${folderEvent.relativePath}/`;+ for (const [indexedPath, entry] of fileIndex) {+ if (!indexedPath.startsWith(prefix) || batchPaths.has(entry.canonicalPath)) continue;+ batchPaths.add(entry.canonicalPath);+ collapsedDeletes.push({ type: 'delete', path: entry.canonicalPath });+ }+ }++ const fileEvents = safeEvents.concat(rescuedCreates, collapsedDeletes);const mdEvents = fileEvents.filter((e) => isSupportedDocFile(e.path));const assetEvents = fileEvents.filter((e) =>@@ -1482,6 +1546,19 @@ export async function handleRawEvents(for (const event of diskEvents) {let isSelf = false;+ const previousIndexedFields =+ event.kind === 'update'+ ? (() => {+ const previous = fileIndex.get(event.docName);+ if (previous?.kind !== 'markdown') return undefined;+ return {+ title: previous.title,+ description: previous.description,+ type: previous.type,+ };+ })()+ : undefined;+if (event.kind !== 'delete' && event.kind !== 'rename') {const hash = contentHash(event.content);let checkPath = event.path;@@ -1514,6 +1591,11 @@ export async function handleRawEvents(isSelf = isSelfWrite(checkPath, hash);}+ const dispatchedEvent =+ event.kind === 'update' && previousIndexedFields !== undefined+ ? { ...event, previousIndexedFields }+ : event;+updateFileIndex(event, fileIndex);// Update the content filter's dirCount only for external changes. Self-@@ -1587,7 +1669,7 @@ export async function handleRawEvents('disk.path.role': classifyFsPath(rawPath),},},- async () => onDiskEvent(event),+ async () => onDiskEvent(dispatchedEvent),);}diff --git a/packages/server/src/lint/audit.ts b/packages/server/src/lint/audit.tsindex de0d4e0bf..87632500e 100644--- a/packages/server/src/lint/audit.ts+++ b/packages/server/src/lint/audit.ts@@ -376,7 +376,13 @@ function resolveCanonicalDocPath(abs: string, contentDir: string): string {type Scope = { kind: 'dir' | 'file'; path: string };-function resolveScope(targetPath: string | undefined, contentDir: string): Scope {+/**+ * Classify an audit target as a single file or a directory to walk. Exported because+ * every validator that walks the tree must agree with the lint walk about what a scope+ * MEANS — a validator that treats a doc-scoped target as a directory calls `readdir` on a+ * file and silently reports nothing.+ */+export function resolveScope(targetPath: string | undefined, contentDir: string): Scope {if (targetPath === undefined || targetPath === '') return { kind: 'dir', path: contentDir };const abs = isAbsolute(targetPath) ? targetPath : resolve(contentDir, targetPath);try {diff --git a/packages/server/src/lint/okf-project-validator.ts b/packages/server/src/lint/okf-project-validator.tsnew file mode 100644index 000000000..9f3c07b26--- /dev/null+++ b/packages/server/src/lint/okf-project-validator.ts@@ -0,0 +1,98 @@+/**+ * The OKF project validator: the checks that need the shape of the tree.+ *+ * A third execution model alongside the lint validator (walks and lints each document)+ * and the links validator (reads an in-memory index): this one walks for the file LIST+ * only, never reading a document's contents, then judges the list as a whole. The editor+ * lints by an extension-less docName, so only the walked list shows which files are+ * `.mdx` — that is what keeps this rule out of the `okf` lint plugin. It still reports+ * under the same `okf` source and the same `contentRules.okf.rules` toggles, so a reader+ * sees one coherent family.+ *+ * The rule bodies are pure and live in core; this file owns only the thing core cannot+ * do — walking the tree.+ */++import { dirname, relative } from 'node:path';+import {+ type LinterConfig,+ runOkfProjectRules,+ type ValidationDiagnostic,+} from '@inkeep/open-knowledge-core';+import { collectDocFiles, resolveScope } from './audit.ts';+import type { ProjectValidator, ValidationScope } from './validation-audit.ts';++/**+ * Zero-width anchor at the top of the file. A project finding is about the file's+ * existence or its name, not a region inside it, and this validator walks the file+ * LIST without reading any document's text — so there is no line whose length could+ * size a span. The finding attaches to the file (Problems panel, `ok audit`); the+ * range only places its editor marker at the start.+ */+const FILE_RANGE = {+ start: { line: 0, character: 0 },+ end: { line: 0, character: 0 },+} as const;++export interface OkfProjectValidatorDeps {+ projectDir: string;+ contentDir: string;+ baseConfig: LinterConfig;+}++export function createOkfProjectValidator(deps: OkfProjectValidatorDeps): ProjectValidator {+ return {+ id: 'okf-project',+ async run(scope: ValidationScope) {+ const slice = deps.baseConfig.plugins.okf;+ // Plugin off is a clean empty contribution, not a degradation warning — the+ // project chose not to run OKF at all.+ if (!deps.baseConfig.enabled || !slice?.enabled) {+ return { files: [], fileCount: 0, warnings: [] };+ }++ const warnings: string[] = [];+ // Classify the target the way the lint walk does. A doc-scoped audit — what the+ // Problems panel issues for the open document — targets a FILE, and handing a file+ // path to the walk as a directory makes `readdir` throw and this validator report+ // nothing at all.+ //+ // A file target still walks its DIRECTORY rather than standing alone, then keeps+ // only that file's findings. The rule needs its siblings to know whether an `.mdx`+ // is shadowed by a same-stem `.md`, and a lone-file list would silently downgrade+ // every shadowed file to the unshadowed message.+ const resolved = resolveScope(scope.targetPath, deps.contentDir);+ const targetFile =+ resolved.kind === 'file' ? relative(deps.contentDir, resolved.path) : undefined;+ const walkDir = resolved.kind === 'file' ? dirname(resolved.path) : resolved.path;+ const docFiles = collectDocFiles({+ projectDir: deps.projectDir,+ contentDir: deps.contentDir,+ scopeDir: walkDir,+ onWarning: (warning) => warnings.push(warning),+ });++ const byFile = new Map<string, ValidationDiagnostic[]>();+ for (const finding of runOkfProjectRules(docFiles, slice.rules)) {+ if (targetFile !== undefined && finding.file !== targetFile) continue;+ const diagnostics = byFile.get(finding.file) ?? [];+ diagnostics.push({+ range: FILE_RANGE,+ severity: 'warning',+ source: 'okf',+ code: finding.code,+ message: finding.message,+ });+ byFile.set(finding.file, diagnostics);+ }++ return {+ files: [...byFile.entries()].map(([file, diagnostics]) => ({ file, diagnostics })),+ // Unlike the links validator this one really walked the tree, so it is a+ // full-scan authority for the scope it was given.+ fileCount: targetFile === undefined ? docFiles.length : 1,+ warnings,+ };+ },+ };+}diff --git a/packages/server/src/lint/validation-audit.test.ts b/packages/server/src/lint/validation-audit.test.tsindex 6846acfc4..5cba46b68 100644--- a/packages/server/src/lint/validation-audit.test.ts+++ b/packages/server/src/lint/validation-audit.test.ts@@ -641,6 +641,146 @@ describe('local-target findings (files, images, reference-style)', () => {});});+describe('the OKF project validator', () => {+ /** OKF on, everything else off, so the plane carries only project findings. */+ const okfOnly: LinterConfig = {+ ...DEFAULT_LINTER_CONFIG,+ plugins: {+ ...DEFAULT_LINTER_CONFIG.plugins,+ markdownlint: { ...DEFAULT_LINTER_CONFIG.plugins.markdownlint, enabled: false },+ okf: { enabled: true },+ },+ } as LinterConfig;++ /** Write a file without indexing it — these checks judge the tree, not link graph. */+ function writeFile(rel: string, body = '---\ntype: Note\n---\n\nBody.\n'): void {+ const abs = join(root, rel);+ mkdirSync(join(abs, '..'), { recursive: true });+ writeFileSync(abs, body, 'utf-8');+ }++ const auditOkf = async (overrides: Partial<ValidationAuditDeps> = {}) =>+ runValidationAudit(+ createProjectValidators(deps({ baseConfig: okfOnly, linksValidation: 'off', ...overrides })),+ );++ test('a mis-cased reserved file reaches the plane under the okf source', async () => {+ writeFile('Index.md', '# Index\n\n* [a](a.md) - a\n');+ const result = await auditOkf();+ const row = result.files.find((f) => f.file === 'Index.md');+ expect(row?.diagnostics.map((d) => d.code)).toContain('reserved-casing');+ expect(row?.diagnostics.every((d) => d.source === 'okf')).toBe(true);+ });++ test('a DOC-SCOPED audit still reports — the shape the Problems panel asks for', async () => {+ // The panel scopes to the open document, which resolves to a FILE path. Handing that+ // to the tree walk as a directory made `readdir` throw and the validator return+ // nothing, so every project finding was invisible in the panel while the+ // whole-project tests stayed green.+ writeFile('guide.md');+ writeFile('guide.mdx');+ const scoped = await runValidationAudit(+ createProjectValidators(deps({ baseConfig: okfOnly, linksValidation: 'off' })),+ { targetPath: 'guide.mdx' },+ );+ expect(scoped.files.flatMap((f) => f.diagnostics).map((d) => d.code)).toEqual([+ 'project-no-mdx',+ ]);+ expect(scoped.warnings).toEqual([]);+ });++ test('a doc-scoped audit keeps its sibling context', async () => {+ // Scoping to one file still walks its directory, so a shadowed .mdx is still known+ // to be shadowed. Linting the file alone would silently downgrade the message.+ writeFile('guide.md');+ writeFile('guide.mdx');+ const scoped = await runValidationAudit(+ createProjectValidators(deps({ baseConfig: okfOnly, linksValidation: 'off' })),+ { targetPath: 'guide.mdx' },+ );+ const message = scoped.files.flatMap((f) => f.diagnostics)[0]?.message ?? '';+ expect(message).toContain("won't be picked up");+ expect(message).toContain('shadowed by');+ });++ test('a doc-scoped audit reports only that document', async () => {+ writeFile('one.mdx');+ writeFile('two.mdx');+ const scoped = await runValidationAudit(+ createProjectValidators(deps({ baseConfig: okfOnly, linksValidation: 'off' })),+ { targetPath: 'one.mdx' },+ );+ expect(scoped.files.map((f) => f.file)).toEqual(['one.mdx']);+ });++ test('an .mdx beside its .md is flagged, and the .md is not', async () => {+ writeFile('guide.md');+ writeFile('guide.mdx');+ const result = await auditOkf();+ expect(result.files.find((f) => f.file === 'guide.mdx')?.diagnostics[0]?.code).toBe(+ 'project-no-mdx',+ );+ expect(result.files.find((f) => f.file === 'guide.md')).toBeUndefined();+ });++ test('a clean project produces no okf findings', async () => {+ writeFile('index.md', '# Index\n\n* [a](a.md) - a\n');+ writeFile('a.md');+ const result = await auditOkf();+ const okf = result.files.flatMap((f) => f.diagnostics).filter((d) => d.source === 'okf');+ expect(okf).toEqual([]);+ });++ test('the plugin switched off is a clean empty contribution, not a warning', async () => {+ writeFile('Index.md');+ const off = {+ ...okfOnly,+ plugins: { ...okfOnly.plugins, okf: { enabled: false } },+ } as LinterConfig;+ const result = await auditOkf({ baseConfig: off });+ expect(result.files.flatMap((f) => f.diagnostics)).toEqual([]);+ expect(result.warnings).toEqual([]);+ });++ test('a single rule can be switched off without silencing its siblings', async () => {+ // The two now run in different validators — casing per document, .mdx over the tree —+ // and one toggle map governs both.+ writeFile('Index.md');+ writeFile('guide.mdx');+ const oneOff = {+ ...okfOnly,+ plugins: {+ ...okfOnly.plugins,+ okf: { enabled: true, rules: { 'reserved-casing': false } },+ },+ } as LinterConfig;+ const result = await auditOkf({ baseConfig: oneOff });+ const codes = result.files.flatMap((f) => f.diagnostics).map((d) => d.code);+ expect(codes).toContain('project-no-mdx');+ expect(codes).not.toContain('reserved-casing');+ });++ test('a scoped audit sees only its subtree', async () => {+ // Honest limitation, pinned rather than papered over: scoping narrows the walk, so+ // a violation outside the scope reports nothing. A reader scoping an audit should+ // not read that silence as a clean project.+ writeFile('Index.md');+ mkdirSync(join(root, 'sub'), { recursive: true });+ writeFile('sub/keeper.md');++ const whole = await auditOkf();+ expect(whole.files.flatMap((f) => f.diagnostics).map((d) => d.code)).toContain(+ 'reserved-casing',+ );++ const scoped = await runValidationAudit(+ createProjectValidators(deps({ baseConfig: okfOnly, linksValidation: 'off' })),+ { targetPath: 'sub' },+ );+ expect(scoped.files.flatMap((f) => f.diagnostics)).toEqual([]);+ });+});+describe('toValidationCountsPlane', () => {test('tallies the merged plane per file and per source, dropping the bodies', async () => {// One doc carrying BOTH a lint finding and a dead link, so the split isdiff --git a/packages/server/src/lint/validation-audit.ts b/packages/server/src/lint/validation-audit.tsindex 9e2ade664..54e50006b 100644--- a/packages/server/src/lint/validation-audit.ts+++ b/packages/server/src/lint/validation-audit.ts@@ -4,8 +4,10 @@* "given the project (or a sub-path), what per-file diagnostics hold?" behind* one interface while owning its own execution model — the lint validator* walks the content tree via `auditProject`; the links validator reads the- * derived document index. The engine fans out and merges everything into- * one source-tagged diagnostic plane. Backs `GET /api/audit` + MCP `audit`.+ * derived document index; the OKF project validator walks for the file LIST+ * and judges it as a whole, reading no document. The engine fans out and merges+ * everything into one source-tagged diagnostic plane. Backs `GET /api/audit` ++ * MCP `audit`.*/import {@@ -25,6 +27,7 @@ import {import { getLogger } from '../logger.ts';import { AuditSupersededError, auditProject } from './audit.ts';import type { AuditCache } from './audit-cache.ts';+import { createOkfProjectValidator } from './okf-project-validator.ts';type DeadLinksResult = Awaited<ReturnType<DerivedDocumentIndexApiPort['getDeadLinks']>>;type LocalTargetsResult = Awaited<@@ -139,7 +142,7 @@ export interface ValidationAuditDeps {* one factory here — the engine body never changes.*/export function createProjectValidators(deps: ValidationAuditDeps): ProjectValidator[] {- return [createLintValidator(deps), createLinksValidator(deps)];+ return [createLintValidator(deps), createLinksValidator(deps), createOkfProjectValidator(deps)];}/** Fan out to every validator, then merge into one per-file diagnostic plane. */diff --git a/packages/server/src/lint/write-okf-schemas-wiring.test.ts b/packages/server/src/lint/write-okf-schemas-wiring.test.tsnew file mode 100644index 000000000..fe5a4e365--- /dev/null+++ b/packages/server/src/lint/write-okf-schemas-wiring.test.ts@@ -0,0 +1,133 @@+/**+ * The wiring root for OKF schema materialization: a real booted server, a real request,+ * and the files actually on disk afterwards.+ *+ * `write-okf-schemas.test.ts` covers the writer itself, and covers it well — but every+ * assertion there calls the function directly. Deleting the single production call site+ * left the whole suite green while the feature was dead: advertisement would name+ * `.ok/okf/*.schema.json` and nothing would ever create one, so every agent following a+ * path would find nothing. That is the gap this file exists for, and only a test that+ * never mentions the writer can close it.+ *+ * The trigger is deliberate. The materializer hangs off the config funnel rather than+ * boot, because the plugin can be switched on while the server runs — so the request+ * below is the point, not an incidental way to reach the code.+ */++import { existsSync, mkdirSync, writeFileSync } from 'node:fs';+import { mkdtemp, rm } from 'node:fs/promises';+import { tmpdir } from 'node:os';+import { join, resolve } from 'node:path';+import {+ type Config,+ ConfigSchema,+ okfAdvertisedSchemaMappings,+} from '@inkeep/open-knowledge-core';+import { afterEach, beforeEach, describe, expect, test } from 'vitest';+import { type BootedServer, bootServer } from '../boot.ts';+import { resetOkfSchemaWriteState } from './write-okf-schemas.ts';++let tmpDir: string;+let booted: BootedServer | null = null;++beforeEach(async () => {+ tmpDir = await mkdtemp(resolve(tmpdir(), 'ok-okf-wiring-'));+ // The write-once guard is module state; a previous test's project must not+ // make this one's write look like it already happened.+ resetOkfSchemaWriteState();+});++afterEach(async () => {+ await booted?.destroy();+ booted = null;+ await rm(tmpDir, { recursive: true, force: true });+});++/** A project whose committed config decides whether the OKF plugin is on. */+function seedProject(okfEnabled: boolean, okfExtraYaml = ''): string {+ const project = resolve(tmpDir, 'project');+ mkdirSync(join(project, '.ok'), { recursive: true });+ writeFileSync(+ join(project, '.ok', 'config.yml'),+ okfEnabled ? `contentRules:\n okf:\n enabled: true\n${okfExtraYaml}` : 'contentRules: {}\n',+ 'utf8',+ );+ writeFileSync(resolve(project, 'note.md'), '---\ntype: Note\n---\n\nBody.\n', 'utf8');+ return project;+}++const TEST_CONFIG: Config = ConfigSchema.parse({});++async function boot(project: string): Promise<BootedServer> {+ booted = await bootServer({+ host: '127.0.0.1',+ config: TEST_CONFIG,+ contentDir: project,+ projectDir: project,+ port: 0,+ quiet: true,+ gitEnabled: false,+ idleShutdownMs: null,+ });+ await booted.ready;+ return booted;+}++describe('OKF schemas reach disk through a real server', () => {+ test('an audit request materializes them under .ok/okf/', async () => {+ const project = seedProject(true);+ const server = await boot(project);++ // The request the Problems panel makes. Nothing here names the writer — if the+ // config funnel stops calling it, this is what notices.+ const res = await fetch(`http://127.0.0.1:${server.port}/api/audit`);+ expect(res.ok).toBe(true);++ for (const name of [+ 'required',+ 'recommended',+ 'provenance',+ 'computation',+ 'reserved-index',+ 'root-index',+ ]) {+ const path = join(project, '.ok', 'okf', `${name}.schema.json`);+ expect(existsSync(path), path).toBe(true);+ }+ });++ test('every advertised path is one an agent could actually open', async () => {+ // The two halves have to agree at RUNTIME, not just in a unit test: an advertised+ // path that resolves to nothing is worse than the opaque identifier it replaced.+ // Read the advertisement the agent reads, then open every path it names.+ const project = seedProject(true);+ const server = await boot(project);+ await fetch(`http://127.0.0.1:${server.port}/api/audit`);++ const advertised = okfAdvertisedSchemaMappings(undefined).map((m) => m.file);+ expect(advertised.length).toBeGreaterThan(0);+ for (const path of advertised) {+ expect(existsSync(join(project, path)), path).toBe(true);+ }+ });++ test('a rule disabled in config never materializes its schema', async () => {+ // Advertisement stops naming a disabled rule's schema, so the file must not+ // exist either — the two halves track the same toggle through the funnel.+ const project = seedProject(true, ' rules:\n frontmatter-provenance: false\n');+ const server = await boot(project);+ await fetch(`http://127.0.0.1:${server.port}/api/audit`);++ expect(existsSync(join(project, '.ok', 'okf', 'provenance.schema.json'))).toBe(false);+ expect(existsSync(join(project, '.ok', 'okf', 'required.schema.json'))).toBe(true);+ });++ test('with the plugin off, nothing is written', async () => {+ const project = seedProject(false);+ const server = await boot(project);++ await fetch(`http://127.0.0.1:${server.port}/api/audit`);++ expect(existsSync(join(project, '.ok', 'okf'))).toBe(false);+ });+});diff --git a/packages/server/src/lint/write-okf-schemas.test.ts b/packages/server/src/lint/write-okf-schemas.test.tsnew file mode 100644index 000000000..68aa5733f--- /dev/null+++ b/packages/server/src/lint/write-okf-schemas.test.ts@@ -0,0 +1,215 @@+/**+ * Materializing the OKF schemas into `.ok/okf/`.+ *+ * The files exist so an agent told a contract governs a document can go read it. That+ * makes two things load-bearing and tested here: the bytes must match what the plugin+ * actually validates with (a drifted file describes a contract nothing enforces), and+ * the advertised path must be the path written (an agent following it must not 404).+ */++import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';+import { tmpdir } from 'node:os';+import { join } from 'node:path';+import {+ OKF_FRONTMATTER_REGISTRY,+ OKF_SCHEMA_DIR,+ okfSchemaPathFor,+ renderOkfSchemaFiles,+} from '@inkeep/open-knowledge-core';+import { afterEach, beforeEach, describe, expect, test } from 'vitest';+import {+ ensureOkfSchemaFiles,+ resetOkfSchemaWriteState,+ writeOkfSchemaFiles,+} from './write-okf-schemas.ts';++let root: string;++beforeEach(() => {+ root = mkdtempSync(join(tmpdir(), 'ok-okf-schemas-'));+ mkdirSync(join(root, '.ok'), { recursive: true });+ resetOkfSchemaWriteState();+});+afterEach(() => {+ rmSync(root, { recursive: true, force: true });+});++const read = (rel: string) => readFileSync(join(root, rel), 'utf8');++describe('writing the schemas', () => {+ test('every registered schema lands at the path it is advertised as', () => {+ // The whole point of the file is that an advertised name can be followed.+ writeOkfSchemaFiles(root);+ for (const entry of OKF_FRONTMATTER_REGISTRY) {+ const advertised = okfSchemaPathFor(entry.id);+ expect(existsSync(join(root, advertised)), advertised).toBe(true);+ }+ });++ test('the written bytes ARE the schema the plugin validates with', () => {+ // The drift guard. The constants are the source and these files are a rendering;+ // if they could diverge, an agent would read a contract nothing enforces.+ writeOkfSchemaFiles(root);+ for (const file of renderOkfSchemaFiles()) {+ const onDisk = JSON.parse(read(file.path));+ const { $comment, ...schema } = onDisk;+ const entry = OKF_FRONTMATTER_REGISTRY.find((e) => e.id === file.ruleId);+ expect(schema, file.path).toEqual(entry?.schema);+ expect($comment).toBeTypeOf('string');+ }+ });++ test('each file says it is generated and that editing it does nothing', () => {+ writeOkfSchemaFiles(root);+ const first = JSON.parse(read(okfSchemaPathFor('frontmatter-required')));+ expect(first.$comment).toMatch(/do not edit/i);+ expect(first.$comment).toMatch(/overwritten/i);+ });++ test('an edit is reverted on the next write', () => {+ // Rewriting unconditionally is what makes the generated-ness observable rather+ // than merely asserted in a comment.+ writeOkfSchemaFiles(root);+ const path = okfSchemaPathFor('frontmatter-required');+ writeFileSync(join(root, path), '{"type":"object"}\n', 'utf8');+ writeOkfSchemaFiles(root);+ expect(JSON.parse(read(path)).title).toContain('OKF v0.2');+ });++ test('an unchanged rewrite produces identical bytes', () => {+ writeOkfSchemaFiles(root);+ const path = okfSchemaPathFor('frontmatter-provenance');+ const before = read(path);+ writeOkfSchemaFiles(root);+ expect(read(path)).toBe(before);+ });+});++describe('git handling', () => {+ test('the generated directory is added to .ok/.gitignore', () => {+ writeFileSync(join(root, '.ok', '.gitignore'), 'local/\n', 'utf8');+ writeOkfSchemaFiles(root);+ expect(read('.ok/.gitignore')).toMatch(/^okf\/$/m);+ });++ test('the rule is not duplicated on a second write', () => {+ writeFileSync(join(root, '.ok', '.gitignore'), 'local/\n', 'utf8');+ writeOkfSchemaFiles(root);+ writeOkfSchemaFiles(root);+ const lines = read('.ok/.gitignore')+ .split('\n')+ .filter((l) => l.trim() === 'okf/');+ expect(lines).toHaveLength(1);+ });++ test('a rule the user already wrote themselves is left alone', () => {+ writeFileSync(join(root, '.ok', '.gitignore'), 'local/\n okf/ \n', 'utf8');+ writeOkfSchemaFiles(root);+ const lines = read('.ok/.gitignore')+ .split('\n')+ .filter((l) => l.trim() === 'okf/');+ expect(lines).toHaveLength(1);+ });++ test('a project with no .ok/.gitignore still gets its schemas', () => {+ // Nothing to extend and no conventions to guess at — write the schemas anyway.+ rmSync(join(root, '.ok', '.gitignore'), { force: true });+ expect(writeOkfSchemaFiles(root).length).toBeGreaterThan(0);+ expect(existsSync(join(root, OKF_SCHEMA_DIR))).toBe(true);+ });+});++describe('rule toggles', () => {+ test('a disabled rule loses its schema file and keeps the others', () => {+ writeOkfSchemaFiles(root);+ writeOkfSchemaFiles(root, { 'frontmatter-provenance': false });+ expect(existsSync(join(root, okfSchemaPathFor('frontmatter-provenance')))).toBe(false);+ expect(existsSync(join(root, okfSchemaPathFor('frontmatter-required')))).toBe(true);+ });++ test('re-enabling a rule restores its schema file', () => {+ writeOkfSchemaFiles(root, { 'frontmatter-provenance': false });+ writeOkfSchemaFiles(root);+ expect(existsSync(join(root, okfSchemaPathFor('frontmatter-provenance')))).toBe(true);+ });++ test('a body rule with no schema changes nothing', () => {+ // Only frontmatter rules materialize files; toggling e.g. no-wiki-links+ // must not disturb the directory.+ writeOkfSchemaFiles(root);+ const before = OKF_FRONTMATTER_REGISTRY.map((e) => read(okfSchemaPathFor(e.id)));+ writeOkfSchemaFiles(root, { 'no-wiki-links': false });+ expect(OKF_FRONTMATTER_REGISTRY.map((e) => read(okfSchemaPathFor(e.id)))).toEqual(before);+ });+});++describe('the enablement gate', () => {+ test('nothing is written while the plugin is off', () => {+ ensureOkfSchemaFiles(root, { enabled: false });+ expect(existsSync(join(root, OKF_SCHEMA_DIR))).toBe(false);+ });++ test('turning it on writes, and repeat calls are a no-op', () => {+ ensureOkfSchemaFiles(root, { enabled: true });+ const path = okfSchemaPathFor('frontmatter-required');+ expect(existsSync(join(root, path))).toBe(true);++ // The guard means a hand-edit is NOT reverted until the state changes — the+ // cost of calling this on a hot config path. A restart or a toggle restores it.+ writeFileSync(join(root, path), 'edited\n', 'utf8');+ ensureOkfSchemaFiles(root, { enabled: true });+ expect(read(path)).toBe('edited\n');++ ensureOkfSchemaFiles(root, { enabled: false });+ ensureOkfSchemaFiles(root, { enabled: true });+ expect(JSON.parse(read(path)).title).toContain('OKF v0.2');+ });++ test('toggling a rule off deletes its file without a restart', () => {+ // A rule toggle is a state change the funnel must notice — the memo cannot+ // be a plain "already materialized" boolean.+ ensureOkfSchemaFiles(root, { enabled: true });+ ensureOkfSchemaFiles(root, { enabled: true, rules: { 'frontmatter-provenance': false } });+ expect(existsSync(join(root, okfSchemaPathFor('frontmatter-provenance')))).toBe(false);+ expect(existsSync(join(root, okfSchemaPathFor('frontmatter-required')))).toBe(true);+ });++ test('disabling the plugin removes the generated files and the directory', () => {+ ensureOkfSchemaFiles(root, { enabled: true });+ ensureOkfSchemaFiles(root, { enabled: false });+ expect(existsSync(join(root, OKF_SCHEMA_DIR))).toBe(false);+ });++ test('disabling the plugin leaves a file it did not write', () => {+ // Only rendered files are deleted; the non-recursive rmdir keeps that+ // guarantee structural rather than a matter of care.+ ensureOkfSchemaFiles(root, { enabled: true });+ const stray = join(root, OKF_SCHEMA_DIR, 'notes.txt');+ writeFileSync(stray, 'mine\n', 'utf8');+ ensureOkfSchemaFiles(root, { enabled: false });+ expect(readFileSync(stray, 'utf8')).toBe('mine\n');+ expect(existsSync(join(root, okfSchemaPathFor('frontmatter-required')))).toBe(false);+ });++ test('a second project is not skipped by the first', () => {+ // The gate keys "already materialized" by project dir, so enabling one+ // project must not mark a DIFFERENT one as done — a single boolean flag+ // would write the first and silently skip the second (a server can serve+ // more than one project in a process).+ const rootB = mkdtempSync(join(tmpdir(), 'ok-okf-schemas-b-'));+ mkdirSync(join(rootB, '.ok'), { recursive: true });+ try {+ ensureOkfSchemaFiles(root, { enabled: true });+ ensureOkfSchemaFiles(rootB, { enabled: true });+ expect(existsSync(join(rootB, okfSchemaPathFor('frontmatter-required')))).toBe(true);+ } finally {+ rmSync(rootB, { recursive: true, force: true });+ }+ });++ test('an unwritable project degrades quietly rather than throwing', () => {+ // The plugin validates from its compiled copy regardless, so a read-only+ // checkout must not stop a server from booting.+ expect(() => writeOkfSchemaFiles(join(root, 'nope', '\0bad'))).not.toThrow();+ });+});diff --git a/packages/server/src/lint/write-okf-schemas.ts b/packages/server/src/lint/write-okf-schemas.tsnew file mode 100644index 000000000..d7f7262c2--- /dev/null+++ b/packages/server/src/lint/write-okf-schemas.ts@@ -0,0 +1,204 @@+/**+ * Materialize the OKF schemas into `.ok/okf/` so an agent can read the contract it is+ * told governs a document.+ *+ * Runs from the config funnel whenever the `okf` plugin's schema-relevant state changes,+ * and rewrites unconditionally when it does. Rewriting is the point: it means a stray+ * edit is reverted on the next state change or restart, which — with the `$comment`+ * header each file carries — is the clearest available signal that these are generated+ * and that editing them accomplishes nothing.+ *+ * The directory mirrors the rule toggles: a schema file exists exactly while its rule is+ * enabled. Toggling a rule off deletes its file, and disabling the plugin removes them+ * all — advertisement stops naming a disabled rule's schema, so a lingering file would+ * describe a contract nothing points to.+ *+ * Bytes are compared before writing. A boot that changes nothing leaves the files' mtimes+ * alone, so a watcher or an editor holding one open is not disturbed every restart.+ *+ * Failure is never fatal. These files are a convenience for agents; the plugin validates+ * from its compiled copy regardless, so a read-only checkout or a permissions problem+ * degrades to "no schema files" rather than a server that will not boot.+ */++import { readFileSync } from 'node:fs';+import { dirname, join } from 'node:path';+import {+ isOkfRuleEnabled,+ OKF_FRONTMATTER_REGISTRY,+ OKF_SCHEMA_DIR,+ type OkfRuleToggles,+ renderOkfSchemaFiles,+} from '@inkeep/open-knowledge-core';+import {+ tracedMkdirSync,+ tracedRmdirSync,+ tracedRmSync,+ tracedWriteFileSync,+} from '../fs-traced.ts';+import { getLogger } from '../logger.ts';++/** Line added to `.ok/.gitignore` so generated schemas stay out of commits. */+const IGNORE_LINE = 'okf/';++const IGNORE_BLOCK = `+# .ok/okf/ holds the OKF lint plugin's schemas, rendered from the plugin on+# boot so agents can read the contract they are told governs a document. A+# generated artifact — regenerated whenever the plugin's copy changes, and+# never read back — so it is not committed.+${IGNORE_LINE}+`;++/**+ * Append the ignore rule when it is absent.+ *+ * Existing projects were scaffolded before this directory existed, so seeding the rule at+ * `ok init` would only ever cover new ones — and the first boot after an upgrade is+ * exactly when the untracked directory appears. Appending here covers both.+ *+ * The match is deliberately loose (any line equal to `okf/`, ignoring surrounding space)+ * so a user who wrote the rule themselves, or moved it, does not get a duplicate.+ */+function ensureGitignored(projectDir: string): void {+ const ignorePath = join(projectDir, '.ok', '.gitignore');+ let current: string;+ try {+ current = readFileSync(ignorePath, 'utf8');+ } catch (error) {+ // ENOENT is the expected case: this project has no seeded ignore file, so+ // there is nothing to extend and nothing to guess about its conventions.+ // Any OTHER read error (EACCES/EIO) means the file is there but unreadable+ // — surface it rather than silently leaving the generated schemas+ // untracked, which from here looks identical to "no ignore file".+ if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {+ getLogger('okf-schemas').warn(+ { err: error, projectDir },+ '[okf] could not read .ok/.gitignore; generated schemas may show as untracked',+ );+ }+ return;+ }+ const alreadyIgnored = current.split('\n').some((line) => line.trim() === IGNORE_LINE);+ if (alreadyIgnored) return;+ tracedWriteFileSync(ignorePath, `${current.replace(/\n*$/, '\n')}${IGNORE_BLOCK}`, 'utf8');+ // Appending to a git-tracked file on boot is deliberate but surprising; a+ // debug line explains an otherwise-unauthored working-tree change.+ getLogger('okf-schemas').debug(+ { projectDir },+ '[okf] added okf/ to .ok/.gitignore so generated schemas stay uncommitted',+ );+}++/** The schema-relevant slice of the persisted `okf` plugin config. */+export interface OkfSchemaState {+ readonly enabled?: boolean;+ readonly rules?: OkfRuleToggles;+}++/**+ * Last-applied state per project dir, encoded as a comparable string. Keyed so a server+ * serving more than one project does not skip the second, and stored as the signature —+ * not a boolean — so a per-rule toggle is a state change the funnel notices, not just+ * plugin on/off.+ */+const appliedSignatures = new Map<string, string>();++/** What of `okf` the directory contents depend on: plugin on/off + which rules are off. */+function schemaSignature(okf: OkfSchemaState | undefined): string {+ if (okf?.enabled !== true) return 'off';+ const disabled = OKF_FRONTMATTER_REGISTRY.filter(+ (entry) => !isOkfRuleEnabled(okf.rules, entry.id),+ ).map((entry) => entry.id);+ return `on:${disabled.sort().join(',')}`;+}++/**+ * Reconcile `.ok/okf/` with the plugin state, once per state change.+ *+ * Called from the config funnel rather than from boot alone. The plugin and its rules+ * can be switched at runtime — the config is read fresh per request — and advertisement+ * names these paths only while a rule is enabled, so the files must track the toggles:+ * appear when a rule turns on, disappear when it turns off. After the first call for a+ * given state this is a Map lookup.+ */+export function ensureOkfSchemaFiles(projectDir: string, okf: OkfSchemaState | undefined): void {+ const signature = schemaSignature(okf);+ if (appliedSignatures.get(projectDir) === signature) return;+ appliedSignatures.set(projectDir, signature);+ if (okf?.enabled === true) {+ writeOkfSchemaFiles(projectDir, okf.rules);+ } else {+ removeOkfSchemaFiles(projectDir);+ }+}++/** Test seam: forget what this process has written. */+export function resetOkfSchemaWriteState(): void {+ appliedSignatures.clear();+}++/**+ * Write the schemas for enabled rules under `projectDir` and delete the files of+ * disabled ones, so the directory always lists exactly the contracts in force. Returns+ * the project-relative paths written or already current, for logging; an empty array+ * means the write was skipped.+ */+export function writeOkfSchemaFiles(projectDir: string, rules?: OkfRuleToggles): string[] {+ const files = renderOkfSchemaFiles();+ const written: string[] = [];+ try {+ tracedMkdirSync(join(projectDir, OKF_SCHEMA_DIR), { recursive: true });+ for (const file of files) {+ const abs = join(projectDir, file.path);+ if (!isOkfRuleEnabled(rules, file.ruleId)) {+ tracedRmSync(abs, { force: true });+ continue;+ }+ let existing: string | null = null;+ try {+ existing = readFileSync(abs, 'utf8');+ } catch {+ existing = null;+ }+ if (existing !== file.contents) {+ tracedMkdirSync(dirname(abs), { recursive: true });+ tracedWriteFileSync(abs, file.contents, 'utf8');+ }+ written.push(file.path);+ }+ ensureGitignored(projectDir);+ } catch (error) {+ getLogger('okf-schemas').warn(+ { err: error, projectDir },+ '[okf] could not write schema files; the plugin still validates from its own copy',+ );+ return [];+ }+ return written;+}++/**+ * Delete every generated schema, and the directory when that leaves it empty.+ *+ * Removes only the files this module renders — a stray file someone parked in `.ok/okf/`+ * survives, and the non-empty directory with it. `rmdirSync` (not recursive `rm`) is what+ * makes that guarantee structural rather than a matter of care.+ */+function removeOkfSchemaFiles(projectDir: string): void {+ try {+ for (const file of renderOkfSchemaFiles()) {+ tracedRmSync(join(projectDir, file.path), { force: true });+ }+ tracedRmdirSync(join(projectDir, OKF_SCHEMA_DIR));+ } catch (error) {+ const code = (error as NodeJS.ErrnoException).code;+ // ENOENT: never materialized. ENOTEMPTY: a file we did not write is parked+ // there; leaving it is the point of the non-recursive rmdir.+ if (code !== 'ENOENT' && code !== 'ENOTEMPTY') {+ getLogger('okf-schemas').warn(+ { err: error, projectDir },+ '[okf] could not remove generated schema files',+ );+ }+ }+}diff --git a/packages/server/src/mcp/tools/exec.test.ts b/packages/server/src/mcp/tools/exec.test.tsindex 02ad81dea..1d730f95a 100644--- a/packages/server/src/mcp/tools/exec.test.ts+++ b/packages/server/src/mcp/tools/exec.test.ts@@ -1236,6 +1236,110 @@ describe('exec — frontmatter schemas_applicable read-time advertisement', () =});});+describe('exec — OKF schemas_applicable read-time advertisement', () => {+ // The same wiring root as the block above, for the OTHER source feeding it. The+ // OKF plugin contributes built-in schemas that no user authored, and its branch of+ // `enrichSchemaDeps` is a second `...spread` beside the frontmatter one — a place a+ // deletion is invisible, because every unit test below it calls the resolver+ // directly and stays green.+ //+ // What it advertises is a PATH, not an opaque name, so an agent that reads one of+ // these entries can open the file and learn the contract. That is the whole reason+ // the schemas are materialized, and this is where the two halves meet.+ const OKF_CONFIG: Config = ConfigSchema.parse({+ contentRules: { okf: { enabled: true } },+ });++ test('cat advertises the OKF schemas governing a concept document', async () => {+ const project = await bootstrap();+ const contentDir = resolve(project, 'content');+ mkdirSync(contentDir, { recursive: true });+ writeFileSync(resolve(contentDir, 'guide.md'), '---\ntype: Reference\n---\nBody\n');++ const result = (await buildExecResult(+ { command: 'cat content/guide.md' },+ { resolveCwd: async () => project, serverUrl: undefined, config: OKF_CONFIG },+ )) as ExecResult;++ const files = fileEntries(structured(result));+ expect(files[0]?.schemas_applicable).toEqual([+ '.ok/okf/required.schema.json',+ '.ok/okf/recommended.schema.json',+ '.ok/okf/provenance.schema.json',+ '.ok/okf/computation.schema.json',+ ]);+ });++ test('a reserved index advertises only its own schema, not the concept families', async () => {+ // Proves the scoping survives the wiring rather than only the resolver: the two+ // index scopes are disjoint, and a root index must not be asked for a `type`.+ const project = await bootstrap();+ writeFileSync(resolve(project, 'index.md'), '# Index\n\n* [a](a.md) - a\n');++ const result = (await buildExecResult(+ { command: 'cat index.md' },+ { resolveCwd: async () => project, serverUrl: undefined, config: OKF_CONFIG },+ )) as ExecResult;++ const files = fileEntries(structured(result));+ expect(files[0]?.schemas_applicable).toEqual(['.ok/okf/root-index.schema.json']);+ });++ test('a log advertises nothing — OKF does not constrain its frontmatter', async () => {+ const project = await bootstrap();+ writeFileSync(resolve(project, 'log.md'), '---\ntype: Log\n---\n\n# L\n');++ const result = (await buildExecResult(+ { command: 'cat log.md' },+ { resolveCwd: async () => project, serverUrl: undefined, config: OKF_CONFIG },+ )) as ExecResult;++ const files = fileEntries(structured(result));+ expect(files[0]?.schemas_applicable).toBeUndefined();+ });++ test('a rule switched off stops being advertised as governing', async () => {+ const project = await bootstrap();+ const contentDir = resolve(project, 'content');+ mkdirSync(contentDir, { recursive: true });+ writeFileSync(resolve(contentDir, 'guide.md'), '---\ntype: Reference\n---\nBody\n');+ const partial: Config = ConfigSchema.parse({+ contentRules: {+ okf: {+ enabled: true,+ rules: { 'frontmatter-provenance': false, 'frontmatter-computation': false },+ },+ },+ });++ const result = (await buildExecResult(+ { command: 'cat content/guide.md' },+ { resolveCwd: async () => project, serverUrl: undefined, config: partial },+ )) as ExecResult;++ const files = fileEntries(structured(result));+ expect(files[0]?.schemas_applicable).toEqual([+ '.ok/okf/required.schema.json',+ '.ok/okf/recommended.schema.json',+ ]);+ });++ test('plugin disabled → no OKF advertisement at all', async () => {+ const project = await bootstrap();+ const contentDir = resolve(project, 'content');+ mkdirSync(contentDir, { recursive: true });+ writeFileSync(resolve(contentDir, 'guide.md'), '---\ntype: Reference\n---\nBody\n');++ const result = (await buildExecResult(+ { command: 'cat content/guide.md' },+ { resolveCwd: async () => project, serverUrl: undefined, config: DEFAULT_CONFIG },+ )) as ExecResult;++ const files = fileEntries(structured(result));+ expect(files[0]?.schemas_applicable).toBeUndefined();+ });+});+describe('exec — mutation-sweep scoping and honesty', () => {const OVER_CAP = 1005;diff --git a/packages/server/src/mcp/tools/exec.ts b/packages/server/src/mcp/tools/exec.tsindex d55d7f075..102254abc 100644--- a/packages/server/src/mcp/tools/exec.ts+++ b/packages/server/src/mcp/tools/exec.ts@@ -21,6 +21,7 @@*/import { stat } from 'node:fs/promises';import { relative, resolve } from 'node:path';+import { okfAdvertisedSchemaMappings } from '@inkeep/open-knowledge-core';import { z } from 'zod';import { argsOf, extractReferencedPaths, nonFlagArgs } from '../../bash/extract-paths.ts';import { createBashInstance, execBash, StdoutOverflowError } from '../../bash/index.ts';@@ -574,15 +575,25 @@ export async function buildExecResult(// differ only when the caller targets a subdirectory of the project.const { cwd, executionCwd, config, url: resolvedServerUrl } = context;- // Read-time schema advertisement: when the frontmatter plugin is enabled,- // enrichment resolves which schema files govern each listed doc/folder- // server-side (the agent never evaluates an appliesTo glob).+ // Read-time schema advertisement: enrichment resolves which schemas govern each+ // listed doc/folder server-side (the agent never evaluates an appliesTo glob).+ //+ // Two sources, one list. The frontmatter plugin contributes the project's authored+ // mappings; the OKF plugin contributes its built-in profile, advertised by the+ // `.ok/okf/` path each schema is materialized to so an agent can open the contract.+ // They are concatenated rather than resolved separately so there is a single+ // selection path — a doc governed by both sees both, in plugin-registry order.const frontmatterSlice = config.contentRules.frontmatter;+ const okfSlice = config.contentRules.okf;+ const advertisedSchemas = [+ ...(frontmatterSlice.enabled ? frontmatterSlice.schemas : []),+ ...(okfSlice.enabled ? okfAdvertisedSchemaMappings(okfSlice.rules) : []),+ ];const enrichSchemaDeps =- frontmatterSlice.enabled && frontmatterSlice.schemas.length > 0+ advertisedSchemas.length > 0? {contentDir: resolve(cwd, config.content.dir),- frontmatterSchemas: frontmatterSlice.schemas,+ frontmatterSchemas: advertisedSchemas,}: {};diff --git a/packages/server/src/page-identity.ts b/packages/server/src/page-identity.tsindex 7c9147c49..4634f75b1 100644--- a/packages/server/src/page-identity.ts+++ b/packages/server/src/page-identity.ts@@ -172,6 +172,42 @@ export function extractPageIcon(content: string): string | undefined {return icon;}+/**+ * A block-scalar indicator (`>` / `|`, with optional chomping and indentation+ * digits) is what remains on the key's own line when the value spans following+ * lines. `extractFrontmatterScalar` reads a single line, so it returns the+ * indicator rather than the text. Treat that as absent: the indicator is a YAML+ * artifact, and emitting it verbatim would put a literal `>` where a document's+ * description belongs.+ */+const BLOCK_SCALAR_INDICATOR = /^[>|][+-]?\d*$/;++function extractSingleLineScalar(content: string, key: string): string | undefined {+ const { frontmatter } = stripFrontmatter(content);+ const value = extractFrontmatterScalar(frontmatter, key);+ if (!value || BLOCK_SCALAR_INDICATOR.test(value)) return undefined;+ return value;+}++/**+ * The `description:` scalar, or `undefined` when absent / blank. Kept on the+ * same zero-dependency walk as `extractPageTitle` and `extractPageIcon` so the+ * seed walk and every live disk event can enrich a file-index entry from the+ * content they already hold, without a YAML parse per document.+ */+export function extractPageDescription(content: string): string | undefined {+ return extractSingleLineScalar(content, 'description');+}++/**+ * The `type:` scalar, or `undefined` when absent / blank. OKF's conformance+ * floor is a non-empty `type` on every non-reserved document, which is what+ * makes it the one field dependable enough to group a generated index by.+ */+export function extractPageType(content: string): string | undefined {+ return extractSingleLineScalar(content, 'type');+}+export interface FrontmatterMetadata {cluster: string | undefined;category: string | undefined;diff --git a/packages/server/src/paired-write-enforcement.test.ts b/packages/server/src/paired-write-enforcement.test.tsindex 9d4d222ae..2d8ec3810 100644--- a/packages/server/src/paired-write-enforcement.test.ts+++ b/packages/server/src/paired-write-enforcement.test.ts@@ -110,6 +110,11 @@ const KNOWN_PAIRED_WRITE_ORIGINS = new Set<string>(['FILE_WATCHER_ORIGIN','AGENT_WRITE_ORIGIN','undoOrigin',+ // A generated artifact (today the root index) landing in a loaded document.+ // Routes through `replaceRawBody`, a sanctioned primitive, and declares+ // `paired`. Declared in `server-factory.ts`; the transact that USES it is in+ // `content/generated-artifact.ts` via `env.origin` — see the props set below.+ 'GENERATED_ARTIFACT_ORIGIN',]);/**@@ -125,6 +130,12 @@ const KNOWN_PAIRED_WRITE_ORIGIN_PROPS = new Set<string>(['session.origin','session.undoOrigin','templateSession.origin',+ // The generated-artifact dispatch takes its origin as an injected+ // collaborator so the write path is exercisable without a booted server. The+ // ORIGIN itself is still statically auditable — `GENERATED_ARTIFACT_ORIGIN`+ // above, declared with `paired: true` — but the call site names a parameter,+ // so this scan cannot resolve it. The env's type pins the contract.+ 'env.origin',]);// ─── AST helpers ─────────────────────────────────────────────diff --git a/packages/server/src/seed/apply.test.ts b/packages/server/src/seed/apply.test.tsindex 522846ed8..3a5905be5 100644--- a/packages/server/src/seed/apply.test.ts+++ b/packages/server/src/seed/apply.test.ts@@ -266,3 +266,68 @@ describe('applySeed — codebase-wiki nested folder paths + wiki/-prefixed rootF);});});++describe('applySeed — required plugins', () => {+ let projectDir: string;++ beforeEach(async () => {+ projectDir = await mkdtemp(join(tmpdir(), 'seed-apply-plugins-'));+ mkdirSync(join(projectDir, '.ok'), { recursive: true });+ });++ afterEach(async () => {+ await rm(projectDir, { recursive: true, force: true });+ });++ /** Seed `.ok/config.yml` with `body`, run the okf pack, return the config after. */+ async function seedOkfWith(body: string): Promise<{ after: string; enabled: string[] }> {+ writeFileSync(join(projectDir, '.ok', 'config.yml'), body, 'utf-8');+ const plan = await planSeed({ projectDir, packId: 'okf' });+ const result = await applySeed(plan, { projectDir, packId: 'okf' });+ expect(result.errors).toEqual([]);+ return {+ after: readFileSync(join(projectDir, '.ok', 'config.yml'), 'utf-8'),+ enabled: result.pluginsEnabled,+ };+ }++ test('turns the plugin back on even when the user had switched it off', async () => {+ // The decided behaviour, and the one worth pinning: a pack that cannot keep+ // its own scaffold conformant is not delivering what it promised, so the+ // seed asserts rather than defers. What makes it acceptable is that the plan+ // disclosed it and Settings can undo it — neither of which this test covers.+ const { after, enabled } = await seedOkfWith('contentRules:\n okf:\n enabled: false\n');++ expect(enabled).toEqual(['okf']);+ expect(after).toMatch(/okf:\s*\n\s*enabled: true/);+ });++ test('leaves the rest of the user config standing', async () => {+ // Patched, not rewritten. A seed that silently dropped an unrelated setting+ // or a hand-written comment would be a far worse trade than the enablement.+ const { after } = await seedOkfWith(+ '# my notes\ncontentRules:\n okf:\n enabled: false\n markdownlint:\n enabled: true\n',+ );++ expect(after).toContain('# my notes');+ expect(after).toMatch(/markdownlint:\s*\n\s*enabled: true/);+ });++ test('re-seeding an already-enabled project writes nothing', async () => {+ const { after, enabled } = await seedOkfWith('contentRules:\n okf:\n enabled: true\n');++ // Empty means the config was not touched at all — the picker is re-runnable+ // by contract, so a repeat run must not churn the file.+ expect(enabled).toEqual([]);+ expect(after).toBe('contentRules:\n okf:\n enabled: true\n');+ });++ test('a pack with no requirement reports none', async () => {+ writeFileSync(join(projectDir, '.ok', 'config.yml'), '', 'utf-8');+ const plan = await planSeed({ projectDir, packId: 'knowledge-base' });+ const result = await applySeed(plan, { projectDir, packId: 'knowledge-base' });++ expect(result.pluginsEnabled).toEqual([]);+ expect(plan.requiredPlugins).toBeUndefined();+ });+});diff --git a/packages/server/src/seed/apply.ts b/packages/server/src/seed/apply.tsindex 416a26530..b736c97e7 100644--- a/packages/server/src/seed/apply.ts+++ b/packages/server/src/seed/apply.ts@@ -1,12 +1,15 @@import { existsSync, mkdirSync, writeFileSync } from 'node:fs';import { join, resolve } from 'node:path';+import type { LintPluginId } from '@inkeep/open-knowledge-core';import { scanInPlaceSkills } from '../in-place-skills.ts';+import { CONFIG_FILENAME } from '../init-project.ts';import {installPackSkill,resolvePackSkillHome,resolvePackSkillSources,} from './install-pack-skill.ts';import { assertEntryPathInProject } from './path-safety.ts';+import { enableRequiredPlugins } from './required-plugins.ts';import { buildStarterFolderFrontmatterYaml, DEFAULT_PACK_ID, resolvePack } from './starter.ts';import type { ApplyError, ApplyResult, FileEntry, ScaffoldPlan, SeedOptions } from './types.ts';import { SeedRootDirError } from './types.ts';@@ -84,7 +87,6 @@ export async function applySeed(plan: ScaffoldPlan, opts: SeedOptions = {}): Prolet applied = 0;const errors: ApplyError[] = [];-// Containment guard for every plan entry (lexical + realpath). Plan paths// come across a trust boundary (HTTP /api/seed/apply, IPC payload); a// malicious `..` segment or a symlinked ancestor would otherwise escape@@ -178,11 +180,30 @@ export async function applySeed(plan: ScaffoldPlan, opts: SeedOptions = {}): Pro}}+ // Turn on the plugins the pack requires. Unconditional by design: a user who+ // had one off gets it back on, because a pack that cannot keep its own+ // scaffold conformant is not delivering what it promised. What makes that+ // acceptable is disclosure — the plan named the plugin before this ran — and+ // reversibility: Settings can turn it straight back off, and nothing here+ // re-asserts it later.+ let pluginsEnabled: LintPluginId[] = [];+ try {+ pluginsEnabled = enableRequiredPlugins(projectDir, pack.requiredPlugins ?? []);+ } catch (err) {+ // Same channel as a failed file write: a seed that scaffolded the content+ // but could not enable the plugin is partial, not clean.+ errors.push({+ path: `.ok/${CONFIG_FILENAME}`,+ error: `could not enable required plugin(s): ${err instanceof Error ? err.message : String(err)}`,+ });+ }+return {applied,errors,durationMs: Date.now() - started,packSkillsInstalled: packSkillInstall.editors,packSkillConflicts: packSkillInstall.conflicts,+ pluginsEnabled,};}diff --git a/packages/server/src/seed/index.ts b/packages/server/src/seed/index.tsindex b4f068c87..8d052754b 100644--- a/packages/server/src/seed/index.ts+++ b/packages/server/src/seed/index.ts@@ -9,6 +9,7 @@*/export { applySeed } from './apply.ts';+export { installPackSkillOnDemand } from './install-pack-skill.ts';export { planSeed } from './plan.ts';export { formatPackRationale } from './rationale.ts';export {diff --git a/packages/server/src/seed/install-pack-skill-source-resolution.test.ts b/packages/server/src/seed/install-pack-skill-source-resolution.test.tsnew file mode 100644index 000000000..102dea5bd--- /dev/null+++ b/packages/server/src/seed/install-pack-skill-source-resolution.test.ts@@ -0,0 +1,19 @@+import { beforeEach, describe, expect, test, vi } from 'vitest';++const listPackSkillSources = vi.hoisted(() => vi.fn(() => []));++vi.mock('../skill-pack-sources.ts', () => ({ listPackSkillSources }));++import { resolvePackSkillSources } from './install-pack-skill.ts';++describe('resolvePackSkillSources', () => {+ beforeEach(() => {+ listPackSkillSources.mockClear();+ });++ test('resolves against the running server bundle, not a co-installed desktop', () => {+ resolvePackSkillSources('okf');++ expect(listPackSkillSources).toHaveBeenCalledWith('okf', { checkDesktop: false });+ });+});diff --git a/packages/server/src/seed/install-pack-skill.test.ts b/packages/server/src/seed/install-pack-skill.test.tsindex 6b81889bd..9cdd35c2c 100644--- a/packages/server/src/seed/install-pack-skill.test.ts+++ b/packages/server/src/seed/install-pack-skill.test.ts@@ -9,12 +9,13 @@ import {} from 'node:fs';import { tmpdir } from 'node:os';import { join } from 'node:path';-import { OPENKNOWLEDGE_SKILLS_REPO } from '@inkeep/open-knowledge-core';+import { OPENKNOWLEDGE_SKILLS_REPO, RENAMED_PACK_SKILLS } from '@inkeep/open-knowledge-core';import { describe, expect, test } from 'vitest';import { readInstalledSkills } from '../installed-skills-marker.ts';import {classifyPresentPackSkill,installPackSkill,+ installPackSkillOnDemand,resolvePackSkillSources,} from './install-pack-skill.ts';@@ -31,9 +32,8 @@ function tmpProject(): string {/*** The pack's orientation-skill name AS RESOLVED ON THIS MACHINE. Names are- * frontmatter-driven and `resolvePackSkillSources` probes a co-installed OK- * Desktop bundle before the repo assets, so a hardcoded name would pin the test- * to whichever bundle this machine happens to carry.+ * frontmatter-driven, so the shared resolver remains the name authority when a+ * pack is decomposed or renamed.*/function orientationName(packId: string): string {const [first] = resolvePackSkillSources(packId);@@ -42,6 +42,49 @@ function orientationName(packId: string): string {}describe('installPackSkill', () => {+ test('published Knowledge Base and OKF skill IDs stay stable for skills.sh updates', () => {+ expect(resolvePackSkillSources('knowledge-base').map(({ name }) => name)).toEqual([+ 'knowledge-base',+ 'consolidate-notes',+ 'research-with-sources',+ ]);+ expect(resolvePackSkillSources('okf').map(({ name }) => name)).toEqual(['okf-knowledge-base']);+ expect(RENAMED_PACK_SKILLS['open-knowledge-pack-okf']).toBe('okf-knowledge-base');+ });++ test('on-demand install reports a newly-authored OKF skill', async () => {+ const proj = tmpProject();+ setUpEditor(proj, '.claude');++ const result = await installPackSkillOnDemand(proj, 'okf');++ expect(result).toEqual({+ installedHosts: ['Claude Code'],+ skills: [{ name: 'okf-knowledge-base', created: true }],+ });+ expect(existsSync(join(proj, '.claude', 'skills', 'okf-knowledge-base', 'SKILL.md'))).toBe(+ true,+ );+ });++ test('on-demand install recognizes and preserves an existing same-name skill', async () => {+ const proj = tmpProject();+ setUpEditor(proj, '.claude');+ const skillDir = join(proj, '.claude', 'skills', 'okf-knowledge-base');+ mkdirSync(skillDir, { recursive: true });+ const authored =+ '---\nname: okf-knowledge-base\ndescription: team guidance\n---\nDo not replace me.\n';+ writeFileSync(join(skillDir, 'SKILL.md'), authored, 'utf-8');++ const result = await installPackSkillOnDemand(proj, 'okf');++ expect(result).toEqual({+ installedHosts: [],+ skills: [{ name: 'okf-knowledge-base', created: false }],+ });+ expect(readFileSync(join(skillDir, 'SKILL.md'), 'utf-8')).toBe(authored);+ });+test('authors the pack skill IN PLACE at the default home (store retirement)', async () => {const proj = tmpProject();setUpEditor(proj, '.claude');@@ -108,10 +151,8 @@ describe('installPackSkill', () => {// (name == SKILL.md frontmatter, per the Agent Skills standard).//// Assert against `resolvePackSkillSources` rather than a hardcoded name list:- // it probes a co-installed OK Desktop bundle first, so a machine with an older- // desktop build resolves a different (possibly not-yet-decomposed) pack. The- // invariant under test is "every resolved source installs, and members are not- // nested inside the root skill" — not which sources this machine resolves.+ // the invariant under test is "every resolved source installs, and members are+ // not nested inside the root skill" — not the pack's current member count.const proj = tmpProject();setUpEditor(proj, '.claude');const sources = resolvePackSkillSources('software-lifecycle');diff --git a/packages/server/src/seed/install-pack-skill.ts b/packages/server/src/seed/install-pack-skill.tsindex c2ae6aa5f..aadd620e6 100644--- a/packages/server/src/seed/install-pack-skill.ts+++ b/packages/server/src/seed/install-pack-skill.ts@@ -63,12 +63,13 @@ const PROJECT_SKILL_EDITOR_LABELS: Partial<Record<EditorId, string>> = {const PLATFORM_SKILL_NAME = BUNDLE_SKILL_NAME.project;/**- * Every project-local skill a pack ships; empty when it ships none. Binds the- * seed domain's `checkDesktop:true`, so a co-installed OK Desktop's (possibly- * newer) bundle wins. Shared by the installer below and `planSeed`.+ * Every project-local skill a pack ships; empty when it ships none. Pack seed+ * and on-demand install run inside this server, so their assets must come from+ * this server's bundle rather than a potentially different co-installed app.+ * Shared by the installer below and `planSeed`.*/export function resolvePackSkillSources(packId: string): PackSkillSource[] {- return listPackSkillSources(packId, { checkDesktop: true });+ return listPackSkillSources(packId, { checkDesktop: false });}/**@@ -388,3 +389,35 @@ export async function installPackSkill(return { editors: [...installed], conflicts };}++interface PackSkillOnDemandResult {+ installedHosts: string[];+ skills: Array<{ name: string; created: boolean }>;+}++/**+ * Install only a pack's companion skills, without applying its scaffold or+ * changing the plugins it enables. The before/after scan turns the seed-era+ * primitive into a truthful user-action result: an existing same-name skill is+ * preserved and reported as existing, while a newly-authored source is+ * reported as created.+ */+export async function installPackSkillOnDemand(+ projectDir: string,+ packId: string,+): Promise<PackSkillOnDemandResult> {+ const sources = resolvePackSkillSources(packId);+ const before = new Set(scanInPlaceSkills(projectDir).map((skill) => skill.name));+ const installResult = await installPackSkill(projectDir, packId);+ const after = new Set(scanInPlaceSkills(projectDir).map((skill) => skill.name));++ const missing = sources.find(({ name }) => !after.has(name));+ if (missing) {+ throw new Error(`Pack skill "${missing.name}" could not be authored.`);+ }++ return {+ installedHosts: installResult.editors,+ skills: sources.map(({ name }) => ({ name, created: !before.has(name) })),+ };+}diff --git a/packages/server/src/seed/okf-conformance.test.ts b/packages/server/src/seed/okf-conformance.test.tsindex 250062900..0463c83b2 100644--- a/packages/server/src/seed/okf-conformance.test.ts+++ b/packages/server/src/seed/okf-conformance.test.ts@@ -2,21 +2,20 @@* OKF starter pack — conformance test.** The `okf` pack's whole value is that its scaffolded content is conformant- * with Google's Open Knowledge Format (OKF) v0.1 BY CONSTRUCTION — there is no- * shipped validator, so this test IS the verification surface. It runs the real+ * with Google's Open Knowledge Format (OKF) v0.2 BY CONSTRUCTION. It runs the real* pack-agnostic seed pipeline (`planSeed` → `applySeed`) into a temp project and- * asserts the three OKF §9 conformance rules over the bytes actually written:+ * asserts the three OKF §11 conformance rules over the bytes actually written:** rule 1: every non-reserved doc has a parseable YAML frontmatter block.* rule 2: every such block carries a non-empty string `type`.- * rule 3: the reserved files (`index.md` §6, `log.md` §7) are lowercase,- * carry ZERO frontmatter, and match the §6/§7 body structure.+ * rule 3: the seeded reserved `index.md` is lowercase and matches the §8+ * navigation shape. Optional `log.md` is deliberately not seeded.** Two non-reserved doc shapes are seeded and both are checked at the form an* OKF consumer sees:- * - `welcome.md` is a real content doc with a single frontmatter block —- * parsed directly.- * - the folder starter templates (`<folder>/.ok/templates/<name>.md`) are a+ * - `concepts/getting-started.md` is a real content doc with a single+ * frontmatter block — parsed directly.+ * - the concept starter template (`concepts/.ok/templates/concept.md`) is a* single frontmatter block: the `template:` identity plus the doc-frontmatter* top-level keys. `instantiateDoc` strips the identity and reconstructs the* frontmatter the created doc receives (see api-extension create-page). So@@ -28,23 +27,27 @@ import { mkdtemp, rm } from 'node:fs/promises';import { tmpdir } from 'node:os';import { join, relative } from 'node:path';import {+ DEFAULT_LINTER_CONFIG,instantiateDoc,+ type LinterConfig,+ lintDocument,parseFrontmatterYaml,stripFrontmatter,unwrapFrontmatterFences,} from '@inkeep/open-knowledge-core';import { describe, expect, test } from 'vitest';import { parse as parseYaml } from 'yaml';+import { computeBrokenOutboundLinks } from '../backlink-index.ts';import { applySubstitution } from '../content/substitution.ts';import { applySeed } from './apply.ts';import { planSeed } from './plan.ts';-import { OKF_RESERVED_FILENAMES, STARTER_PACKS } from './starter.ts';+import { OKF_RESERVED_FILENAMES, type PackId, STARTER_PACKS } from './starter.ts';const OKF_PACK = STARTER_PACKS.okf;const OKF_INDEX_BODY = OKF_PACK.rootFiles?.['index.md'];-const OKF_LOG_BODY = OKF_PACK.rootFiles?.['log.md'];-if (!OKF_INDEX_BODY || !OKF_LOG_BODY) {- throw new Error('okf pack is missing its reserved index.md / log.md root files');+const OKF_GETTING_STARTED_BODY = OKF_PACK.rootFiles?.['concepts/getting-started.md'];+if (!OKF_INDEX_BODY || !OKF_GETTING_STARTED_BODY) {+ throw new Error('okf pack is missing its minimal portable bundle');}/** Reserved OKF files, relative to the bundle (pack) root — shared with the pack. */@@ -87,12 +90,18 @@ function consumerFrontmatterYaml(relPath: string, raw: string): string | null {return unwrapFrontmatterFences(frontmatter);}-async function seedOkf(): Promise<{ projectDir: string; cleanup: () => Promise<void> }> {+async function seedOkf(+ rootDir?: string,+): Promise<{ projectDir: string; cleanup: () => Promise<void> }> {const projectDir = await mkdtemp(join(tmpdir(), 'seed-okf-'));// planSeed's gate requires `.ok/config.yml`.mkdirSync(join(projectDir, '.ok'), { recursive: true });writeFileSync(join(projectDir, '.ok', 'config.yml'), '', 'utf-8');- const plan = await planSeed({ projectDir, packId: 'okf' });+ // These assertions include the installed pack skill, so the fixture must+ // explicitly adopt an agent host. Production never creates one on behalf of+ // a project that has not chosen an agent.+ mkdirSync(join(projectDir, '.agents', 'skills'), { recursive: true });+ const plan = await planSeed({ projectDir, packId: 'okf', rootDir });const result = await applySeed(plan, { projectDir, packId: 'okf' });expect(result.errors).toEqual([]);return {@@ -101,17 +110,61 @@ async function seedOkf(): Promise<{ projectDir: string; cleanup: () => Promise<v};}-describe('okf pack — OKF §9 conformance by construction', () => {+async function seedPackSequence(+ order: readonly PackId[],+): Promise<{ projectDir: string; cleanup: () => Promise<void> }> {+ const projectDir = await mkdtemp(join(tmpdir(), 'seed-okf-compatible-packs-'));+ mkdirSync(join(projectDir, '.ok'), { recursive: true });+ writeFileSync(join(projectDir, '.ok', 'config.yml'), '', 'utf-8');+ // Pack compatibility includes the combined installed skill set, which+ // requires an agent host the project has already adopted.+ mkdirSync(join(projectDir, '.agents', 'skills'), { recursive: true });+ for (const packId of order) {+ const plan = await planSeed({ projectDir, packId });+ const result = await applySeed(plan, { projectDir, packId });+ expect(result.errors, `${packId} seed errors`).toEqual([]);+ }+ return {+ projectDir,+ cleanup: () => rm(projectDir, { recursive: true, force: true }),+ };+}++describe('okf pack — minimal starter contract', () => {+ test('ships one populated domain folder, one template, and two portable documents', () => {+ expect(OKF_PACK.folders.map((folder) => folder.path)).toEqual(['concepts']);+ expect(Object.keys(OKF_PACK.templates)).toEqual(['concept']);+ expect(Object.keys(OKF_PACK.rootFiles ?? {})).toEqual([+ 'index.md',+ 'concepts/getting-started.md',+ ]);+ });++ test('the companion skill targets v0.2 and explains the plugin rather than the scaffold', () => {+ const skillSource = readFileSync(+ join(import.meta.dirname, '..', '..', 'assets', 'skills', 'packs', 'okf', 'SKILL.md'),+ 'utf-8',+ );+ const { frontmatter, body } = stripFrontmatter(skillSource);+ const parsed = parseFrontmatterYaml(unwrapFrontmatterFences(frontmatter));++ expect(parsed.map?.description).toContain('v0.2 guidance');+ expect(body).toContain("## OpenKnowledge's `okf` plugin");+ expect(body).toContain('continuous portability feedback');+ expect(body).not.toMatch(/starter pack/i);+ });+});++describe('okf pack — OKF §11 conformance by construction', () => {test('rule 1+2: every non-reserved seed .md parses to frontmatter with a non-empty type', async () => {const { projectDir, cleanup } = await seedOkf();try {const docs = collectMarkdown(projectDir).filter((p) => !RESERVED_FILES.has(p));- // Guard against a vacuous pass: the single-block content doc (`welcome.md`)- // and the folder templates must all be present + checked. Without the- // explicit welcome.md guard the three templates alone satisfy the count,- // so dropping the only non-template doc would pass silently.- expect(docs).toContain('welcome.md');- expect(docs.length).toBeGreaterThanOrEqual(4);+ // Guard against a vacuous pass: the real typed document, its template,+ // and the pack skill must all be present + checked.+ expect(docs).toContain('concepts/getting-started.md');+ expect(docs).toContain('concepts/.ok/templates/concept.md');+ expect(docs.some((path) => path.endsWith('/SKILL.md'))).toBe(true);for (const relPath of docs) {const raw = readFileSync(join(projectDir, relPath), 'utf-8');@@ -135,76 +188,92 @@ describe('okf pack — OKF §9 conformance by construction', () => {}});- test('rule 3: reserved index.md/log.md are lowercase, present at root, and carry ZERO frontmatter', async () => {+ test('rule 3: the root index declares v0.2 and the optional log is omitted', async () => {const { projectDir, cleanup } = await seedOkf();try {- for (const reserved of RESERVED_FILES) {- const abs = join(projectDir, reserved);- expect(existsSync(abs), `${reserved} must be seeded at the bundle root`).toBe(true);- const raw = readFileSync(abs, 'utf-8');- // The load-bearing rule-3 assertion: a reserved file with any- // frontmatter is an OKF violation. A frontmatter block can only appear- // at byte 0, so checking the leading fence is sufficient + precise.- expect(raw.startsWith('---'), `${reserved} must NOT carry frontmatter`).toBe(false);- expect(stripFrontmatter(raw).frontmatter, `${reserved} has a frontmatter block`).toBe('');- }+ const index = readFileSync(join(projectDir, 'index.md'), 'utf-8');+ expect(index.startsWith('---\nokf_version: "0.2"\n---\n')).toBe(true);+ expect(existsSync(join(projectDir, 'log.md'))).toBe(false);} finally {await cleanup();}});- test('rule 3: index.md matches OKF §6 navigation structure (H1 + standard-markdown link list)', async () => {+ test('rule 3: index.md matches OKF §8 navigation structure (H1 + standard-markdown link list)', async () => {const { projectDir, cleanup } = await seedOkf();try {const index = readFileSync(join(projectDir, 'index.md'), 'utf-8');- expect(index.startsWith('# '), 'index.md should open with an H1 navigation heading').toBe(++ // The root index is the one index §8 permits frontmatter on, and the only+ // key it may carry is a quoted `okf_version`.+ expect(index.startsWith('---\nokf_version: "0.2"\n---\n'), 'root index frontmatter').toBe(true,);- // §6 navigation is a link-list in STANDARD markdown — a conformant OKF- // bundle's links are plain markdown, not OK's `[[…]]` superset. Pin every- // seeded nav link's format so the graph stays portable to a strict- // consumer.- for (const link of [- '[welcome](./welcome.md)',- '[concepts/](./concepts/)',- '[references/](./references/)',- '[notes/](./notes/)',- ]) {- expect(index, `index.md should link ${link} in standard markdown`).toContain(link);- }+ expect(index, 'index.md should have one navigation heading').toContain('# Knowledge base');+ expect(index, 'index.md should link the seeded guide').toContain(+ '[Getting started](./concepts/getting-started.md)',+ );++ // §8 navigation is a link-list in STANDARD markdown — a conformant OKF+ // bundle's links are plain markdown, not OK's `[[…]]` superset.expect(index, 'seeded nav must not use [[wiki-link]] shorthand').not.toMatch(/\[\[[^\]]+\]\]/,);+ // No bare-folder hrefs. There is no folder variant in the link classifier,+ // so `./concepts/` resolves to a document of that name and reads as broken.+ expect(index, 'index.md must not link a bare folder').not.toMatch(/]\(\.\/[^)]*\/\)/);+ // Every link resolves against what the seed actually wrote.+ const seeded = collectMarkdown(projectDir).map((relPath) => relPath.replace(/\.mdx?$/, ''));+ expect(computeBrokenOutboundLinks(index, 'index', seeded)).toEqual([]);} finally {await cleanup();}});- test('rule 3: log.md matches OKF §7 change-history structure (H1 + documents the dated-entry format)', async () => {- const { projectDir, cleanup } = await seedOkf();+ test('seeding into a subdirectory keeps the portable bundle under that root', async () => {+ const { projectDir, cleanup } = await seedOkf('bundle');try {- const log = readFileSync(join(projectDir, 'log.md'), 'utf-8');- expect(log.startsWith('# '), 'log.md should open with an H1 heading').toBe(true);- // §7 entries are second-level headings shaped `## <date>: <summary>`. The- // seed ships a prose instruction documenting that format (not a placeholder- // entry — mirroring peer packs; root files get no `{{date}}` substitution- // so a seeded date would be stale). Assert the format is documented.- expect(log).toMatch(/## YYYY-MM-DD: <summary>/);- expect(log.toLowerCase()).toContain('change history');+ const bundleIndex = readFileSync(join(projectDir, 'bundle', 'index.md'), 'utf-8');++ expect(existsSync(join(projectDir, 'index.md'))).toBe(false);+ expect(bundleIndex).toContain('[Getting started](./concepts/getting-started.md)');+ expect(bundleIndex.startsWith('---\nokf_version: "0.2"\n---\n')).toBe(true);+ expect(existsSync(join(projectDir, 'bundle', 'concepts', 'index.md'))).toBe(false);++ const seeded = collectMarkdown(projectDir).map((relPath) => relPath.replace(/\.mdx?$/, ''));+ expect(computeBrokenOutboundLinks(bundleIndex, 'bundle/index', seeded)).toEqual([]);} finally {await cleanup();}});- test('apply writes the reserved-file bodies to disk verbatim (no {{date}} substitution on root files)', async () => {- // Root files — unlike templates — are written byte-for-byte with NO- // substitution. This pins that property (a regression that wired- // substitution into rootFiles would corrupt the frontmatter-free reserved- // files); the §6/§7 tests pin the body content/format itself.+ test('a pre-existing bundle index is preserved while the typed document is added', async () => {+ const projectDir = await mkdtemp(join(tmpdir(), 'seed-okf-existing-root-index-'));+ const existingIndex = '# User-authored bundle index\n';+ try {+ mkdirSync(join(projectDir, '.ok'), { recursive: true });+ writeFileSync(join(projectDir, '.ok', 'config.yml'), '', 'utf-8');+ mkdirSync(join(projectDir, 'bundle'), { recursive: true });+ writeFileSync(join(projectDir, 'bundle', 'index.md'), existingIndex, 'utf-8');++ const plan = await planSeed({ projectDir, packId: 'okf', rootDir: 'bundle' });+ const result = await applySeed(plan, { projectDir, packId: 'okf' });++ expect(result.errors).toEqual([]);+ expect(readFileSync(join(projectDir, 'bundle', 'index.md'), 'utf-8')).toBe(existingIndex);+ expect(existsSync(join(projectDir, 'bundle', 'concepts', 'getting-started.md'))).toBe(true);+ } finally {+ await rm(projectDir, { recursive: true, force: true });+ }+ });++ test('apply writes the two portable documents to disk verbatim', async () => {const { projectDir, cleanup } = await seedOkf();try {expect(readFileSync(join(projectDir, 'index.md'), 'utf-8')).toBe(OKF_INDEX_BODY);- expect(readFileSync(join(projectDir, 'log.md'), 'utf-8')).toBe(OKF_LOG_BODY);+ expect(readFileSync(join(projectDir, 'concepts', 'getting-started.md'), 'utf-8')).toBe(+ OKF_GETTING_STARTED_BODY,+ );} finally {await cleanup();}@@ -214,15 +283,15 @@ describe('okf pack — OKF §9 conformance by construction', () => {const { projectDir, cleanup } = await seedOkf();try {// Mutate a seeded file to prove apply never clobbers user edits.- const welcomeAbs = join(projectDir, 'welcome.md');- writeFileSync(welcomeAbs, 'EDITED BY USER\n', 'utf-8');+ const guideAbs = join(projectDir, 'concepts', 'getting-started.md');+ writeFileSync(guideAbs, 'EDITED BY USER\n', 'utf-8');const plan2 = await planSeed({ projectDir, packId: 'okf' });expect(plan2.created, 're-run should plan zero new writes').toEqual([]);const result2 = await applySeed(plan2, { projectDir, packId: 'okf' });expect(result2.errors).toEqual([]);expect(result2.applied).toBe(0);- expect(readFileSync(welcomeAbs, 'utf-8')).toBe('EDITED BY USER\n');+ expect(readFileSync(guideAbs, 'utf-8')).toBe('EDITED BY USER\n');} finally {await cleanup();}@@ -231,10 +300,9 @@ describe('okf pack — OKF §9 conformance by construction', () => {test('rule 2 holds with an editor present: the installed pack skill markdown carries a non-empty type', async () => {// `installPackSkill` copies the pack skill into `.claude/skills/...` when a// platform skill is present, and OK admits skill markdown under those- // dot-dirs into the content corpus — so the seeded skill doc is itself a+ // dot-dirs into the content corpus — so the projected skill doc is itself a// non-reserved content `.md` and must carry a non-empty `type` to keep the- // pack's contract. The blank-temp-dir tests never install a skill, so- // this case exercises the editor-present path explicitly.+ // pack's contract. This case exercises the editor-projection path explicitly.const projectDir = await mkdtemp(join(tmpdir(), 'seed-okf-skill-'));try {mkdirSync(join(projectDir, '.ok'), { recursive: true });@@ -274,12 +342,113 @@ describe('okf pack — OKF §9 conformance by construction', () => {});});+// Only the `okf` lint plugin is enabled — the seed's markdownlint/frontmatter+// conformance is a separate guarantee (pinned by the §11 tests above and by those+// plugins' own suites). Enabling every plugin here would fold their findings into+// this guard and blur which contract regressed.+const OKF_LINT_CONFIG: LinterConfig = {+ ...DEFAULT_LINTER_CONFIG,+ enabled: true,+ plugins: { ...DEFAULT_LINTER_CONFIG.plugins, okf: { enabled: true } },+};++describe('okf pack — the okf lint rules find nothing in the seeded bundle', () => {+ test('every produced .md, including the dot-directory templates and pack skill, yields zero okf findings', async () => {+ const { projectDir, cleanup } = await seedOkf();+ try {+ const files = collectMarkdown(projectDir);+ // The file set is deliberately WIDER than the project audit's reach. The+ // audit surfaces content documents only, so it never lints the seed's OK+ // infrastructure under dot-directories — `<folder>/.ok/templates/**` and+ // the installed pack skill — yet an external OKF consumer scanning the+ // tree sees those files. `collectMarkdown` walks into them; assert both are+ // present so a seed that stopped producing them can't turn this guard into+ // a vacuous pass over the two portable documents alone.+ //+ // The skill is matched by its filename rather than its directory: which+ // host dir it lands in is the skill installer's contract (and has its own+ // tests), not this one's. Pinning the path here only re-breaks this guard+ // whenever placement moves, which says nothing about OKF conformance.+ expect(files).toContain('index.md');+ expect(files).toContain('concepts/getting-started.md');+ expect(files).not.toContain('log.md');+ expect(files.filter((relPath) => relPath.endsWith('/index.md'))).toEqual([]);+ expect(files.some((relPath) => relPath.includes('.ok/templates/'))).toBe(true);+ expect(files.some((relPath) => relPath.endsWith('SKILL.md'))).toBe(true);++ for (const relPath of files) {+ // Lint the bytes as an OKF consumer would receive them — read back off+ // disk, no reconstruction. `relPath` is the extension-bearing content+ // path, the docName form the audit walk passes, so the name-scoped+ // index/log rules resolve identity through the same helper the audit uses.+ const source = readFileSync(join(projectDir, relPath), 'utf-8');+ const findings = await lintDocument(source, OKF_LINT_CONFIG, relPath);+ const detail = findings+ .map(+ (f) =>+ `${f.code} @ ${f.range.start.line + 1}:${f.range.start.character + 1} — ${f.message}`,+ )+ .join('; ');+ // On regression the message names the offending file, each rule code, and+ // its position — a broken rule points straight at what it flagged.+ expect(findings, `${relPath} produced okf findings: ${detail}`).toEqual([]);+ }+ } finally {+ await cleanup();+ }+ });+});++describe('knowledge-base + okf pack compatibility', () => {+ test.each([+ ['knowledge-base', 'okf'],+ ['okf', 'knowledge-base'],+ ] satisfies PackId[][])('both seed orders produce one clean OKF bundle: %s then %s', async (first, second) => {+ const order: PackId[] = [first, second];+ const { projectDir, cleanup } = await seedPackSequence(order);+ try {+ const files = collectMarkdown(projectDir);+ expect(files).toContain('index.md');+ expect(files).toContain('log.md');+ expect(files).toContain('external-sources/.ok/templates/clip.md');+ expect(files).toContain('research/.ok/templates/research-log.md');+ expect(files).toContain('articles/.ok/templates/article.md');++ const installedSkillNames = files+ .filter((relPath) => relPath.endsWith('/SKILL.md'))+ .map((relPath) => {+ const source = readFileSync(join(projectDir, relPath), 'utf-8');+ const { frontmatter } = stripFrontmatter(source);+ return parseFrontmatterYaml(unwrapFrontmatterFences(frontmatter)).map?.name;+ })+ .sort();+ expect(installedSkillNames).toEqual([+ 'consolidate-notes',+ 'knowledge-base',+ 'okf-knowledge-base',+ 'research-with-sources',+ ]);++ for (const relPath of files) {+ const source = readFileSync(join(projectDir, relPath), 'utf-8');+ const findings = await lintDocument(source, OKF_LINT_CONFIG, relPath);+ expect(+ findings,+ `${order.join(' → ')}: ${relPath} produced ${findings.map((f) => f.code).join(', ')}`,+ ).toEqual([]);+ }+ } finally {+ await cleanup();+ }+ });+});+// Scope: the templates every pack ships — NOT a full-seed of every pack. A pack// can also ship non-reserved root files (e.g. entity-vault's USER.md/SOUL.md)// that carry no `type`; those are out of scope here (templates only). This guard// keeps every pack's TEMPLATES rule-2 conformant so a new doc created from any// pack is born OKF-portable.-describe('all starter packs — OKF §9 rule 2 (every template instantiates a typed doc)', () => {+describe('all starter packs — OKF §11 rule 2 (every template instantiates a typed doc)', () => {test('every template in every pack carries a non-empty type in its instantiated doc-frontmatter', () => {const packs = Object.values(STARTER_PACKS);// Guard against a vacuous pass if the registry is ever emptied.diff --git a/packages/server/src/seed/plan.ts b/packages/server/src/seed/plan.tsindex 7e6fb08a2..c124adc7a 100644--- a/packages/server/src/seed/plan.ts+++ b/packages/server/src/seed/plan.ts@@ -13,6 +13,7 @@ import {resolvePackSkillSources,} from './install-pack-skill.ts';import { assertEntryPathInProject } from './path-safety.ts';+import { isPluginEnabled } from './required-plugins.ts';import { DEFAULT_PACK_ID, resolvePack, STARTER_FOLDER_FRONTMATTER_FILENAME } from './starter.ts';import type { FileEntry, ScaffoldPlan, SeedOptions, SkipEntry } from './types.ts';import { SeedPrerequisiteError, SeedRootDirError } from './types.ts';@@ -268,11 +269,21 @@ export async function planSeed(opts: SeedOptions = {}): Promise<ScaffoldPlan> {};});+ // Plugins the pack requires. Reported whenever the pack declares one — not+ // only when it is off — because the dialog discloses the dependency either+ // way: a user who turned it off is owed "seeding turns this back on", and a+ // user who has it on is owed "this pack depends on it".+ const requiredPlugins = (pack.requiredPlugins ?? []).map((id) => ({+ id,+ pending: !isPluginEnabled(projectDir, id),+ }));+return {created,skipped,warnings,...(packSkills.length > 0 ? { packSkills } : {}),+ ...(requiredPlugins.length > 0 ? { requiredPlugins } : {}),...(packSkills.length > 0 && homeRefusal !== undefined? { packSkillHomeRefusal: homeRefusal }: {}),diff --git a/packages/server/src/seed/required-plugins.ts b/packages/server/src/seed/required-plugins.tsnew file mode 100644index 000000000..940adc65d--- /dev/null+++ b/packages/server/src/seed/required-plugins.ts@@ -0,0 +1,86 @@+/**+ * The one place that knows how "this pack requires plugin X" becomes config.+ *+ * A pack declares `requiredPlugins: ['okf']` — a dependency it states about+ * itself. Nothing in the pack definition mentions `contentRules`, `enabled`, or+ * YAML. That spelling lives here, so a change to the config shape is a change+ * to this file and not to every pack.+ *+ * Reading and writing are deliberately siblings: `plan` asks whether a plugin is+ * already on to compute `pending`, and `apply` turns it on. If those two+ * disagreed about which key means "enabled", the plan would promise one thing+ * and the apply would do another.+ */++import { readFileSync } from 'node:fs';+import { join } from 'node:path';+import type { LintPluginId } from '@inkeep/open-knowledge-core';+import { parseDocument } from 'yaml';+import { tracedWriteFileSync } from '../fs-traced.ts';+import { CONFIG_FILENAME } from '../init-project.ts';++/** `.ok/config.yml` under a project root. */+function configPath(projectDir: string): string {+ return join(projectDir, '.ok', CONFIG_FILENAME);+}++/**+ * Whether `id` is currently enabled for this project.+ *+ * Anything unreadable, unparseable, or absent reads as NOT enabled. That is the+ * safe direction for both callers: the plan reports the plugin as pending and+ * the apply turns it on, which is idempotent. Guessing "enabled" from a broken+ * config would instead make the seed silently skip the one thing the pack needs.+ */+export function isPluginEnabled(projectDir: string, id: LintPluginId): boolean {+ let raw: string;+ try {+ raw = readFileSync(configPath(projectDir), 'utf8');+ } catch {+ return false;+ }+ try {+ const parsed = parseDocument(raw).toJSON() as+ | { contentRules?: Record<string, { enabled?: unknown }> }+ | null+ | undefined;+ return parsed?.contentRules?.[id]?.enabled === true;+ } catch {+ return false;+ }+}++/**+ * Turn `ids` on in the project config, returning the ids actually written.+ *+ * Sets the one leaf per plugin via the YAML Document rather than rewriting the+ * file: a user's other `contentRules` entries, their markdownlint rules, and+ * their comments and formatting all survive. `setIn` creates the intermediate+ * maps when the config has no `contentRules` block yet, so a freshly-initialized+ * (empty) config works without a special case.+ *+ * Deliberately NOT `applyPatchToDocument`: two functions carry that name in+ * core, and the one the barrel exports is the FRONTMATTER patcher, which+ * flattens a nested patch and drops sibling keys. It type-checks against a+ * Document and fails silently. Setting the leaf directly is both narrower than+ * this needs and immune to that.+ *+ * Already-enabled ids are skipped rather than re-written, which keeps a re-seed+ * from touching the file's mtime for no reason. An unwritable config is not+ * fatal: the caller reports it and the rest of the seed stands.+ */+export function enableRequiredPlugins(+ projectDir: string,+ ids: readonly LintPluginId[],+): LintPluginId[] {+ const pending = ids.filter((id) => !isPluginEnabled(projectDir, id));+ if (pending.length === 0) return [];++ const path = configPath(projectDir);+ const doc = parseDocument(readFileSync(path, 'utf8'));+ for (const id of pending) {+ doc.setIn(['contentRules', id, 'enabled'], true);+ }+ tracedWriteFileSync(path, doc.toString(), 'utf8');+ return pending;+}diff --git a/packages/server/src/seed/starter.test.ts b/packages/server/src/seed/starter.test.tsindex 227dc0c1f..6a2c47626 100644--- a/packages/server/src/seed/starter.test.ts+++ b/packages/server/src/seed/starter.test.ts@@ -70,22 +70,23 @@ describe('STARTER_FOLDERS — Karpathy three-layer starter pack', () => {expect(entry?.starterTemplate).toBe('clip');});- test('research description references research tool + provisional status + sources + grounding rule', () => {+ test('research description references research tool + OKF draft status + sources + grounding rule', () => {const entry = STARTER_FOLDERS.find((f) => f.path === 'research');expect(entry).toBeDefined();expect(entry?.description).toContain('Provisional analysis');expect(entry?.description).toContain('external-sources');- expect(entry?.description).toContain('status: provisional');+ expect(entry?.description).toContain('status: draft');expect(entry?.description).toContain('consolidate');expect(entry?.description.toLowerCase()).toMatch(/cite/);expect(entry?.tags).toEqual(['research', 'provisional', 'layer-research']);expect(entry?.starterTemplate).toBe('research-log');});- test('articles description references consolidate + canonical status + supersedes chain + traceable evidence', () => {+ test('articles description references consolidate + OKF stable status + supersedes chain + traceable evidence', () => {const entry = STARTER_FOLDERS.find((f) => f.path === 'articles');expect(entry).toBeDefined();expect(entry?.description).toContain('Canonical knowledge');+ expect(entry?.description).toContain('status: stable');expect(entry?.description).toContain('source of truth');expect(entry?.description).toContain('supersedes:');expect(entry?.description).toContain('research/');@@ -122,6 +123,11 @@ describe('STARTER_TEMPLATES', () => {}}});++ test('knowledge lifecycle templates use OKF v0.2 statuses', () => {+ expect(documentFrontmatter(STARTER_TEMPLATES['research-log'] ?? '')).toContain('status: draft');+ expect(documentFrontmatter(STARTER_TEMPLATES.article ?? '')).toContain('status: stable');+ });});describe('LOG_MD_TEMPLATE', () => {@@ -307,11 +313,10 @@ describe('STARTER_PACKS — all packs structural validation', () => {}});- // OKF reserved files (lowercase `index.md` / `log.md`) are frontmatter-free- // BY REQUIREMENT — any frontmatter on a reserved file is an OKF §9 rule-3- // violation (see the okf pack + okf-conformance.test.ts). They are the sole- // exemption to the "every rootFile carries a title" convention; every other- // rootFile across every pack still must.+ // OKF reserved files follow their format-specific frontmatter contracts rather+ // than the starter registry's general `title` convention. The root index may+ // declare only `okf_version`; log frontmatter is unconstrained when a pack+ // chooses to ship one.const OKF_RESERVED_ROOTFILES = new Set(OKF_RESERVED_FILENAMES);test('every non-reserved rootFile body has frontmatter with a non-empty title', () => {diff --git a/packages/server/src/seed/starter.ts b/packages/server/src/seed/starter.tsindex e572dd546..bc801b2b7 100644--- a/packages/server/src/seed/starter.ts+++ b/packages/server/src/seed/starter.ts@@ -33,6 +33,8 @@* existing test files and external consumers keep working without churn.*/+import type { LintPluginId } from '@inkeep/open-knowledge-core';+/** Stable identifier for a pack. */export type PackId =| 'knowledge-base'@@ -130,6 +132,20 @@ export interface StarterPack {* safety is enforced independently by `assertEntryPathInProject` at apply time.*/rootFiles?: Readonly<Record<string, string>>;+ /**+ * Lint plugins this pack REQUIRES to deliver what it promises. Seeding the+ * pack turns them on.+ *+ * A dependency the pack states about itself, not a config override it+ * carries: the pack names the plugin, and the seed owns how that is spelled+ * in `config.yml`. A pack that scaffolds conformant content and has no way+ * to keep it conformant is only conformant at t=0.+ *+ * Seed-time only. Nothing re-asserts these later, and a user who turns one+ * off afterward is not overridden — the plan discloses the enablement so+ * they can see why it came back on and undo it in Settings.+ */+ requiredPlugins?: readonly LintPluginId[];}// ─── Pack 1: Knowledge base (the existing Karpathy three-layer) ──────────@@ -149,7 +165,7 @@ const KNOWLEDGE_BASE_FOLDERS: readonly StarterFolder[] = [title: 'Research',uiSummary: 'Your work-in-progress take on what the sources mean.',description:- 'Provisional analysis that synthesizes the external sources. Every claim cites a doc in `external-sources/`; `status: provisional`. Promoted to `articles/` via `consolidate` once the findings are stable.',+ 'Provisional analysis that synthesizes the external sources. Every claim cites a doc in `external-sources/`; stored as OKF `status: draft`. Promoted to `articles/` via `consolidate` once the findings are stable.',tags: ['research', 'provisional', 'layer-research'],starterTemplate: 'research-log',},@@ -158,7 +174,7 @@ const KNOWLEDGE_BASE_FOLDERS: readonly StarterFolder[] = [title: 'Articles',uiSummary: 'The finished, trusted version you can rely on.',description:- 'Canonical knowledge, committed after a team decision. The source of truth for the domain; carries a `supersedes:` chain back to the `research/` docs it replaces.',+ 'Canonical knowledge, committed after a team decision and stored as OKF `status: stable`. The source of truth for the domain; carries a `supersedes:` chain back to the `research/` docs it replaces.',tags: ['article', 'canonical', 'layer-consolidate'],starterTemplate: 'article',},@@ -189,7 +205,7 @@ template:description: Provisional analysis synthesizing external sources. Every factual claim cites a doc in external-sources/. Promoted to articles/ via consolidate once findings are stable.type: research-notedescription: "Provisional findings that synthesize the cited sources, pending promotion to a canonical article."-status: provisional+status: draftsources: []created: {{date}}author: {{user}}@@ -207,10 +223,10 @@ tags: [research, provisional]article: `---template:title: Canonical Article- description: Canonical knowledge committed after a team decision. Carries status:canonical plus a supersedes chain tying back to the research/ docs it replaces. Source-of-truth for the domain.+ description: Canonical knowledge committed after a team decision. Carries OKF status:stable plus a supersedes chain tying back to the research/ docs it replaces. Source-of-truth for the domain.type: articledescription: "Canonical, team-approved reference for this topic."-status: canonical+status: stablesupersedes: []authored: {{date}}author: {{user}}@@ -1454,56 +1470,26 @@ description: "When the agent does scheduled work: daily briefings, end-of-day do// ─── Pack 7: OKF starter (Open Knowledge Format conformant-by-construction) ─//-// A small mini-KB whose seeded content is conformant with Google's Open-// Knowledge Format (OKF) v0.1 from commit one — WITHOUT enforcing anything.-// OKF's one hard requirement is a non-empty `type` on every non-reserved doc-// (§9 rules 1–2); plus reserved lowercase `index.md` (§6 navigation) and-// `log.md` (§7 change-history) that carry NO frontmatter (§9 rule 3).-//-// Conformance is PURELY pre-populated content: the native frontmatter schema-// stays open-shaped, nothing is linted, and `ok init` is untouched. The pack-// is a normal `STARTER_PACKS` entry — same shape, invocation, and discovery as-// every other pack.+// The portable bundle stays deliberately small: one root index, one populated+// domain folder, and one typed document. The nested `.ok/` files add+// OpenKnowledge's authoring layer without pretending that folder taxonomies,+// logs, provenance, or lifecycle metadata are part of OKF's conformance floor.+// Every non-reserved document still has parseable frontmatter with a non-empty+// `type`; the root index declares OKF v0.2 as a quoted string.//// Seeded content uses STANDARD markdown links (`[text](./path.md)`), not OK's-// `[[…]]` shorthand: a conformant OKF bundle's link graph is plain markdown,-// so authoring standard links keeps the seeded bundle portable to a strict-// OKF consumer.-//-// Reserved files are frontmatter-free convention exemplars, valid at seed time;-// the tool does not keep them live (the pack skill tells the author to maintain-// them). `log.md` seeds a prose instruction (not a dated placeholder entry),-// mirroring the other packs' root files — root files are written verbatim with-// no `{{date}}` substitution, so a seeded date would be wrong.+// `[[…]]` shorthand, so the bundle remains portable to strict OKF consumers.const OKF_FOLDERS: readonly StarterFolder[] = [{path: 'concepts',title: 'Concepts',- uiSummary: 'Ideas and definitions worth keeping.',+ uiSummary: 'Durable knowledge, one concept per file.',description:- 'Durable ideas and definitions, one file per concept. Each doc carries `type: concept` in its frontmatter. Link related concepts so the graph builds itself.',- tags: ['concept', 'okf'],+ 'Durable knowledge, one concept per file. New documents start as draft Concepts and use standard Markdown links for portable relationships.',+ tags: ['okf'],starterTemplate: 'concept',},- {- path: 'references',- title: 'References',- uiSummary: 'Sources and citations you rely on.',- description:- 'External sources and citations you rely on, one file per source. Each doc carries `type: reference`. Link the docs that cite a reference so the evidence trail stays navigable.',- tags: ['reference', 'okf'],- starterTemplate: 'reference',- },- {- path: 'notes',- title: 'Notes',- uiSummary: 'Working notes and observations.',- description:- 'Working notes and observations, one file per note. Each doc carries `type: note`. The lightest section — capture first, link as ideas connect.',- tags: ['note', 'okf'],- starterTemplate: 'note',- },] as const;// Templates are a single frontmatter block: the template's own picker identity@@ -1515,113 +1501,42 @@ const OKF_TEMPLATES: Readonly<Record<string, string>> = {concept: `---template:title: Concept Name- description: One-line definition of the concept.-type: concept-description: "Explanation of a concept and how it connects to related ideas."-created: {{date}}-author: {{user}}-tags: [concept]------## Definition--## Why it matters--## Related--- Link a related idea, e.g. \`[another concept](./another-concept.md)\`.-`,- reference: `----template:- title: Reference Title- description: One-line summary of the source.-type: reference-description: "A reference entry kept for quick lookup."-created: {{date}}-author: {{user}}-tags: [reference]+ description: Durable knowledge about one concept.+type: Concept+status: draft---## Summary-## Key points--## Where this is used--- Link the docs that cite this reference.-`,- note: `----template:- title: Note Title- description: One-line summary of the note.-type: note-description: "A freeform note."-created: {{date}}-author: {{user}}-tags: [note]------## Note+## Details-## Links+## Related`,};-// A real, non-reserved seed doc — single frontmatter block carrying a non-empty-// `type` (the OKF §9 rule-2 requirement). Gives a strict OKF consumer a typed-// document to accept and gives `index.md` a real link target. `Document` is the-// OKF floor (non-empty is all OKF needs); the author picks a more specific type-// as the KB grows.-const OKF_WELCOME_MD = `----title: Welcome-description: Start here — what this knowledge base is and how it is organized.-type: Document-tags: [welcome]+const OKF_GETTING_STARTED_MD = `---+type: Guide+title: Getting started+description: Purpose and organization of this knowledge base.+status: stable----# Welcome--This knowledge base was scaffolded with the **OKF starter pack**, so it is conformant with the Open Knowledge Format (OKF) from the first commit.--## How it is organized+# Getting started-- [index](./index.md) — the navigation hub (a reserved OKF file; carries no frontmatter).-- [log](./log.md) — the change history (a reserved OKF file; carries no frontmatter).-- [concepts/](./concepts/), [references/](./references/), [notes/](./notes/) — your content. Every document here carries a non-empty \`type\` in its frontmatter.+Use this knowledge base for durable concepts that people and agents can link, exchange, and reuse.-## The one rule+Each concept needs parseable YAML frontmatter with a non-empty \`type\`. Use standard Markdown links so relationships remain portable to other OKF tools.-OKF requires exactly one thing of every non-reserved document: a non-empty \`type\`. The value is yours to choose — \`concept\`, \`reference\`, \`note\`, or anything that fits. \`Document\` is a fine generic fallback.--See the project skill for the full set of conventions.+The OpenKnowledge OKF plugin warns when content may not survive a handoff to another OKF consumer. Its companion skill provides the complete authoring guidance.`;-// Reserved OKF §6 navigation file. Lowercase \`index.md\`, FRONTMATTER-FREE-// (any frontmatter on a reserved file is a §9 rule-3 violation). A-// progressive-disclosure link-list (standard markdown links) to the seeded-// doc + sections.-const OKF_INDEX_MD = `# Index--The navigation hub for this knowledge base. Start with [welcome](./welcome.md), then explore by section.--## Sections--- [welcome](./welcome.md) — what this knowledge base is and how it is organized-- [concepts/](./concepts/) — durable ideas and definitions, one file per concept (\`type: concept\`)-- [references/](./references/) — sources and citations you rely on (\`type: reference\`)-- [notes/](./notes/) — working notes and observations (\`type: note\`)--Every document outside this file and \`log.md\` carries a non-empty \`type\` in its frontmatter — that is all OKF requires.-`;+const OKF_INDEX_MD = `---+okf_version: "0.2"+----// Reserved OKF §7 change-history file. Lowercase \`log.md\`, FRONTMATTER-FREE.-// Seeds a prose instruction documenting the newest-first dated-entry format-// (\`## YYYY-MM-DD: summary\`) rather than a placeholder entry — mirroring the-// other packs' log.md, and avoiding a stale seeded date (root files get no-// \`{{date}}\` substitution). The author adds the first real entry on first edit.-const OKF_LOG_MD = `# Log+# Knowledge base-Change history for this knowledge base, newest entry first. Add a dated entry (\`## YYYY-MM-DD: <summary>\`) whenever you create, edit, or restructure content — one entry per working session, not per file.+- [Getting started](./concepts/getting-started.md) — purpose and conventions.`;// ─── The registry ─────────────────────────────────────────────────────────@@ -1676,18 +1591,19 @@ export const STARTER_PACKS: Readonly<Record<PackId, StarterPack>> = {id: 'okf',name: 'Open Knowledge Format',description: "Wiki using Google's Open Knowledge Format.",- // Root scaffold: OKF reserved files (index.md / log.md) belong at the- // bundle root, so the project root IS the OKF bundle (no subfolder).+ // The project root is the portable OKF bundle; `.ok/` remains an+ // OpenKnowledge-only authoring layer nested inside it.defaultSubfolder: undefined,folders: OKF_FOLDERS,templates: OKF_TEMPLATES,- // `welcome.md` is a real non-reserved typed doc; `index.md` / `log.md` are- // the frontmatter-free OKF reserved files (§6 / §7).rootFiles: {- 'welcome.md': OKF_WELCOME_MD,'index.md': OKF_INDEX_MD,- 'log.md': OKF_LOG_MD,+ 'concepts/getting-started.md': OKF_GETTING_STARTED_MD,},+ // The scaffold is OKF-conformant by construction, and nothing keeps it that+ // way — the first doc written after seeding can drift silently. The plugin+ // is what turns "conformant at t=0" into "conformance maintained".+ requiredPlugins: ['okf'],},'writing-pipeline': {id: 'writing-pipeline',@@ -1726,10 +1642,11 @@ export const STARTER_PACKS: Readonly<Record<PackId, StarterPack>> = {export const STARTER_PACK_IDS: readonly PackId[] = Object.keys(STARTER_PACKS) as PackId[];/**- * The OKF pack's reserved files (OKF §6 navigation + §7 change-history). These- * are lowercase and FRONTMATTER-FREE by requirement — any frontmatter on a- * reserved file is an OKF §9 rule-3 violation. Single source of truth so the- * pack and its conformance tests can't drift on which files are reserved.+ * The OKF pack's reserved files (OKF §8 navigation + §9 change-history). These+ * are lowercase; §11 rule 3 asks reserved files follow §8/§9 structure — §8 keeps+ * an index frontmatter-free (a root index MAY add `okf_version`), while §9 does not+ * constrain a log's frontmatter. Single source of truth so the pack and its+ * conformance tests can't drift on which files are reserved.*/export const OKF_RESERVED_FILENAMES: readonly string[] = ['index.md', 'log.md'];diff --git a/packages/server/src/seed/types.ts b/packages/server/src/seed/types.tsindex 49bfa9354..60c3e5d2b 100644--- a/packages/server/src/seed/types.ts+++ b/packages/server/src/seed/types.ts@@ -7,6 +7,7 @@* each starter folder's `.ok/frontmatter.yml` + `.ok/templates/<name>.md`.*/+import type { LintPluginId } from '@inkeep/open-knowledge-core';import type { PackId } from './starter.ts';/**@@ -73,6 +74,17 @@ export interface ScaffoldPlan {* `pending` is always false when `packSkillHomeRefusal` is set — see below.*/packSkills?: { name: string; pending: boolean; conflict?: boolean }[];+ /**+ * Lint plugins the pack requires. `pending` is true when the plugin is not+ * currently enabled and apply would turn it on — the same "is there work to+ * do?" signal `packSkills[].pending` carries.+ *+ * Present whenever the pack declares a requirement, enabled or not, because+ * the dialog discloses the requirement either way: a user who turned the+ * plugin off needs to see that seeding will turn it back on, and a user who+ * already has it on is owed the same statement of what the pack depends on.+ */+ requiredPlugins?: { id: LintPluginId; pending: boolean }[];/*** Set when the pack ships skills but this project has no usable skill home,* so apply cannot install any of them (OK never creates an agent folder on@@ -103,6 +115,13 @@ export interface ApplyResult {* pack ships no skill.*/packSkillsInstalled: string[];+ /**+ * Required plugins this apply actually turned on. Empty when the pack+ * declares none, or when every one was already enabled — so a non-empty+ * value is exactly the set the user's config changed for, which is what a+ * caller reports back ("Enabled the OKF plugin").+ */+ pluginsEnabled: LintPluginId[];/** Pack skills skipped because a user-owned same-named skill holds the name. */packSkillConflicts: PackSkillConflict[];}diff --git a/packages/server/src/server-factory.test.ts b/packages/server/src/server-factory.test.tsindex b49992876..f920eb353 100644--- a/packages/server/src/server-factory.test.ts+++ b/packages/server/src/server-factory.test.ts@@ -3,7 +3,9 @@ import {mkdirSync,mkdtempSync,readFileSync,+ renameSync,rmSync,+ statSync,unlinkSync,writeFileSync,} from 'node:fs';@@ -20,6 +22,7 @@ import * as Y from 'yjs';import { MAX_AGENT_SESSIONS } from './agent-sessions.ts';import { BacklinkIndex } from './backlink-index.ts';import { getBootTimings, resetBootTimingsForTest, startBootTimings } from './boot-timings.ts';+import { updateGeneratedIndexGitAttributes } from './content/generated-index-git-attributes.ts';import { DerivedDocumentIndex } from './derived-document-index.ts';import { classifyGitError } from './error-classification.ts';import { applyExternalChange } from './external-change.ts';@@ -3713,3 +3716,1266 @@ describe('buildSyncCredentialArgs()', () => {expect(argvFromHelper(args)).toEqual([...argv, 'auth', 'git-credential']);});});++/**+ * The generated index's WIRING, at real fidelity — a real server, a real+ * watcher, real disk, a real shadow repo.+ *+ * This layer is where the feature's two shipped bugs lived, and neither was+ * visible to a unit test: the config key was dropped in the persisted→runtime+ * lift, and the delete branch for an unloaded document never scheduled a+ * rebuild. Both left every pure test green. So each trigger gets exercised+ * end-to-end against the index file it is supposed to move, rather than against+ * the scheduler being called.+ */+describe('createServer() — generated index wiring', () => {+ let projectDir: string;+ let contentDir: string;+ let server: ServerInstance | null;+ let shadowHandle: Awaited<ReturnType<typeof initShadowRepo>>;+ let localHttp: import('node:http').Server | null = null;++ const indexPath = () => join(contentDir, 'index.md');+ const readIndex = () => readFileSync(indexPath(), 'utf-8');++ /** The index that lives in a subdirectory, addressed by its content path. */+ const indexPathAt = (dir: string) => join(contentDir, dir, 'index.md');+ const readIndexAt = (dir: string) => readFileSync(indexPathAt(dir), 'utf-8');+ async function waitForIndexAt(+ dir: string,+ predicate: (markdown: string) => boolean,+ ): Promise<void> {+ await vi.waitFor(+ () => {+ expect(existsSync(indexPathAt(dir))).toBe(true);+ expect(predicate(readIndexAt(dir))).toBe(true);+ },+ { timeout: 20_000, interval: 50 },+ );+ }++ /** A typed doc, which is the only shape the index renders. */+ function writeDoc(rel: string, title: string, type = 'note', description?: string): void {+ const fm = [+ `title: ${title}`,+ `type: ${type}`,+ ...(description ? [`description: ${description}`] : []),+ ];+ mkdirSync(join(contentDir, rel, '..'), { recursive: true });+ writeFileSync(join(contentDir, rel), `---\n${fm.join('\n')}\n---\n\n# ${title}\n`, 'utf-8');+ }++ async function waitForIndex(predicate: (markdown: string) => boolean): Promise<void> {+ await vi.waitFor(+ () => {+ expect(existsSync(indexPath())).toBe(true);+ expect(predicate(readIndex())).toBe(true);+ },+ { timeout: 20_000, interval: 50 },+ );+ }++ async function bootServer(): Promise<ServerInstance> {+ await ensureProjectGit(projectDir);+ await prepareGeneratedIndexGitAttributes();+ shadowHandle = await initShadowRepo(projectDir);+ server = createServer({+ contentDir,+ projectDir,+ contentRoot: 'content',+ quiet: true,+ shadowRepo: shadowHandle,+ skipStateManifestCheck: true,+ });+ await server.ready;+ await server.generatedIndexSweepReady;+ return server;+ }++ async function startServerWithIndexHooks(+ generatedIndexTestHooks: NonNullable<+ Parameters<typeof createServer>[0]['generatedIndexTestHooks']+ >,+ ): Promise<ServerInstance> {+ await ensureProjectGit(projectDir);+ await prepareGeneratedIndexGitAttributes();+ shadowHandle = await initShadowRepo(projectDir);+ server = createServer({+ contentDir,+ projectDir,+ contentRoot: 'content',+ quiet: true,+ shadowRepo: shadowHandle,+ skipStateManifestCheck: true,+ generatedIndexTestHooks,+ });+ return server;+ }++ async function prepareGeneratedIndexGitAttributes(): Promise<void> {+ const config = readConfigSafely({+ absPath: resolveConfigPath('project', projectDir),+ sideline: false,+ });+ if (config.value.contentRules?.okf?.generate?.index !== true) return;+ const result = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames: ['index'],+ enabled: true,+ });+ expect(result.ok).toBe(true);+ }++ /**+ * A real loopback HTTP endpoint bound to the booted server's api-extension, so+ * a test drives an agent write through the same request seam production does —+ * the seam that decides whether an API write schedules an index rebuild. The+ * server itself opens no listener; the api-extension is a Hocuspocus onRequest+ * handler, identified by its priority among the configured extensions.+ */+ async function apiBaseUrl(): Promise<string> {+ const apiExt = server?.hocuspocus.configuration.extensions.find(+ (e: unknown) =>+ typeof (e as { onRequest?: unknown }).onRequest === 'function' &&+ (e as { priority?: number }).priority === 100,+ ) as+ | {+ onRequest: (ctx: {+ request: import('node:http').IncomingMessage;+ response: import('node:http').ServerResponse;+ }) => Promise<void>;+ }+ | undefined;+ if (!apiExt) throw new Error('api-extension not found in extensions array');++ const { createServer: createNodeHttp } = await import('node:http');+ localHttp = createNodeHttp((req, res) => {+ void apiExt.onRequest({ request: req, response: res });+ });+ await new Promise<void>((resolve) => localHttp?.listen(0, '127.0.0.1', resolve));+ const address = localHttp.address();+ if (typeof address !== 'object' || address === null) {+ throw new Error('local HTTP server did not bind to a port');+ }+ return `http://127.0.0.1:${address.port}`;+ }++ /** Drive an agent markdown write through the API seam. */+ async function agentWriteMd(baseUrl: string, docName: string, markdown: string): Promise<void> {+ const res = await fetch(`${baseUrl}/api/agent-write-md`, {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify({ docName, markdown, position: 'replace' }),+ });+ const body = await res.text();+ expect(res.status, body).toBe(200);+ }++ beforeEach(async () => {+ projectDir = await mkdtemp(join(tmpdir(), 'ok-index-wiring-'));+ // Shadow repo needs contentDir under projectDir so `git add <contentRoot>`+ // has a valid pathspec — mirrors the real-world layout.+ contentDir = join(projectDir, 'content');+ mkdirSync(contentDir, { recursive: true });+ mkdirSync(join(projectDir, '.ok'), { recursive: true });+ // Written as real YAML through the real config file, so the persisted →+ // runtime lift that silently dropped this key is on the tested path.+ writeFileSync(+ join(projectDir, '.ok', 'config.yml'),+ stringifyYaml({ contentRules: { okf: { enabled: true, generate: { index: true } } } }),+ 'utf-8',+ );+ server = null;+ });++ afterEach(async () => {+ if (localHttp) {+ await new Promise<void>((resolve, reject) =>+ localHttp?.close((err) => (err ? reject(err) : resolve())),+ );+ localHttp = null;+ }+ await server?.destroy();+ loggerFactory.reset();+ await rm(projectDir, { recursive: true, force: true });+ });++ test('the setting reaches the server through the real config file', async () => {+ await bootServer();+ writeDoc('note.md', 'A note', 'note', 'Something to index.');++ // An index appearing at all is the end-to-end proof that+ // `contentRules.okf.generateIndex` survived YAML parse → persisted shape →+ // `toEffectiveBase` → the server's `=== true` gate. A key dropped anywhere+ // in that chain leaves this file absent forever.+ await waitForIndex((md) => md.includes('A note'));+ expect(readIndex()).toContain('okf_version: "0.2"');+ });++ test('server readiness settles before the boot index sweep starts planning', async () => {+ writeDoc('existing.md', 'Existing at boot', 'note');++ let enterPlanning!: () => void;+ const planningEntered = new Promise<void>((resolve) => {+ enterPlanning = resolve;+ });+ let releasePlanning!: () => void;+ const planningBarrier = new Promise<void>((resolve) => {+ releasePlanning = resolve;+ });+ let readySettled = false;++ const activeServer = await startServerWithIndexHooks({+ beforePlan: async ({ fullSweep }) => {+ if (!fullSweep) return;+ enterPlanning();+ await planningBarrier;+ },+ });+ void activeServer.ready.then(() => {+ readySettled = true;+ });+ let sweepSettled = false;+ void activeServer.generatedIndexSweepReady.then(() => {+ sweepSettled = true;+ });++ await planningEntered;+ expect(readySettled).toBe(true);+ expect(sweepSettled).toBe(false);+ expect(existsSync(indexPath())).toBe(false);++ releasePlanning();+ await expect(activeServer.generatedIndexSweepReady).resolves.toEqual({+ status: 'completed',+ indexCount: 1,+ });+ expect(existsSync(indexPath())).toBe(true);+ expect(readIndex()).toContain('* [Existing at boot](./existing.md)');+ });++ test('a non-fatal boot sweep error reports a failed settlement', async () => {+ const activeServer = await startServerWithIndexHooks({+ beforePlan: () => {+ throw new Error('injected generated-index failure');+ },+ });++ await expect(activeServer.ready).resolves.toBeUndefined();+ await expect(activeServer.generatedIndexSweepReady).resolves.toEqual({+ status: 'failed',+ indexCount: 0,+ });+ });++ test('disabling generation stops an in-flight sweep before its next write', async () => {+ writeDoc('alpha/a.md', 'Alpha', 'note');+ writeDoc('beta/b.md', 'Beta', 'note');++ const preservedRoot = '# Existing root index\n';+ const preservedBeta = '# Existing beta index\n';+ writeFileSync(indexPath(), preservedRoot, 'utf-8');+ writeFileSync(indexPathAt('beta'), preservedBeta, 'utf-8');+ const rootMtime = statSync(indexPath()).mtimeMs;+ const betaMtime = statSync(indexPathAt('beta')).mtimeMs;++ let firstWriteFinished!: () => void;+ const firstWrite = new Promise<void>((resolve) => {+ firstWriteFinished = resolve;+ });+ let releaseFirstWrite!: () => void;+ const firstWriteBarrier = new Promise<void>((resolve) => {+ releaseFirstWrite = resolve;+ });+ let paused = false;++ const activeServer = await startServerWithIndexHooks({+ afterWrite: async ({ docName }) => {+ if (paused || docName !== 'alpha/index') return;+ paused = true;+ firstWriteFinished();+ await firstWriteBarrier;+ },+ });+ await activeServer.ready;+ await firstWrite;++ writeFileSync(+ join(projectDir, '.ok', 'config.yml'),+ stringifyYaml({ contentRules: { okf: { enabled: true, generate: { index: false } } } }),+ 'utf-8',+ );+ releaseFirstWrite();++ await expect(activeServer.generatedIndexSweepReady).resolves.toEqual({+ status: 'disabled',+ indexCount: 1,+ });+ await new Promise((resolve) => setTimeout(resolve, 750));++ expect(existsSync(indexPathAt('alpha'))).toBe(true);+ expect(readIndex()).toBe(preservedRoot);+ expect(readIndexAt('beta')).toBe(preservedBeta);+ expect(statSync(indexPath()).mtimeMs).toBe(rootMtime);+ expect(statSync(indexPathAt('beta')).mtimeMs).toBe(betaMtime);++ writeDoc('beta/after-disable.md', 'After disable', 'note');+ await new Promise((resolve) => setTimeout(resolve, 750));++ expect(readIndex()).toBe(preservedRoot);+ expect(readIndexAt('beta')).toBe(preservedBeta);+ expect(statSync(indexPath()).mtimeMs).toBe(rootMtime);+ expect(statSync(indexPathAt('beta')).mtimeMs).toBe(betaMtime);+ });++ test('boot sweep readiness waits for live requests coalesced behind it', async () => {+ writeDoc('anchor.md', 'Anchor', 'note');++ let firstPassEntered!: () => void;+ const firstPassStarted = new Promise<void>((resolve) => {+ firstPassEntered = resolve;+ });+ let releaseFirstPass!: () => void;+ const firstPassBarrier = new Promise<void>((resolve) => {+ releaseFirstPass = resolve;+ });+ let coordinatorIdle!: () => void;+ const coordinatorSettled = new Promise<void>((resolve) => {+ coordinatorIdle = resolve;+ });+ let blockedKickObserved!: () => void;+ const followupDeferredBySingleFlight = new Promise<void>((resolve) => {+ blockedKickObserved = resolve;+ });+ let passCount = 0;++ const activeServer = await startServerWithIndexHooks({+ beforePlan: async () => {+ passCount++;+ if (passCount !== 1) return;+ firstPassEntered();+ await firstPassBarrier;+ },+ onIdle: () => {+ if (passCount === 2) coordinatorIdle();+ },+ onKickWhileInFlight: blockedKickObserved,+ });+ await activeServer.ready;+ await firstPassStarted;+ let sweepSettled = false;+ void activeServer.generatedIndexSweepReady.then(() => {+ sweepSettled = true;+ });+ const baseUrl = await apiBaseUrl();++ await agentWriteMd(baseUrl, 'one', '---\ntitle: One\ntype: note\n---\n\n# One\n');+ await agentWriteMd(baseUrl, 'two', '---\ntitle: Two\ntype: note\n---\n\n# Two\n');+ await agentWriteMd(baseUrl, 'three', '---\ntitle: Three\ntype: note\n---\n\n# Three\n');++ await followupDeferredBySingleFlight;+ expect(passCount).toBe(1);+ releaseFirstPass();+ await new Promise<void>((resolve) => setImmediate(resolve));+ expect(sweepSettled).toBe(false);+ await coordinatorSettled;+ await expect(activeServer.generatedIndexSweepReady).resolves.toMatchObject({+ status: 'completed',+ });++ expect(passCount).toBe(2);+ expect(readIndex()).toContain('* [One](./one.md)');+ expect(readIndex()).toContain('* [Two](./two.md)');+ expect(readIndex()).toContain('* [Three](./three.md)');+ });++ test('destroy cancels and drains an in-flight generated-index write', async () => {+ writeDoc('deep/note.md', 'Deep note', 'note');++ let writePaused!: () => void;+ const firstWritePaused = new Promise<void>((resolve) => {+ writePaused = resolve;+ });+ let releaseWrite!: () => void;+ const writeBarrier = new Promise<void>((resolve) => {+ releaseWrite = resolve;+ });+ let abortObserved!: () => void;+ const regenerationAborted = new Promise<void>((resolve) => {+ abortObserved = resolve;+ });+ let blocked = false;++ const activeServer = await startServerWithIndexHooks({+ afterWrite: async ({ signal }) => {+ if (blocked) return;+ blocked = true;+ signal.addEventListener('abort', abortObserved, { once: true });+ writePaused();+ await writeBarrier;+ },+ });+ await activeServer.ready;+ await firstWritePaused;++ let destroySettled = false;+ const destroying = activeServer.destroy().then(() => {+ destroySettled = true;+ });+ await regenerationAborted;+ expect(destroySettled).toBe(false);+ expect(existsSync(indexPathAt('deep'))).toBe(true);+ expect(existsSync(indexPath())).toBe(false);++ releaseWrite();+ await destroying;+ await expect(activeServer.generatedIndexSweepReady).resolves.toEqual({+ status: 'cancelled',+ indexCount: 1,+ });+ expect(existsSync(indexPath())).toBe(false);+ });++ test('creating a document lands its entry in its own folder index', async () => {+ await bootServer();+ writeDoc('concepts/first.md', 'First', 'concept');+ // The entry lives in the folder's index, relative to that folder…+ await waitForIndexAt('concepts', (md) => md.includes('* [First](./first.md)'));+ // …and the root links the child index — written after it, deepest-first —+ // rather than the document itself.+ await waitForIndex((md) => md.includes('* [concepts](./concepts/index.md)'));+ expect(readIndex()).not.toContain('./concepts/first.md');++ writeDoc('concepts/second.md', 'Second', 'concept');+ await waitForIndexAt('concepts', (md) => md.includes('* [Second](./second.md)'));+ expect(readIndexAt('concepts')).toContain('* [First](./first.md)');+ });++ test('an external metadata update refreshes the existing entry', async () => {+ writeDoc('note.md', 'Before', 'note', 'Old description');+ await bootServer();+ await waitForIndex((md) => md.includes('[Before]'));++ writeDoc('note.md', 'After', 'concept', 'New description');++ await waitForIndex(+ (md) =>+ md.includes('# concept') &&+ md.includes('[After]') &&+ md.includes('New description') &&+ !md.includes('[Before]'),+ );+ });++ test('settings endpoint commits the Git rule and config as one lifecycle operation', async () => {+ writeFileSync(+ join(projectDir, '.ok', 'config.yml'),+ stringifyYaml({ contentRules: { okf: { enabled: true, generate: { index: false } } } }),+ 'utf-8',+ );+ writeDoc('waiting.md', 'Waiting', 'note');+ const activeServer = await bootServer();+ await expect(activeServer.generatedIndexSweepReady).resolves.toEqual({+ status: 'disabled',+ indexCount: 0,+ });+ expect(existsSync(indexPath())).toBe(false);+ expect(existsSync(join(projectDir, '.gitattributes'))).toBe(false);++ const baseUrl = await apiBaseUrl();+ const enabled = await fetch(`${baseUrl}/api/generated-index/settings`, {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify({ enabled: true }),+ });+ expect(enabled.status).toBe(200);+ await expect(enabled.json()).resolves.toMatchObject({+ enabled: true,+ active: true,+ applied: true,+ git: { state: 'ready', ownership: 'open-knowledge' },+ });++ await waitForIndex((md) => md.includes('[Waiting]'));+ expect(readFileSync(join(projectDir, '.gitattributes'), 'utf-8')).toContain(+ '/content/**/index.md merge=union',+ );++ const indexBeforeDisable = readIndex();+ const disabled = await fetch(`${baseUrl}/api/generated-index/settings`, {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify({ enabled: false }),+ });+ expect(disabled.status).toBe(200);+ await expect(disabled.json()).resolves.toMatchObject({+ enabled: false,+ active: false,+ applied: true,+ });+ expect(existsSync(join(projectDir, '.gitattributes'))).toBe(false);+ expect(readIndex()).toBe(indexBeforeDisable);+ });++ test('settings endpoint rolls the Git rule back when the config write is rejected', async () => {+ const invalidConfig = 'contentRules: [\n';+ writeFileSync(join(projectDir, '.ok', 'config.yml'), invalidConfig, 'utf-8');+ writeDoc('waiting.md', 'Waiting', 'note');+ const activeServer = await bootServer();+ await expect(activeServer.generatedIndexSweepReady).resolves.toEqual({+ status: 'disabled',+ indexCount: 0,+ });++ const response = await fetch(`${await apiBaseUrl()}/api/generated-index/settings`, {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify({ enabled: true }),+ });++ expect(response.status).toBe(200);+ await expect(response.json()).resolves.toMatchObject({+ enabled: false,+ active: false,+ applied: false,+ reason: 'config-write',+ git: { state: 'missing' },+ });+ expect(readFileSync(join(projectDir, '.ok', 'config.yml'), 'utf-8')).toBe(invalidConfig);+ expect(existsSync(join(projectDir, '.gitattributes'))).toBe(false);+ expect(existsSync(indexPath())).toBe(false);+ });++ test('settings endpoint repairs a missing Git rule when config is already enabled', async () => {+ writeFileSync(+ join(projectDir, '.ok', 'config.yml'),+ stringifyYaml({ contentRules: { okf: { enabled: true, generate: { index: true } } } }),+ 'utf-8',+ );+ const activeServer = await bootServer();+ await activeServer.generatedIndexSweepReady;+ unlinkSync(join(projectDir, '.gitattributes'));+ expect(existsSync(join(projectDir, '.gitattributes'))).toBe(false);++ const response = await fetch(`${await apiBaseUrl()}/api/generated-index/settings`, {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify({ enabled: true }),+ });+ expect(response.status).toBe(200);+ await expect(response.json()).resolves.toMatchObject({+ enabled: true,+ active: true,+ applied: true,+ git: { state: 'ready', ownership: 'open-knowledge' },+ });+ await new Promise((resolve) => setTimeout(resolve, 100));+ expect(readFileSync(join(projectDir, '.gitattributes'), 'utf-8')).toContain(+ '/content/**/index.md merge=union',+ );+ });++ test('external Git-attribute drift pauses regeneration and resumes after repair', async () => {+ const logCapture = captureAllLoggers();+ await bootServer();+ writeDoc('note.md', 'Before drift', 'note');+ await waitForIndex((md) => md.includes('[Before drift]'));+ const preservedIndex = readIndex();+ const preservedMtime = statSync(indexPath()).mtimeMs;++ writeFileSync(+ join(projectDir, '.gitattributes'),+ '/content/index.md merge=ours\n/content/**/index.md merge=ours\n',+ 'utf-8',+ );+ writeDoc('note.md', 'Blocked by drift', 'note');++ await vi.waitFor(+ () => {+ expect(+ logCapture+ .getCalls('warn', 'generated index regeneration paused by Git attributes')+ .some((entry) => entry.payload.state === 'conflict'),+ ).toBe(true);+ },+ { timeout: 20_000, interval: 50 },+ );+ expect(readIndex()).toBe(preservedIndex);+ expect(statSync(indexPath()).mtimeMs).toBe(preservedMtime);++ const pausedStatus = await fetch(`${await apiBaseUrl()}/api/generated-index/settings`);+ expect(pausedStatus.status).toBe(200);+ await expect(pausedStatus.json()).resolves.toMatchObject({+ enabled: true,+ active: false,+ git: { state: 'conflict' },+ });++ unlinkSync(join(projectDir, '.gitattributes'));+ const repaired = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames: ['index'],+ enabled: true,+ });+ expect(repaired.ok).toBe(true);++ writeDoc('note.md', 'Recovered after repair', 'note');+ await waitForIndex(+ (md) => md.includes('[Recovered after repair]') && !md.includes('[Before drift]'),+ );+ });++ test('deleting an unopened document removes its entry from its folder index', async () => {+ // The regression that shipped: `case 'delete'` returns early when the+ // document is not resident, and that branch skipped the rebuild — so the+ // index kept a link to a file that no longer existed. Nothing here ever+ // opens the doc, which is exactly the common case.+ await bootServer();+ writeDoc('concepts/doomed.md', 'Doomed', 'concept');+ writeDoc('concepts/survivor.md', 'Survivor', 'concept');+ await waitForIndexAt('concepts', (md) => md.includes('./doomed.md'));++ unlinkSync(join(contentDir, 'concepts', 'doomed.md'));++ await waitForIndexAt('concepts', (md) => !md.includes('./doomed.md'));+ // The rest of the folder survives — this is a rebuild, not a truncation.+ expect(readIndexAt('concepts')).toContain('./survivor.md');+ });++ test('an emptied section disappears rather than lingering as a bare heading', async () => {+ await bootServer();+ writeDoc('only.md', 'Only', 'solo-type');+ writeDoc('keep.md', 'Keep', 'note');+ await waitForIndex((md) => md.includes('## solo-type'));++ unlinkSync(join(contentDir, 'only.md'));++ await waitForIndex((md) => !md.includes('## solo-type'));+ expect(readIndex()).toContain('## note');+ });++ test('a cross-directory rename through the watcher drops the source entry and lands the destination', async () => {+ // `concepts` keeps a second document so it stays in the index set and is+ // rebuilt to drop the moved entry, isolating the source-directory fix from+ // the unrelated case of a directory losing its last document. `archive`+ // starts populated so this is a plain move between two already-indexed+ // folders, where the stale-source defect actually bites.+ writeDoc('concepts/mover.md', 'Mover', 'concept');+ writeDoc('concepts/keeper.md', 'Keeper', 'concept');+ writeDoc('archive/anchor.md', 'Anchor', 'note');+ await bootServer();+ await waitForIndexAt('concepts', (md) => md.includes('./mover.md'));+ await waitForIndexAt('archive', (md) => md.includes('./anchor.md'));++ // Moving the exact bytes lets the watcher pair the same-batch delete+create+ // by content hash into one `rename` event — the composed path the fix lives+ // on. A split into a separate delete and create would each schedule their+ // own directory, so the source would never go stale and the rename path+ // would go unproven.+ renameSync(join(contentDir, 'concepts', 'mover.md'), join(contentDir, 'archive', 'mover.md'));++ // Endpoint-shaped: the destination lists the moved document and the source+ // no longer does, while the source keeps its other entry.+ await waitForIndexAt('archive', (md) => md.includes('./mover.md'));+ await waitForIndexAt(+ 'concepts',+ (md) => !md.includes('./mover.md') && md.includes('./keeper.md'),+ );+ });++ test('moving a directory last admitted document preserves its orphan index', async () => {+ writeDoc('source/only.md', 'Only', 'note');+ writeDoc('destination/anchor.md', 'Anchor', 'note');+ await bootServer();+ await server?.generatedIndexSweepReady;+ await waitForIndex(+ (md) => md.includes('./source/index.md') && md.includes('./destination/index.md'),+ );++ const orphanBytes = readIndexAt('source');+ const orphanMtime = statSync(indexPathAt('source')).mtimeMs;++ renameSync(join(contentDir, 'source', 'only.md'), join(contentDir, 'destination', 'only.md'));++ await waitForIndexAt(+ 'destination',+ (md) => md.includes('./only.md') && md.includes('./anchor.md'),+ );+ await waitForIndex(+ (md) => !md.includes('./source/index.md') && md.includes('./destination/index.md'),+ );+ expect(readIndexAt('source')).toBe(orphanBytes);+ expect(statSync(indexPathAt('source')).mtimeMs).toBe(orphanMtime);+ });++ test('a rebuild lands on the ok-generator ref, not a human or service writer', async () => {+ await bootServer();+ writeDoc('note.md', 'A note', 'note', 'Something to index.');+ await waitForIndex((md) => md.includes('A note'));++ const sg = shadowGit(shadowHandle);+ await vi.waitFor(+ async () => {+ const out = (await sg.raw('for-each-ref', '--format=%(refname)', 'refs/wip/')).trim();+ // The whole point of the writer: generated bytes carry their own+ // authorship instead of riding on whichever writer happens to drain.+ expect(out).toContain('ok-generator');+ },+ { timeout: 20_000, interval: 100 },+ );+ });++ test('logs one bounded written outcome for every attempted boot decision', async () => {+ const logCapture = captureAllLoggers();+ writeDoc('concepts/first.md', 'First', 'concept');++ await bootServer();++ const events = logCapture+ .getCalls()+ .filter((entry) => entry.payload.event === 'generated-index-regeneration');+ expect(events.map((entry) => entry.payload)).toEqual([+ { event: 'generated-index-regeneration', outcome: 'written', directory: 'concepts' },+ { event: 'generated-index-regeneration', outcome: 'written', directory: '' },+ ]);+ });++ test('a rebuild that computes identical bytes performs no write', async () => {+ const logCapture = captureAllLoggers();+ // The byte-compare fixed point. Writing the index mutates the file index and+ // signals `files`, so a generator that wrote unconditionally would keep a+ // tracked file permanently dirty in `git status` — and, if a future trigger+ // ever fires on its own write, spin.+ //+ // The probe is a RESERVED file: creating `log.md` is a real watcher create,+ // so a rebuild genuinely runs — but `log` is never an entry, so the bytes it+ // computes are identical to what is already on disk. Exactly the case the+ // compare exists to absorb.+ await bootServer();+ writeDoc('note.md', 'A note', 'note', 'A description.');+ await waitForIndex((md) => md.includes('A note'));+ const regenerationEvents = () =>+ logCapture+ .getCalls()+ .filter((entry) => entry.payload.event === 'generated-index-regeneration');+ const baselineEventCount = regenerationEvents().length;++ const settled = statSync(indexPath()).mtimeMs;+ const bytes = readIndex();++ writeFileSync(join(contentDir, 'log.md'), '# Log\n\n## 2026-08-05\n\n- An entry.\n', 'utf-8');++ await vi.waitFor(+ () => {+ expect(+ regenerationEvents()+ .slice(baselineEventCount)+ .map((entry) => entry.payload),+ ).toEqual([{ event: 'generated-index-regeneration', outcome: 'unchanged', directory: '' }]);+ },+ { timeout: 20_000, interval: 50 },+ );++ // The rebuild ran and decided to do nothing — the file is untouched, not+ // merely unchanged in content.+ expect(readIndex()).toBe(bytes);+ expect(statSync(indexPath()).mtimeMs).toBe(settled);+ });++ test('an unopened tracked index conflict preserves exact bytes until resolution', async () => {+ writeDoc('concepts/first.md', 'First', 'concept');+ const conflicted = [+ '<<<<<<< HEAD',+ '# Mine',+ '=======',+ '# Theirs',+ '>>>>>>> incoming',+ '',+ ].join('\n');+ writeFileSync(indexPathAt('concepts'), conflicted, 'utf-8');+ mkdirSync(join(projectDir, '.ok', LOCAL_DIR), { recursive: true });+ writeFileSync(+ join(projectDir, '.ok', LOCAL_DIR, 'conflicts.json'),+ JSON.stringify({+ version: 1,+ branch: 'main',+ conflicts: [+ {+ file: 'content/concepts/index.md',+ detectedAt: '2026-08-07T00:00:00.000Z',+ },+ ],+ }),+ 'utf-8',+ );+ const conflictedMtime = statSync(indexPathAt('concepts')).mtimeMs;++ const logCapture = captureAllLoggers();+ await bootServer();+ expect(server?.hocuspocus.documents.has('concepts/index')).toBe(false);+ expect(server?.syncEngine?.getConflicts()).toEqual([+ expect.objectContaining({ file: 'content/concepts/index.md' }),+ ]);++ writeFileSync(+ join(contentDir, 'concepts', 'log.md'),+ '# Log\n\n## 2026-08-06\n\n- Trigger regeneration.\n',+ 'utf-8',+ );++ await vi.waitFor(+ () => {+ expect(+ logCapture+ .getCalls('warn', 'generated index regeneration blocked by active conflict')+ .some((entry) => entry.payload.directory === 'concepts'),+ ).toBe(true);+ },+ { timeout: 20_000, interval: 50 },+ );+ expect(readIndexAt('concepts')).toBe(conflicted);+ expect(statSync(indexPathAt('concepts')).mtimeMs).toBe(conflictedMtime);++ await server?.syncEngine?.reconcileConflictsFromGit();+ expect(server?.syncEngine?.getConflicts()).toEqual([]);+ writeDoc('concepts/second.md', 'Second', 'concept');+ await waitForIndexAt(+ 'concepts',+ (md) => md.includes('* [First](./first.md)') && md.includes('* [Second](./second.md)'),+ );+ expect(readIndexAt('concepts')).not.toMatch(/^(<<<<<<<|=======|>>>>>>>)/m);+ });++ test('a live index conflict blocks regeneration until the conflict is resolved', async () => {+ const logCapture = captureAllLoggers();+ await bootServer();+ writeDoc('concepts/first.md', 'First', 'concept');+ await waitForIndexAt('concepts', (md) => md.includes('* [First](./first.md)'));+ await waitForIndex((md) => md.includes('* [concepts](./concepts/index.md)'));++ const canonical = readIndexAt('concepts');+ const connection = await server?.hocuspocus.openDirectConnection('concepts/index');+ const document = server?.hocuspocus.documents.get('concepts/index');+ expect(document).toBeDefined();+ expect(document?.getText('source').toString()).toBe(canonical);++ const conflicted = [+ '<<<<<<< HEAD',+ canonical.trimEnd(),+ '=======',+ canonical.replace('[First]', '[Conflicted first]').trimEnd(),+ '>>>>>>> incoming',+ '',+ ].join('\n');+ writeFileSync(indexPathAt('concepts'), conflicted, 'utf-8');++ await vi.waitFor(+ () => {+ expect(document?.getMap('lifecycle').get('status')).toBe('conflict');+ expect(document?.getMap('lifecycle').get('reason')).toBe('conflict-markers');+ },+ { timeout: 20_000, interval: 50 },+ );++ const regenerationEvents = () =>+ logCapture+ .getCalls()+ .filter((entry) => entry.payload.event === 'generated-index-regeneration');+ const baselineEventCount = regenerationEvents().length;+ writeDoc('concepts/second.md', 'Second', 'concept');++ await vi.waitFor(+ () => {+ expect(regenerationEvents().slice(baselineEventCount)).toEqual([+ {+ level: 'warn',+ msg: '[index] generated index regeneration blocked by active conflict',+ payload: {+ event: 'generated-index-regeneration',+ outcome: 'blocked',+ directory: 'concepts',+ reason: 'conflict',+ },+ },+ {+ level: 'info',+ msg: '[index] generated index regeneration completed',+ payload: {+ event: 'generated-index-regeneration',+ outcome: 'unchanged',+ directory: '',+ },+ },+ ]);+ },+ { timeout: 20_000, interval: 50 },+ );++ expect(readIndexAt('concepts')).toBe(conflicted);+ expect(document?.getText('source').toString()).toBe(canonical);+ expect(document?.getMap('lifecycle').get('status')).toBe('conflict');+ expect(document?.getMap('lifecycle').get('reason')).toBe('conflict-markers');++ writeFileSync(indexPathAt('concepts'), canonical, 'utf-8');+ await vi.waitFor(+ () => {+ expect(document?.getMap('lifecycle').get('status')).toBeUndefined();+ expect(document?.getMap('lifecycle').get('reason')).toBeUndefined();+ },+ { timeout: 20_000, interval: 50 },+ );++ writeDoc('concepts/third.md', 'Third', 'concept');+ await waitForIndexAt(+ 'concepts',+ (md) => md.includes('./second.md') && md.includes('./third.md'),+ );+ expect(readIndexAt('concepts')).not.toMatch(/^(<<<<<<<|=======|>>>>>>>)/m);++ await connection?.disconnect();+ });++ test('a rebuild reaches an open document THROUGH the CRDT, not behind its back', async () => {+ const logCapture = captureAllLoggers();+ // The least-exercised path in the feature, and the one hardest to pin+ // honestly: asserting only that the open document converges passes even+ // when the CRDT branch is dead, because the disk write plus the watcher+ // round-trip gets there too. That green would be a false pass — the+ // dangerous code never ran.+ //+ // So assert the ORIGIN of the update that moved the document. Only the+ // paired CRDT write carries `generated-index`; bytes arriving by way of the+ // watcher carry the file-watcher's origin instead.+ await bootServer();+ writeDoc('first.md', 'First', 'note');+ await waitForIndex((md) => md.includes('./first.md'));++ const conn = await server?.hocuspocus.openDirectConnection('index');+ const doc = server?.hocuspocus.documents.get('index');+ expect(doc).toBeDefined();++ const origins: unknown[] = [];+ doc?.on('update', (_update: Uint8Array, origin: unknown) => origins.push(origin));+ const regenerationEvents = () =>+ logCapture+ .getCalls()+ .filter((entry) => entry.payload.event === 'generated-index-regeneration');+ const baselineEventCount = regenerationEvents().length;++ writeDoc('second.md', 'Second', 'note');++ // The open editor's view converged — the outcome the branch exists for.+ await vi.waitFor(+ () => {+ const live = doc?.getText('source').toString() ?? '';+ expect(live).toContain('./second.md');+ expect(live).toContain('./first.md');+ },+ { timeout: 20_000, interval: 50 },+ );++ // …and it converged by the intended route.+ const viaGenerator = origins.some(+ (o) =>+ typeof o === 'object' &&+ o !== null &&+ (o as { context?: { origin?: string } }).context?.origin === 'generated-index',+ );+ expect(viaGenerator).toBe(true);+ expect(+ regenerationEvents()+ .slice(baselineEventCount)+ .map((entry) => entry.payload),+ ).toEqual([{ event: 'generated-index-regeneration', outcome: 'written', directory: '' }]);++ await conn?.disconnect();+ });++ test('a document edit rebuilds only its own folder index, not a sibling', async () => {+ await bootServer();+ writeDoc('alpha/a.md', 'A one', 'note');+ writeDoc('beta/b.md', 'B one', 'note');+ await waitForIndexAt('alpha', (md) => md.includes('[A one]'));+ await waitForIndexAt('beta', (md) => md.includes('[B one]'));++ const betaBefore = readIndexAt('beta');+ const betaMtimeBefore = statSync(indexPathAt('beta')).mtimeMs;++ // Retitle the alpha document — an index-visible change scoped to alpha.+ writeDoc('alpha/a.md', 'A renamed', 'note');+ await waitForIndexAt('alpha', (md) => md.includes('[A renamed]') && !md.includes('[A one]'));++ // The sibling was never rewritten: same bytes, same file, untouched. This is+ // the "and no other" half — an edit's cost stays with its own directory.+ expect(readIndexAt('beta')).toBe(betaBefore);+ expect(statSync(indexPathAt('beta')).mtimeMs).toBe(betaMtimeBefore);+ });++ test('editing only body prose rebuilds no index', async () => {+ await bootServer();+ writeDoc('notes/n.md', 'A note', 'note', 'A description.');+ await waitForIndexAt('notes', (md) => md.includes('[A note]'));++ const before = readIndexAt('notes');+ const mtimeBefore = statSync(indexPathAt('notes')).mtimeMs;++ // Identical frontmatter and title; only the body below the heading changes,+ // so nothing the index renders has moved.+ writeFileSync(+ join(contentDir, 'notes', 'n.md'),+ '---\ntitle: A note\ntype: note\ndescription: A description.\n---\n\n# A note\n\nRewritten prose.\n',+ 'utf-8',+ );++ // Long enough to clear the 500 ms regeneration debounce several times over.+ await new Promise((r) => setTimeout(r, 3_000));++ expect(readIndexAt('notes')).toBe(before);+ expect(statSync(indexPathAt('notes')).mtimeMs).toBe(mtimeBefore);+ });++ test('an agent write through the API that changes a field rebuilds its folder index', async () => {+ await bootServer();+ writeDoc('notes/n.md', 'Before', 'note', 'A description.');+ await waitForIndexAt('notes', (md) => md.includes('[Before]'));+ const api = await apiBaseUrl();++ // Retitle through the agent write seam. `replace` with new frontmatter+ // supersedes the old, so a field the index renders genuinely moves — the+ // seam must schedule the rebuild rather than treating the write like prose.+ await agentWriteMd(+ api,+ 'notes/n',+ '---\ntitle: After\ntype: note\ndescription: A description.\n---\n\n# After\n',+ );++ await waitForIndexAt('notes', (md) => md.includes('[After]') && !md.includes('[Before]'));+ });++ test('an agent write through the API that changes only body prose rebuilds no index', async () => {+ await bootServer();+ writeDoc('notes/n.md', 'A note', 'note', 'A description.');+ await waitForIndexAt('notes', (md) => md.includes('[A note]'));+ const api = await apiBaseUrl();++ const before = readIndexAt('notes');+ const mtimeBefore = statSync(indexPathAt('notes')).mtimeMs;++ // Identical frontmatter and title, only the body below the heading changes —+ // the API counterpart of the disk-path prose test above. The field predicate+ // gates this seam too, so a prose-only write schedules no rebuild.+ await agentWriteMd(+ api,+ 'notes/n',+ '---\ntitle: A note\ntype: note\ndescription: A description.\n---\n\n# A note\n\nRewritten prose.\n',+ );++ // Long enough to clear the 500 ms regeneration debounce several times over.+ await new Promise((r) => setTimeout(r, 3_000));++ expect(readIndexAt('notes')).toBe(before);+ expect(statSync(indexPathAt('notes')).mtimeMs).toBe(mtimeBefore);+ });++ test('deleting a populated subdirectory drops it from its parent index', async () => {+ await bootServer();+ writeDoc('area/top.md', 'Top', 'note');+ writeDoc('area/sub/deep.md', 'Deep', 'note');+ // The parent carries both its own document and a link to the subdirectory.+ await waitForIndexAt('area', (md) => md.includes('* [sub](./sub/index.md)'));+ expect(readIndexAt('area')).toContain('./top.md');++ rmSync(join(contentDir, 'area', 'sub'), { recursive: true, force: true });++ // The parent drops the subdirectory link. Reaching `area` at all depends on+ // the folder-delete invalidating the ancestor chain; the per-document delete+ // alone would only schedule the now-empty `area/sub`.+ await waitForIndexAt('area', (md) => !md.includes('./sub/index.md'));+ // …while keeping its own document — a rebuild, not a truncation.+ expect(readIndexAt('area')).toContain('./top.md');+ });++ test('deleting a directory last admitted document preserves its orphan index', async () => {+ writeDoc('area/only.md', 'Only', 'note');+ await bootServer();+ await server?.generatedIndexSweepReady;+ await waitForIndexAt('area', (md) => md.includes('./only.md'));+ await waitForIndex((md) => md.includes('* [area](./area/index.md)'));++ const orphanBytes = readIndexAt('area');+ const orphanMtime = statSync(indexPathAt('area')).mtimeMs;++ unlinkSync(join(contentDir, 'area', 'only.md'));++ await waitForIndex((md) => !md.includes('./area/index.md'));+ expect(readIndexAt('area')).toBe(orphanBytes);+ expect(statSync(indexPathAt('area')).mtimeMs).toBe(orphanMtime);+ });++ test('a burst across two folders settles both in one convergence', async () => {+ await bootServer();+ // Three writes across two directories with no await between them, so they+ // land inside one debounce window.+ writeDoc('one/a.md', 'A', 'note');+ writeDoc('one/b.md', 'B', 'note');+ writeDoc('two/c.md', 'C', 'note');++ // Both edits to `one` coalesce into its single index rather than racing.+ await waitForIndexAt('one', (md) => md.includes('[A]') && md.includes('[B]'));+ await waitForIndexAt('two', (md) => md.includes('[C]'));+ // The root links both folders it grew (written last, deepest-first).+ await waitForIndex((md) => md.includes('./one/index.md') && md.includes('./two/index.md'));+ });++ test('enabling generation sweeps nested folders, not only the root', async () => {+ writeFileSync(+ join(projectDir, '.ok', 'config.yml'),+ stringifyYaml({ contentRules: { okf: { enabled: true, generate: { index: false } } } }),+ 'utf-8',+ );+ writeDoc('deep/leaf.md', 'Leaf', 'note');+ await bootServer();+ expect(existsSync(indexPath())).toBe(false);+ expect(existsSync(indexPathAt('deep'))).toBe(false);++ const baseUrl = await apiBaseUrl();+ const enabled = await fetch(`${baseUrl}/api/generated-index/settings`, {+ method: 'POST',+ headers: { 'content-type': 'application/json' },+ body: JSON.stringify({ enabled: true }),+ });+ expect(enabled.status).toBe(200);+ await expect(enabled.json()).resolves.toMatchObject({+ enabled: true,+ active: true,+ applied: true,+ });++ // A lifecycle enable carries no directory, so the whole tree is swept: the+ // nested index appears, and the root links it (written last, deepest-first).+ await waitForIndexAt('deep', (md) => md.includes('[Leaf]'));+ await waitForIndex((md) => md.includes('./deep/index.md'));+ });++ test("a document in a pre-existing folder reaches the folder's parent index", async () => {+ // The folder is on disk before boot, so its first document fires no+ // folder-create — only the document event, which schedules just the folder's+ // own index, not its parent chain. So the parent learns of the folder solely+ // because writing the new child index re-schedules the parent. Remove that+ // re-schedule and the parent stays stale forever: the child index's own write+ // event is refused by the self-trigger guard, so nothing else re-teaches it.+ mkdirSync(join(contentDir, 'concepts'), { recursive: true });+ writeDoc('anchor.md', 'Anchor', 'note');+ await bootServer();++ // The root settles at boot listing the anchor and does not yet link the+ // still-empty folder.+ await waitForIndex((md) => md.includes('[Anchor]'));+ expect(readIndex()).not.toContain('./concepts/index.md');++ // The folder's first document. `writeDoc`'s mkdir is a no-op here, so no+ // folder-create rides along to carry the news to the parent.+ writeDoc('concepts/first.md', 'First', 'concept');++ // The folder's own index appears…+ await waitForIndexAt('concepts', (md) => md.includes('* [First](./first.md)'));+ // …and the parent links it, with no second edit and no restart.+ await waitForIndex((md) => md.includes('* [concepts](./concepts/index.md)'));++ // The walk terminates: once the parent settles it does not re-trigger the+ // child, so the child index is written once and then left untouched.+ const childMtime = statSync(indexPathAt('concepts')).mtimeMs;+ const rootMtime = statSync(indexPath()).mtimeMs;+ await new Promise((r) => setTimeout(r, 2_000));+ expect(statSync(indexPathAt('concepts')).mtimeMs).toBe(childMtime);+ expect(statSync(indexPath()).mtimeMs).toBe(rootMtime);+ });++ test('a cold boot converges a multi-depth tree in a single pass', async () => {+ // Markdown at three depths, plus a container whose only markdown lives in a+ // descendant — all present before the server exists. The helper waits for+ // the explicit boot-sweep settlement, so asserting immediately afterward+ // with no polling proves one pass suffices for the whole tree.+ writeDoc('root-note.md', 'Root note', 'note');+ writeDoc('topic/overview.md', 'Overview', 'concept');+ writeDoc('topic/deep/detail.md', 'Detail', 'concept');+ writeDoc('container/leaf/item.md', 'Item', 'note');++ const decisionOrder: string[] = [];+ const activeServer = await startServerWithIndexHooks({+ beforeDecision: ({ directory, fullSweep }) => {+ if (fullSweep) decisionOrder.push(directory);+ },+ });+ await activeServer.ready;+ await expect(activeServer.generatedIndexSweepReady).resolves.toEqual({+ status: 'completed',+ indexCount: 5,+ });+ expect(decisionOrder).toEqual(['container/leaf', 'topic/deep', 'container', 'topic', '']);++ // Every markdown-bearing directory has an index, including the container that+ // holds no document of its own.+ expect(existsSync(indexPath())).toBe(true);+ for (const dir of ['topic', 'topic/deep', 'container', 'container/leaf']) {+ expect(existsSync(indexPathAt(dir))).toBe(true);+ }++ // The root carries its own document and links each top-level subdirectory's+ // index — the child index document, never the documents nested inside it.+ const root = readIndex();+ expect(root).toContain('* [Root note](./root-note.md)');+ expect(root).toContain('* [container](./container/index.md)');+ expect(root).toContain('* [topic](./topic/index.md)');+ expect(root).not.toContain('./topic/overview.md');++ // A mid-level directory links its deeper child index. A top-down sweep would+ // have written this parent before that child index existed and needed a+ // second corrective pass to gain the link.+ const topic = readIndexAt('topic');+ expect(topic).toContain('* [Overview](./overview.md)');+ expect(topic).toContain('* [deep](./deep/index.md)');++ // The deepest directory carries its own document and no subdirectory section.+ const deep = readIndexAt('topic/deep');+ expect(deep).toContain('* [Detail](./detail.md)');+ expect(deep).not.toContain('## Subdirectories');++ // The container navigates purely by its subdirectory link — no empty type+ // section for a document it does not hold.+ const container = readIndexAt('container');+ expect(container).toContain('* [leaf](./leaf/index.md)');+ expect(container).not.toContain('## note');+ expect(readIndexAt('container/leaf')).toContain('* [Item](./item.md)');+ });++ test('a second boot over a converged tree rewrites no index', async () => {+ // The same multi-depth tree, converged by the first boot.+ writeDoc('root-note.md', 'Root note', 'note');+ writeDoc('topic/overview.md', 'Overview', 'concept');+ writeDoc('topic/deep/detail.md', 'Detail', 'concept');+ writeDoc('container/leaf/item.md', 'Item', 'note');+ await bootServer();++ // Snapshot every index's bytes and mtime once the first boot has settled.+ const indexed = ['', 'topic', 'topic/deep', 'container', 'container/leaf'];+ const snapshot = indexed.map((dir) => {+ const path = dir === '' ? indexPath() : indexPathAt(dir);+ return { path, bytes: readFileSync(path, 'utf-8'), mtime: statSync(path).mtimeMs };+ });++ // A second cold boot is a second full sweep over unchanged content. Boot runs+ // the sweep unconditionally, so it genuinely re-plans every index — and the+ // per-index byte comparison suppresses each write because the bytes on disk+ // already match. A sweep that oscillated would rewrite at least one file.+ await server?.destroy();+ await bootServer();++ for (const { path, bytes, mtime } of snapshot) {+ expect(readFileSync(path, 'utf-8')).toBe(bytes);+ expect(statSync(path).mtimeMs).toBe(mtime);+ }+ });+});diff --git a/packages/server/src/server-factory.ts b/packages/server/src/server-factory.tsindex 96d29bd57..3474cda14 100644--- a/packages/server/src/server-factory.ts+++ b/packages/server/src/server-factory.ts@@ -41,6 +41,7 @@ import {toEffectiveBase,} from '@inkeep/open-knowledge-core';import {+ atomicWriteFile,collectConfigDiagnostics,readConfigSafely,resolveConfigPath,@@ -58,7 +59,12 @@ import { AcpRegistry, loadCustomAgents } from './acp/registry.ts';import { AgentFocusBroadcaster } from './agent-focus.ts';import { AgentPresenceBroadcaster } from './agent-presence.ts';import { AgentSessionManager } from './agent-sessions.ts';-import { type CommentDocHooks, createApiExtension, isSafeDocName } from './api-extension.ts';+import {+ type CommentDocHooks,+ createApiExtension,+ type GeneratedIndexSettingsStatus,+ isSafeDocName,+} from './api-extension.ts';import { assetReferencesChanged } from './asset-references.ts';import { seedBasenameIndex, seedSingleDirBasenameIndex } from './asset-walk.ts';import {@@ -92,6 +98,23 @@ import {createConflictLifecycleSeedExtension,entryMatchesDocName,} from './conflict-lifecycle-seed.ts';+import { type GeneratedArtifactEnv, writeGeneratedArtifact } from './content/generated-artifact.ts';+import {+ type GeneratedIndexGitAttributesStatus,+ inspectGeneratedIndexGitAttributes,+ updateGeneratedIndexGitAttributes,+} from './content/generated-index-git-attributes.ts';+import {+ collectIndexDirectories,+ directoryChainToRoot,+ directoryOf,+ indexedFieldsChanged,+ indexedMetadataChanged,+ isGeneratedIndexDocName,+ type PreviousIndexedFields,+ planDirectoryIndexRegenerations,+ ROOT_INDEX_DOC_NAME,+} from './content/regenerate-index.ts';import { type ContentFilter, createContentFilter } from './content-filter.ts';import { isWithinContentDir, safeContentPath } from './content-path.ts';import { dropPendingDocs, recordContributor } from './contributor-tracker.ts';@@ -124,9 +147,11 @@ import {type DiskEvent,pathToDocName,reconcileFileIndexAfterFilterRebuild,+ registerWrite,startWatcher,type WatcherHandle,} from './file-watcher.ts';+import { normalizeFsPath, tracedAtomicFs, tracedMkdirSync } from './fs-traced.ts';import type {CheckPushPermissionOptions,DetectGhFn,@@ -148,6 +173,7 @@ import {isHostAdmitted,isPeerAdmitted,} from './ingress-policy.ts';+import { ensureOkfSchemaFiles } from './lint/write-okf-schemas.ts';import { createLiveDerivedIndexExtension } from './live-derived-index.ts';import { localTargetInventoryFromWatcher } from './local-target-inventory.ts';import { getLogger } from './logger.ts';@@ -211,6 +237,7 @@ import {commitUpstreamImport,destroyShadowRepo,initShadowRepo,+ OK_GENERATOR_WRITER,type ParkableDoc,parkBranch,readParkedState,@@ -423,8 +450,31 @@ export interface ServerOptions {* unmounted by the boot layer (`bootServer`), not here. Default `false`.*/ephemeral?: boolean;+ /** Internal deterministic test seam for generated-index lifecycle coverage. */+ generatedIndexTestHooks?: {+ beforePlan?: (context: { fullSweep: boolean; signal: AbortSignal }) => Promise<void> | void;+ beforeDecision?: (context: {+ directory: string;+ fullSweep: boolean;+ signal: AbortSignal;+ }) => Promise<void> | void;+ afterWrite?: (context: {+ docName: string;+ fullSweep: boolean;+ signal: AbortSignal;+ }) => Promise<void> | void;+ onKickWhileInFlight?: () => void;+ onIdle?: () => void;+ };}+type GeneratedIndexSweepResult =+ | { status: 'completed'; indexCount: number }+ | { status: 'disabled'; indexCount: number }+ | { status: 'blocked'; indexCount: number }+ | { status: 'failed'; indexCount: number }+ | { status: 'cancelled'; indexCount: number };+export interface ServerInstance {hocuspocus: Hocuspocus;sessionManager: AgentSessionManager;@@ -471,8 +521,10 @@ export interface ServerInstance {readonly serverInstanceId: string;readonly durabilityState: DocumentDurabilityState;destroy: () => Promise<void>;- /** Resolves when async init (shadow repo, file watcher subscription) is complete. */+ /** Resolves when async init (shadow repo and file watcher subscription) is complete. */ready: Promise<void>;+ /** Settles after the post-readiness boot sweep finishes or shutdown cancels it. */+ generatedIndexSweepReady: Promise<GeneratedIndexSweepResult>;/*** Names of subsystems that failed to initialize during boot.* Read AFTER `await ready` for a stable list; reads before may return a partial result.@@ -531,6 +583,26 @@ const PARK_SNAPSHOT_ORIGIN = (() => {}) satisfies PairedWriteOrigin;})();+/**+ * Origin for a generated artifact landing in a LOADED document.+ *+ * skipStoreHooks: false — the CRDT write is the only write on this path, so+ * persistence has to carry it to disk. The resulting flush calls back with the+ * artifact's own docName, which the scheduler refuses, so the store does not+ * re-enter generation.+ *+ * paired: true — `replaceRawBody` mutates Y.Text and the fragment in one+ * transact, which is the marker every paired origin must declare.+ */+const GENERATED_ARTIFACT_ORIGIN = (() => {+ const ctx = Object.freeze({ origin: 'generated-index', paired: true as const });+ return Object.freeze({+ source: 'local' as const,+ skipStoreHooks: false,+ context: ctx,+ }) satisfies PairedWriteOrigin;+})();+/*** Build the git `-c credential.helper=…` args that let SyncEngine's fetch/push* authenticate by shelling out to our own CLI's `auth git-credential` helper.@@ -805,7 +877,12 @@ export function createServer(options: ServerOptions): ServerInstance {// to an effective base (rules placeholder), which the resolver fills from the// native `.markdownlint.*` file.const persisted = project.value.contentRules as PersistedLinterConfig | undefined;- return persisted ? toEffectiveBase(persisted) : DEFAULT_LINTER_CONFIG;+ const base = persisted ? toEffectiveBase(persisted) : DEFAULT_LINTER_CONFIG;+ // The OKF plugin advertises its schemas by path, so the files have to exist by+ // the time anything reads a document — and only while their rules do. This is+ // the funnel that knows the plugin state, and it no-ops until that changes.+ ensureOkfSchemaFiles(projectDir, base.plugins.okf);+ return base;}// Same fresh-per-request contract as `readLinterBaseConfig`: the broken-link@@ -916,7 +993,10 @@ export function createServer(options: ServerOptions): ServerInstance {// re-apply: `SyncEngine.setMode` and `SemanticSearchService.applyConfig`// both early-return when the value is unchanged. A future non-idempotent// consumer added here would double-fire.- function applyPersistedConfigToConsumers(configDocName: string): void {+ function applyPersistedConfigToConsumers(+ configDocName: string,+ generatedIndexEnabledOverride?: boolean,+ ): void {let appliedAutoSyncMode: SyncMode | undefined;if (configDocName === CONFIG_DOC_NAME_PROJECT ||@@ -977,6 +1057,29 @@ export function createServer(options: ServerOptions): ServerInstance {);}cc1Broadcaster?.signal('lint-config');+ const generatedIndexEnabled =+ generatedIndexEnabledOverride ??+ readLinterBaseConfig().plugins.okf?.generate?.index === true;+ if (!generatedIndexEnabled) {+ void updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames: generatedIndexDocNamesForGitAttributes(),+ enabled: false,+ }).then((result) => {+ if (!result.ok) {+ log.warn(+ { state: result.status.state },+ '[index] could not remove Open Knowledge generated-index Git attributes',+ );+ }+ });+ }+ // Reconcile on every project-config persist. A config persist carries no+ // directory, so it sweeps the whole tree: the generator's fresh read makes+ // disable a no-op and makes false → true materialize immediately, and+ // duplicate producer/watcher notifications collapse in the debounce.+ scheduleFullIndexSweep();}log.info({@@ -1270,6 +1373,545 @@ export function createServer(options: ServerOptions): ServerInstance {cc1Broadcaster?.signal(channel);}+ // ─── Generated per-directory indexes ─────────────────────────────────────+ //+ // Trailing-edge debounce, longer than CC1's 100ms because the work ends in a+ // file write rather than a signal: a burst of edits across several documents+ // should produce one rebuild per affected directory, not one per document.+ const INDEX_REGENERATION_DEBOUNCE_MS = 500;+ let indexRegenerationTimer: NodeJS.Timeout | undefined;+ let indexRegenerationImmediate: NodeJS.Immediate | undefined;+ let indexRegenerationInFlight: Promise<void> | undefined;+ let indexRegenerationReady = false;+ let indexRegenerationClosed = false;+ const indexRegenerationAbort = new AbortController();+ // The directories whose index a settled burst must rebuild. A Set so repeated+ // edits to one directory collapse to a single rebuild; drained on each fire.+ const pendingIndexDirectories = new Set<string>();+ // A trigger that carries no directory — config-persist, boot — rebuilds every+ // directory. Kept apart from the set so an empty set never reads as a sweep.+ let pendingIndexFullSweep = false;+ let pendingBootIndexSweep = false;++ let generatedIndexSweepSettled = false;+ let generatedIndexBootSweepCount = 0;+ let resolveGeneratedIndexSweep!: (result: GeneratedIndexSweepResult) => void;+ const generatedIndexSweepReady = new Promise<GeneratedIndexSweepResult>((resolve) => {+ resolveGeneratedIndexSweep = resolve;+ });++ function settleGeneratedIndexSweep(result: GeneratedIndexSweepResult): void {+ if (generatedIndexSweepSettled) return;+ generatedIndexSweepSettled = true;+ resolveGeneratedIndexSweep(result);+ }++ type IndexRegenerationRequest =+ | { fullSweep: true }+ | { fullSweep: false; directories: ReadonlySet<string> };++ type IndexRegenerationPassResult =+ | GeneratedIndexSweepResult+ | { status: 'deferred'; indexCount: number };++ function hasPendingIndexRegeneration(): boolean {+ return pendingIndexFullSweep || pendingIndexDirectories.size > 0;+ }++ function armIndexRegeneration(): void {+ if (indexRegenerationClosed || !indexRegenerationReady) return;+ if (indexRegenerationTimer !== undefined) clearTimeout(indexRegenerationTimer);+ indexRegenerationTimer = setTimeout(() => {+ indexRegenerationTimer = undefined;+ kickIndexRegeneration();+ }, INDEX_REGENERATION_DEBOUNCE_MS);+ // A pending rebuild must not hold a test's process open; the index is+ // rebuilt on the next qualifying write anyway.+ indexRegenerationTimer.unref?.();+ }++ function deferBootIndexSweep(): void {+ if (indexRegenerationClosed) {+ settleGeneratedIndexSweep({ status: 'cancelled', indexCount: 0 });+ return;+ }+ pendingIndexFullSweep = true;+ pendingBootIndexSweep = true;+ indexRegenerationImmediate = setImmediate(() => {+ indexRegenerationImmediate = undefined;+ kickIndexRegeneration();+ });+ }++ function kickIndexRegeneration(): void {+ if (indexRegenerationClosed || !indexRegenerationReady || !hasPendingIndexRegeneration()) {+ return;+ }+ if (indexRegenerationInFlight !== undefined) {+ options.generatedIndexTestHooks?.onKickWhileInFlight?.();+ return;+ }+ if (durabilityState.isBatchInProgress()) {+ armIndexRegeneration();+ return;+ }++ // Snapshot and drain synchronously. Work scheduled while this pass awaits is+ // retained for one trailing-edge follow-up rather than overlapping it.+ const fullSweep = pendingIndexFullSweep;+ const directories = new Set(pendingIndexDirectories);+ const includesBootSweep = pendingBootIndexSweep;+ pendingIndexFullSweep = false;+ pendingIndexDirectories.clear();+ pendingBootIndexSweep = false;+ const request: IndexRegenerationRequest = fullSweep+ ? { fullSweep: true }+ : { fullSweep: false, directories };++ indexRegenerationInFlight = (async () => {+ const result = await regenerateIndexes(request, indexRegenerationAbort.signal);+ if (result.status === 'deferred') {+ // A branch batch began after this pass was admitted. A full sweep after+ // settlement is the conservative repair for any partial work.+ pendingIndexFullSweep = true;+ if (includesBootSweep) {+ generatedIndexBootSweepCount += result.indexCount;+ pendingBootIndexSweep = true;+ }+ return;+ }+ if (includesBootSweep) {+ generatedIndexBootSweepCount += result.indexCount;+ if (result.status === 'completed' && hasPendingIndexRegeneration()) {+ // Live work that arrived while boot was sweeping is part of the same+ // readiness boundary. Carry the boot token into the coalesced pass so+ // callers never observe a stale index immediately after readiness.+ pendingBootIndexSweep = true;+ } else {+ settleGeneratedIndexSweep({ ...result, indexCount: generatedIndexBootSweepCount });+ }+ }+ })()+ .catch((err: unknown) => {+ log.warn({ err }, '[index] index regeneration coordinator failed');+ if (includesBootSweep) settleGeneratedIndexSweep({ status: 'failed', indexCount: 0 });+ })+ .finally(() => {+ indexRegenerationInFlight = undefined;+ if (indexRegenerationClosed) {+ if (includesBootSweep) {+ settleGeneratedIndexSweep({ status: 'cancelled', indexCount: 0 });+ }+ return;+ }+ if (hasPendingIndexRegeneration() && indexRegenerationTimer === undefined) {+ armIndexRegeneration();+ } else if (!hasPendingIndexRegeneration() && indexRegenerationTimer === undefined) {+ options.generatedIndexTestHooks?.onIdle?.();+ }+ });+ }++ async function closeIndexRegeneration(): Promise<void> {+ if (!indexRegenerationClosed) {+ const inFlight = indexRegenerationInFlight;+ indexRegenerationClosed = true;+ indexRegenerationAbort.abort();+ if (indexRegenerationTimer !== undefined) {+ clearTimeout(indexRegenerationTimer);+ indexRegenerationTimer = undefined;+ }+ if (indexRegenerationImmediate !== undefined) {+ clearImmediate(indexRegenerationImmediate);+ indexRegenerationImmediate = undefined;+ }+ pendingIndexDirectories.clear();+ pendingIndexFullSweep = false;+ pendingBootIndexSweep = false;+ // An in-flight boot sweep owns its visited count. Let its cooperative+ // cancellation settle the public promise after the current atomic write+ // drains; only a queued/not-yet-started sweep has visited zero indexes.+ if (inFlight === undefined) {+ settleGeneratedIndexSweep({ status: 'cancelled', indexCount: 0 });+ }+ }+ await indexRegenerationInFlight;+ }++ /**+ * Ask for a rebuild of the index that owns `docName` — the directory the+ * document lives in.+ *+ * A generated index at any depth is refused here, not scheduled. Suppressing+ * the watcher's echo of the write is not enough: a resident index reaches disk+ * through the persistence flush, whose completion hook calls this scheduler+ * directly, so an index that accepted its own write would schedule itself+ * forever. Matching only the root name would let each generated child slip+ * through. The per-directory byte comparison is the second layer, so a miss+ * here settles after one pass instead of spinning.+ */+ function scheduleIndexRegeneration(docName: string): void {+ if (indexRegenerationClosed || isGeneratedIndexDocName(docName)) return;+ pendingIndexDirectories.add(directoryOf(docName));+ armIndexRegeneration();+ }++ /**+ * A folder was created or deleted: rebuild its parent chain. A child's+ * existence flows into every ancestor index above it, so the whole chain up to+ * the root can move. Ancestors without an index of their own produce no+ * decision and drop out at the byte comparison.+ */+ function scheduleSubdirectoryIndexRegeneration(directory: string): void {+ if (indexRegenerationClosed) return;+ for (const ancestor of directoryChainToRoot(directory)) {+ pendingIndexDirectories.add(ancestor);+ }+ armIndexRegeneration();+ }++ /**+ * Reconcile the navigation edge above a document that just left its old path.+ * If other admitted markdown still keeps that directory in the desired set,+ * only its own index changes. If the directory just fell out of the set, its+ * index is deliberately preserved as an orphan and the parent chain rebuilds+ * to stop linking to it.+ */+ function scheduleIndexRegenerationAfterRemoval(docName: string): void {+ const fileIndex = watcher?.getFileIndex();+ if (!fileIndex) {+ scheduleIndexRegeneration(docName);+ return;+ }++ const sourceDirectory = directoryOf(docName);+ const desiredDirectories = collectIndexDirectories(fileIndex.keys());+ if (desiredDirectories.has(sourceDirectory)) {+ scheduleIndexRegeneration(docName);+ return;+ }++ scheduleSubdirectoryIndexRegeneration(directoryOf(sourceDirectory));+ }++ /**+ * A trigger with no directory in hand — a config-persist that may have flipped+ * the setting on, or boot against an unindexed tree — rebuilds every directory+ * rather than guessing a target.+ */+ function scheduleFullIndexSweep(): void {+ if (indexRegenerationClosed) return;+ pendingIndexFullSweep = true;+ armIndexRegeneration();+ }++ /**+ * The rendered index fields the file index currently caches for a document,+ * or undefined when it holds no markdown entry. Read at the API mutation seam+ * before that seam overwrites the entry, so an update there can compare the+ * old fields against the new bytes and skip the rebuild when none moved.+ */+ function currentIndexedFields(docName: string): PreviousIndexedFields | undefined {+ const entry = watcher?.getFileIndex().get(docName);+ if (!entry) return undefined;+ return { title: entry.title, description: entry.description, type: entry.type };+ }++ /**+ * The collaborators every generated artifact writes through. Assembled once;+ * the dispatch itself lives in `content/generated-artifact.ts`, where it is+ * testable without a booted server.+ */+ let generatedAttributionPending = false;+ const generatedArtifactEnv: GeneratedArtifactEnv = {+ origin: GENERATED_ARTIFACT_ORIGIN,+ writer: OK_GENERATOR_WRITER,+ isConflict: (docName) =>+ syncEngine+ ?.getConflicts()+ .some((entry) => entryMatchesDocName(entry, docName, projectDir, contentDir)) === true,+ getDocument: (docName) => hocuspocus.documents.get(docName),+ writeDisk: async (absPath, markdown) => {+ tracedMkdirSync(dirname(absPath), { recursive: true });+ await atomicWriteFile(absPath, markdown, { fs: tracedAtomicFs });+ },+ registerWrite: (absPath, markdown) => registerWrite(absPath, contentHash(markdown)),+ noteFileIndex: (event) =>+ watcher?.mutateFileIndex({+ kind: event.kind,+ path: event.absPath,+ docName: event.docName,+ content: event.markdown,+ }),+ signalFiles: () => signalChannel('files'),+ attribute: async (docName, writer) => {+ recordContributor(docName, writer.id, writer.name, writer.id);+ generatedAttributionPending = true;+ },+ };++ /** The docName of the index that lives in `directory` ('' for the root). */+ function indexDocNameFor(directory: string): string {+ return directory === '' ? ROOT_INDEX_DOC_NAME : `${directory}/${ROOT_INDEX_DOC_NAME}`;+ }++ function generatedIndexDocNamesForGitAttributes(): string[] {+ const directories = watcher+ ? collectIndexDirectories(watcher.getFileIndex().keys())+ : new Set<string>(['']);+ return [...directories].map(indexDocNameFor);+ }++ function toGeneratedIndexSettingsStatus(+ git: GeneratedIndexGitAttributesStatus,+ ): GeneratedIndexSettingsStatus {+ const enabled = readLinterBaseConfig().plugins.okf?.generate?.index === true;+ const admitted = git.state === 'ready' || git.state === 'not-applicable';+ return {+ enabled,+ active: enabled && admitted,+ git:+ git.state === 'ready'+ ? { state: git.state, ownership: git.ownership }+ : { state: git.state },+ };+ }++ function getGeneratedIndexSettingsStatus(): GeneratedIndexSettingsStatus {+ return toGeneratedIndexSettingsStatus(+ inspectGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames: generatedIndexDocNamesForGitAttributes(),+ }),+ );+ }++ async function setGeneratedIndexEnabled(enabled: boolean): Promise<GeneratedIndexSettingsStatus> {+ const attributes = await updateGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames: generatedIndexDocNamesForGitAttributes(),+ enabled,+ });+ if (!attributes.ok) {+ return {+ ...getGeneratedIndexSettingsStatus(),+ applied: false,+ reason: attributes.status.state === 'conflict' ? 'git-conflict' : 'git-unavailable',+ };+ }++ const configResult = await writeConfigPatch({+ cwd: projectDir,+ scope: 'project',+ patch: { contentRules: { okf: { generate: { index: enabled } } } },+ });+ if (!configResult.ok) {+ try {+ await attributes.rollback();+ } catch (err) {+ log.error({ err }, '[index] could not roll back generated-index Git attributes');+ }+ return { ...getGeneratedIndexSettingsStatus(), applied: false, reason: 'config-write' };+ }++ try {+ const content = readFileSync(configResult.path, 'utf-8');+ applyExternalConfigChange(+ hocuspocus.documents.get(CONFIG_DOC_NAME_PROJECT) ?? null,+ CONFIG_DOC_NAME_PROJECT,+ content,+ persistence.configPersistenceCtx,+ );+ } catch (err) {+ // The durable config and attribute already agree. The config watcher is+ // the recovery path for this in-memory reflection, so do not roll either+ // durable write back after the operation has committed.+ log.warn({ err }, '[index] generated-index settings reflection deferred to config watcher');+ }+ applyPersistedConfigToConsumers(CONFIG_DOC_NAME_PROJECT, enabled);+ return { ...getGeneratedIndexSettingsStatus(), applied: true };+ }++ /**+ * Rebuild the generated indexes a settled burst asked for.+ *+ * A full sweep rebuilds every directory; otherwise only the directories the+ * request names. The plan is computed over the whole document set either way —+ * a directory's index links its in-set children, so the full set is what makes+ * one pass internally consistent — and only the requested indexes are written.+ * Decisions arrive deepest-first, so a child index lands before the parent that+ * links it.+ *+ * Current bytes are read here, at the write, not fed to the planner: the write+ * layer does its own byte comparison, so the planner's `changed` flag would+ * only add a redundant disk read for every directory in the set, including ones+ * this request will not write.+ *+ * Failure is never fatal. A knowledge base whose index is one rebuild stale+ * still works; a server that fell over because it could not write a navigation+ * file does not.+ */+ async function regenerateIndexes(+ request: IndexRegenerationRequest,+ signal: AbortSignal,+ ): Promise<IndexRegenerationPassResult> {+ let generatedIndexCount = 0;+ const sweepStartedAt = request.fullSweep ? performance.now() : undefined;+ const generationIsDisabled = () => readLinterBaseConfig().plugins.okf?.generate?.index !== true;+ try {+ if (signal.aborted) return { status: 'cancelled', indexCount: 0 };+ if (generationIsDisabled()) {+ return { status: 'disabled', indexCount: 0 };+ }++ const fileIndex = watcher?.getFileIndex();+ if (!fileIndex) return { status: 'failed', indexCount: 0 };++ try {+ await options.generatedIndexTestHooks?.beforePlan?.({+ fullSweep: request.fullSweep,+ signal,+ });+ if (signal.aborted) return { status: 'cancelled', indexCount: generatedIndexCount };+ if (generationIsDisabled()) {+ return { status: 'disabled', indexCount: generatedIndexCount };+ }+ if (durabilityState.isBatchInProgress()) {+ return { status: 'deferred', indexCount: generatedIndexCount };+ }+ const decisions = planDirectoryIndexRegenerations({+ docs: fileIndex,+ docExtension: getDocExtension,+ currentMarkdownFor: () => null,+ });+ const gitAttributes = inspectGeneratedIndexGitAttributes({+ projectDir,+ contentDir,+ generatedDocNames: decisions.map(({ directory }) => indexDocNameFor(directory)),+ });+ if (gitAttributes.state !== 'ready' && gitAttributes.state !== 'not-applicable') {+ log.warn(+ { state: gitAttributes.state },+ '[index] generated index regeneration paused by Git attributes',+ );+ return { status: 'blocked', indexCount: generatedIndexCount };+ }++ for (const { directory, markdown } of decisions) {+ if (!request.fullSweep && !request.directories.has(directory)) continue;+ if (signal.aborted) {+ return { status: 'cancelled', indexCount: generatedIndexCount };+ }+ if (generationIsDisabled()) {+ return { status: 'disabled', indexCount: generatedIndexCount };+ }+ if (durabilityState.isBatchInProgress()) {+ return { status: 'deferred', indexCount: generatedIndexCount };+ }++ await options.generatedIndexTestHooks?.beforeDecision?.({+ directory,+ fullSweep: request.fullSweep,+ signal,+ });+ if (signal.aborted) {+ return { status: 'cancelled', indexCount: generatedIndexCount };+ }+ if (generationIsDisabled()) {+ return { status: 'disabled', indexCount: generatedIndexCount };+ }++ const docName = indexDocNameFor(directory);+ const absPath = resolve(contentDir, `${docName}.md`);+ let currentMarkdown: string | null;+ try {+ currentMarkdown = readFileSync(absPath, 'utf-8');+ } catch (error) {+ // A missing index is the ordinary first-run case. Anything else+ // (permissions, a directory in the way, I/O) also reads as absent+ // here, which would overwrite a file we simply could not read — so+ // say so rather than letting it pass as "not there yet".+ if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {+ log.warn(+ { err: error, path: normalizeFsPath(absPath) },+ '[index] could not read the existing generated index; treating it as absent',+ );+ }+ currentMarkdown = null;+ }++ generatedIndexCount += 1;+ const outcome = await writeGeneratedArtifact(+ { docName, absPath, markdown, currentMarkdown },+ generatedArtifactEnv,+ );+ if (outcome === 'blocked-conflict') {+ log.warn(+ {+ event: 'generated-index-regeneration',+ outcome: 'blocked',+ directory,+ reason: 'conflict',+ },+ '[index] generated index regeneration blocked by active conflict',+ );+ } else {+ log.info(+ {+ event: 'generated-index-regeneration',+ outcome: outcome === 'unchanged' ? 'unchanged' : 'written',+ directory,+ },+ '[index] generated index regeneration completed',+ );+ }+ await options.generatedIndexTestHooks?.afterWrite?.({+ docName,+ fullSweep: request.fullSweep,+ signal,+ });++ // A child index that had no file until this write means a directory just+ // entered the tree, so the parent that should now link it must rebuild.+ // The parent will not rebuild on its own: the document-event guard+ // refuses an index's own write, so nothing else re-teaches it. This is+ // the deliberate, narrow exception to that guard, kept bounded two ways —+ // it fires only on a child index's first appearance (no prior file) and+ // only outside a full sweep, which already builds every parent in the+ // same pass — and it terminates, because the parent's own byte comparison+ // stops the walk once nothing further changes.+ if (!request.fullSweep && directory !== '' && currentMarkdown === null) {+ scheduleSubdirectoryIndexRegeneration(directoryOf(directory));+ }+ }+ } finally {+ if (generatedAttributionPending) {+ // Generated disk writes have no store hook to schedule attribution.+ // Flush once per single-flight pass so every landed artifact is durable+ // without paying one serialized shadow commit per directory. Waiting+ // first matters: flushContributors joins an existing commit but does+ // not itself drain contributors recorded after that commit started.+ await persistence.waitForPendingCommits();+ await persistence.flushContributors();+ generatedAttributionPending = false;+ }+ if (sweepStartedAt !== undefined) {+ recordBootPhase(+ 'generatedIndexSweepMs',+ Math.round((performance.now() - sweepStartedAt) * 100) / 100,+ );+ setBootField('generatedIndexCount', generatedIndexCount);+ }+ }+ return { status: 'completed', indexCount: generatedIndexCount };+ } catch (err) {+ log.warn({ err }, '[index] index regeneration failed');+ return { status: 'failed', indexCount: generatedIndexCount };+ }+ }+// LRU cache of docNames renamed away or deleted, durable across restarts// via the removal journal at `.ok/local/removed-docs.json`. Read by// `removalRedirectGuard` (registered below) to reject WebSocket@@ -1551,6 +2193,12 @@ export function createServer(options: ServerOptions): ServerInstance {onDiskFlush: (docName, sv, persistedMarkdown, previousMarkdown) => {cc1Broadcaster?.emitDiskAck(docName, sv);if (isReservedForUserTree(docName)) return;+ // Before the asset check, which returns early: a title or description+ // edit changes no asset reference, so anything downstream of that+ // return never sees the writes this feature exists for.+ if (indexedFieldsChanged(previousMarkdown, persistedMarkdown, docName)) {+ scheduleIndexRegeneration(docName);+ }if (!assetReferencesChanged(previousMarkdown, persistedMarkdown)) return;invalidateReferencedAssetsCache?.();signalChannel('files');@@ -2098,13 +2746,60 @@ export function createServer(options: ServerOptions): ServerInstance {sessionManager,commentDocHooksRef,contentDir,+ getGeneratedIndexSettingsStatus,+ setGeneratedIndexEnabled,contentFilter,serverInstanceId,getFileIndex: () => (watcher ? watcher.getFileIndex() : new Map()),getAttachmentFolderPath: readProjectAttachmentFolderPath,getAllFilesIndex: () => (watcher ? watcher.getAllFilesIndex() : new Map()),getFileIndexGeneration: () => watcher?.getFileIndexGeneration() ?? 0,- mutateFileIndex: (event) => watcher?.mutateFileIndex(event),+ mutateFileIndex: (event) => {+ // Read before the mutation overwrites the cached entry: an update knows+ // whether an index-visible field moved only by comparing the old fields+ // against the new bytes, and the pre-mutation file index is the only+ // place the old fields still exist here.+ const previousIndexedFields =+ event.kind === 'update' ? currentIndexedFields(event.docName) : undefined;+ watcher?.mutateFileIndex(event);+ // API mutations register their disk writes, so the watcher correctly+ // suppresses the echo. Schedule at this typed mutation seam or direct+ // creates such as /api/create-page never reach another invalidator.+ switch (event.kind) {+ case 'update':+ // An agent rewriting only body prose moves nothing the index shows,+ // so gate on the rendered fields — the same predicate the watcher's+ // update path uses — rather than rebuilding on every write. Create+ // and delete change membership and always schedule.+ if (indexedMetadataChanged(previousIndexedFields, event.content, event.docName)) {+ scheduleIndexRegeneration(event.docName);+ }+ break;+ case 'create':+ case 'conflict':+ scheduleIndexRegeneration(event.docName);+ break;+ case 'delete':+ scheduleIndexRegenerationAfterRemoval(event.docName);+ break;+ case 'rename':+ scheduleIndexRegenerationAfterRemoval(event.oldDocName);+ scheduleIndexRegeneration(event.newDocName);+ break;+ case 'folder-create':+ case 'folder-delete':+ scheduleSubdirectoryIndexRegeneration(event.relativePath);+ break;+ case 'asset-create':+ case 'asset-delete':+ case 'file-create':+ case 'file-update':+ case 'file-delete':+ break;+ default:+ assertNeverDiskEvent(event);+ }+ },getFolderIndex: () => (watcher ? watcher.getFolderIndex() : new Map()),getAliasMap: () => (watcher ? watcher.getAliasMap() : new Map()),getFolderAliasIndex: () => (watcher ? watcher.getFolderAliasIndex() : new Map()),@@ -2483,12 +3178,19 @@ export function createServer(options: ServerOptions): ServerInstance {log.info({ docName: event.docName }, `[reconcile] create: ${event.docName}`);await derivedDocumentIndex.recordDiskUpsert(event.docName, event.content);signalChannel('files');+ // Membership changed. A disk-originated create never reaches+ // `onDiskFlush` — that fires when persistence writes OUT — so the+ // watcher is the only place this arrives.+ scheduleIndexRegeneration(event.docName);onUpstreamAdd(event.docName);break;}case 'update': {const { docName, content: theirs } = event;+ if (indexedMetadataChanged(event.previousIndexedFields, theirs, docName)) {+ scheduleIndexRegeneration(docName);+ }const document = hocuspocus.documents.get(docName);if (!document) {await derivedDocumentIndex.recordDiskUpsert(docName, theirs);@@ -2625,6 +3327,11 @@ export function createServer(options: ServerOptions): ServerInstance {await derivedDocumentIndex.recordDiskDelete(docName);signalChannel('files');onUpstreamDelete(docName);+ // Same reason as the loaded path below, and the COMMON case: a+ // document deleted from the file tree or a shell was usually never+ // opened, so this branch is where most deletions land. Omitting it+ // leaves the index linking to a file that is gone.+ scheduleIndexRegenerationAfterRemoval(docName);console.info(JSON.stringify({event: 'recently-removed-docs-populate',@@ -2685,6 +3392,10 @@ export function createServer(options: ServerOptions): ServerInstance {await forceUnloadDocument(document);signalChannel('files');onUpstreamDelete(docName);+ // A deleted document must leave the index. Nothing else reports this:+ // deletion produces no flush, so without this the entry survives as a+ // link to a file that is gone.+ scheduleIndexRegenerationAfterRemoval(docName);console.info(JSON.stringify({event: 'recently-removed-docs-populate',@@ -2722,6 +3433,12 @@ export function createServer(options: ServerOptions): ServerInstance {source: 'watcher-rename',}),);+ // A rename empties the source directory's index of this entry and+ // adds it to the destination's, so both must rebuild — scheduling only+ // one strands the moved document in the other. A same-directory rename+ // resolves to a single directory, which the pending set dedupes.+ scheduleIndexRegenerationAfterRemoval(oldDocName);+ scheduleIndexRegeneration(newDocName);break;}@@ -2778,6 +3495,9 @@ export function createServer(options: ServerOptions): ServerInstance {case 'folder-create':case 'folder-delete': {signalChannel('files');+ // A folder create or delete changes its parent's child listing, which+ // every ancestor index above it reflects.+ scheduleSubdirectoryIndexRegeneration(event.relativePath);break;}// file-* events maintain the in-memory fileIndex as `kind:'file'`. Like@@ -2990,6 +3710,16 @@ export function createServer(options: ServerOptions): ServerInstance {const phaseErrors: Array<{ phase: string; error: string }> = [];shutdownAllowsUnload = true;+ // Close the generator before watcher or shadow teardown. Cancellation is+ // cooperative: an already-started atomic write finishes, then the+ // single-flight pass observes the signal and drains before teardown.+ try {+ await closeIndexRegeneration();+ } catch (err) {+ log.warn({ err }, '[index] generated index shutdown drain failed');+ phaseErrors.push({ phase: 'generated-index-drain', error: String(err) });+ }+// Stop contributing to the process-wide workload gauges before any// teardown phase runs — a mid-destroy sample would otherwise read// half-dismantled structures. Same for the staleness watchdog: a sweep@@ -4782,17 +5512,26 @@ export function createServer(options: ServerOptions): ServerInstance {// (so it could be passed into createApiExtension before initAsync ran).// Settle it now from initAsync's completion. Errors propagate through the// same channel callers awaited before.- initAsync().then(resolveReady, (err) => {- // A pre-index startup failure would otherwise strand coordinator callers- // behind unresolved admission/readiness barriers. Failed server startup- // has no recovery path, so close releases every waiter with a rejection.- void derivedDocumentIndex.close();- // A failure BEFORE the branch scope was aligned leaves this deferred- // pending, which would park WebSocket admission forever. Release it (no-op- // when the alignment already ran) so the branch gate falls through instead.- resolveBranchScopeAligned();- rejectReady(err);- });+ initAsync().then(+ () => {+ indexRegenerationReady = true;+ // Promise continuations run before the macrotask below, so callers can+ // observe readiness without paying synchronous planner cost.+ resolveReady();+ deferBootIndexSweep();+ },+ (err) => {+ indexRegenerationClosed = true;+ indexRegenerationAbort.abort();+ settleGeneratedIndexSweep({ status: 'failed', indexCount: 0 });+ // A pre-index startup failure would otherwise strand coordinator callers+ // behind unresolved admission/readiness barriers. Failed server startup+ // has no recovery path, so close releases every waiter with a rejection.+ void derivedDocumentIndex.close();+ resolveBranchScopeAligned();+ rejectReady(err);+ },+ );return {hocuspocus,@@ -4809,6 +5548,7 @@ export function createServer(options: ServerOptions): ServerInstance {serverInstanceId,destroy,ready,+ generatedIndexSweepReady,degraded,lockDir,get syncEngine() {diff --git a/packages/server/src/shadow-branch-gc.test.ts b/packages/server/src/shadow-branch-gc.test.tsindex 13025a0ff..8c63a67dd 100644--- a/packages/server/src/shadow-branch-gc.test.ts+++ b/packages/server/src/shadow-branch-gc.test.ts@@ -245,6 +245,7 @@ describe('per-writer 30-day TTL GC on active branches (US-019, D54, FR-18)', ()await createRefWithDate(shadow, `refs/wip/${activeBranch}/file-system`, staleDate);await createRefWithDate(shadow, `refs/wip/${activeBranch}/git-upstream`, staleDate);await createRefWithDate(shadow, `refs/wip/${activeBranch}/openknowledge-service`, staleDate);+ await createRefWithDate(shadow, `refs/wip/${activeBranch}/ok-generator`, staleDate);const result = await gcShadowBranches(shadow, resolve(projectRoot, '.git'));@@ -264,6 +265,9 @@ describe('per-writer 30-day TTL GC on active branches (US-019, D54, FR-18)', ()expect(remaining).toContain(`refs/wip/${activeBranch}/file-system`);expect(remaining).toContain(`refs/wip/${activeBranch}/git-upstream`);expect(remaining).toContain(`refs/wip/${activeBranch}/openknowledge-service`);+ // Generated-artifact history outlives any session: the index's authorship is+ // as durable as the file it describes.+ expect(remaining).toContain(`refs/wip/${activeBranch}/ok-generator`);});test('preserves fresh session refs (<30d) on active branches (US-019)', async () => {diff --git a/packages/server/src/shadow-branch-gc.ts b/packages/server/src/shadow-branch-gc.tsindex 84a6a0f99..772a1b560 100644--- a/packages/server/src/shadow-branch-gc.ts+++ b/packages/server/src/shadow-branch-gc.ts@@ -311,7 +311,8 @@ export async function gcShadowBranches(c.classification === 'classified-file-system' ||c.classification === 'classified-git-upstream' ||c.classification === 'classified-git-author' ||- c.classification === 'classified-openknowledge-service'+ c.classification === 'classified-openknowledge-service' ||+ c.classification === 'classified-ok-generator') {continue;}diff --git a/packages/server/src/shadow-repo.ts b/packages/server/src/shadow-repo.tsindex 7c4f88f89..2249f7570 100644--- a/packages/server/src/shadow-repo.ts+++ b/packages/server/src/shadow-repo.ts@@ -27,6 +27,7 @@import { randomUUID } from 'node:crypto';import { existsSync, readdirSync, rmSync } from 'node:fs';import { resolve } from 'node:path';+import { SYSTEM_WRITER_DISPLAY_NAMES } from '@inkeep/open-knowledge-core';import {type AutoConsolidationTrigger,CHECKPOINT_KIND_REGISTRY,@@ -37,6 +38,7 @@ import {formatImportSubject,formatOkActor,formatParkSubject,+ OK_GENERATOR_WRITER_ID,type OkActorEntry,type ParsedCheckpoint,parseCheckpoint,@@ -693,27 +695,46 @@ async function commitWipFromTreeInner(// ─── Classified writer-identity constants ─────────────────────────────────+// Display names come from `SYSTEM_WRITER_DISPLAY_NAMES` in core: the editor+// matches on them to choose a timeline icon and cannot import this module, so+// the strings have to live somewhere both sides can reach.+/** Non-attributable file-system writes (disk changes, reconciliation). */export const FILE_SYSTEM_WRITER: WriterIdentity = {id: 'file-system',- name: 'File System',+ name: SYSTEM_WRITER_DISPLAY_NAMES.fileSystem,email: '[email protected]',};/** Non-attributable upstream git-pull imports. */export const GIT_UPSTREAM_WRITER: WriterIdentity = {id: 'git-upstream',- name: 'Git (upstream)',+ name: SYSTEM_WRITER_DISPLAY_NAMES.gitUpstream,email: '[email protected]',};/** Non-attributable internal service bookkeeping. */export const SERVICE_WRITER: WriterIdentity = {id: 'openknowledge-service',- name: 'OpenKnowledge (service)',+ name: SYSTEM_WRITER_DISPLAY_NAMES.service,email: '[email protected]',};+/**+ * Artifacts OK authors itself — today the generated root `index.md`.+ *+ * Deliberately NOT `SERVICE_WRITER`: that one is the fallback for work with no+ * contributor behind it, and precedent #25 reserves it for exactly that. A+ * generated document is an authoring action with a real author; the author just+ * is not a person. Keeping them apart is what lets a reader tell "OK wrote this+ * file" from "OK flushed something nobody claimed".+ */+export const OK_GENERATOR_WRITER: WriterIdentity = {+ id: OK_GENERATOR_WRITER_ID,+ name: SYSTEM_WRITER_DISPLAY_NAMES.generator,+ email: `${OK_GENERATOR_WRITER_ID}@openknowledge.local`,+};+// ─── Upstream import ─────────────────────────────────────────────────────────const UPSTREAM_WRITER: WriterIdentity = GIT_UPSTREAM_WRITER;diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex 9a3658453..30222c6d0 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -950,6 +950,9 @@ importers:mdast-util-to-markdown:specifier: ^2.1.2version: 2.1.2+ mdast-util-to-string:+ specifier: ^4.0.0+ version: 4.0.0micromark-extension-mdx:specifier: 2.1.0version: 2.1.0@@ -1004,6 +1007,9 @@ importers:unified:specifier: ^11.0.5version: 11.0.5+ unified-lint-rule:+ specifier: ^3.0.0+ version: 3.0.1unist-util-visit:specifier: ^5.1.0version: 5.1.0@@ -11219,6 +11225,9 @@ packages:resolution: {integrity: sha512-+QBBXBCvifc56fsbuxZQ6Sic3wqqc3WWaqxs58gvJrcOuN83HGTCwz3oS5phzU9LthRNE9VrJCFCLUgHeeFnfA==}engines: {node: '>=18'}+ resolution: {integrity: sha512-HxIeQOmwL19DGsxHXbeyzKHBsoSCFO7UtRVUvT2v61ptw/G+GbysWcrpHdfs5jqbIFDA11MoKngIhQK0BeTVjA==}+resolution: {integrity: sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==}@@ -22758,6 +22767,13 @@ snapshots:+ dependencies:+ '@types/unist': 3.0.3+ trough: 2.2.0+ unified: 11.0.5+ vfile: 6.0.3+dependencies:'@types/unist': 3.0.3