What changed in the knowledge bundle, a day to an entry, newest first. https://w3id.org/ktl/linkml-sidecar/knowledge/log 2026-10-29T14:15:37Z Noel McLoughlin CC BY 4.0 https://w3id.org/ktl/linkml-sidecar/knowledge/log#2026-10-29 2026-10-29T14:15:37Z 2026-10-29T14:15:37Z <ul> <li><strong>Changed</strong>: KTL mode says the scaffold also writes the schema's path as <code>[tool.lokf] schema</code>, that the <code>cd</code> workaround is needed only at a lokf 0.8.0 floor, and that removal drops the table's line.</li> </ul> https://w3id.org/ktl/linkml-sidecar/knowledge/log#2026-10-26 2026-10-26T17:51:38Z 2026-10-26T17:51:38Z <ul> <li><strong>Changed</strong>: the assumptions catalogue links linkml-project-copier#187 from its body, not its <code>references</code>, because a typed relation names a concept and the federation gate fails on a target no member owns.</li> </ul> https://w3id.org/ktl/linkml-sidecar/knowledge/log#2026-10-24 2026-10-24T12:30:04Z 2026-10-24T12:30:04Z <ul> <li><strong>Changed</strong>: The bundle's namespace is now the persistent identifier <code>https://w3id.org/ktl/linkml-sidecar/knowledge/</code>, and every concept's id moves with it. Knowledge website names <code>https://w3id.org/ktl/linkml-sidecar/</code> as the site's address.</li> </ul> https://w3id.org/ktl/linkml-sidecar/knowledge/log#2026-10-22 2026-10-22T12:23:51Z 2026-10-22T18:36:04Z <ul> <li><strong>Changed</strong>: Template pin: the contract now holds the pin's mentions under <code>docs/</code> and in <code>CONTRIBUTING.md</code> too, as check 8 and the scaffold driver's header say.</li> <li><strong>Changed</strong>: linkml-sidecar skill: Step 5 now offers a Forgejo Actions workflow beside the GitHub one.</li> <li><strong>Changed</strong>: Preflight: it now checks the template's source and the package index as git and uv reach them, says why copier failed, warns on a new <code>lock</code> line when <code>uv.lock</code> names another index, and looks for workflows in the folder the forge reads.</li> <li><strong>Changed</strong>: Scaffold: the driver now runs its Python half through <code>uv run</code> on the half's own script header, then a python3 or python of 3.8 or later, and exits 2 when it finds none.</li> <li><strong>Changed</strong>: Sidecar workflow: Step 5 now has a Forgejo Actions template beside the GitHub one, which runs the same gate and publishes to Codeberg Pages. A pin bump is copied into both templates, and the other forges follow <code>automation.md</code>.</li> <li><strong>Changed</strong>: Repository contract: check 9 now covers both workflow templates, and check 8 reads <code>docs/</code> and <code>CONTRIBUTING.md</code> for the template pin as well.</li> <li><strong>Changed</strong>: Contributing now gives the slow-test clone command and the CI job list. Its action-pin rule covers the Forgejo template beside the GitHub one, and a new step says how the Forgejo template is checked.</li> <li><strong>Changed</strong>: KTL mode: PR 3855 is described as its source states it, and the README source moves to <code>docs/architecture.md</code>.</li> <li><strong>Changed</strong>: Knowledge Trust Ladder: <code>docs/architecture.md</code> joins the sources, since the README no longer names the <code>.lokf/</code> folder.</li> <li><strong>Changed</strong>: linkml-project-copier: the README source moves to <code>docs/architecture.md</code>, which carries the MIT credit, and the concept adds that a company copy's tag must name the same commit.</li> <li><strong>Changed</strong>: Three cases: re-pointed from the README to <code>docs/architecture.md</code> and <code>layouts.md</code>, and the adopt clause and the list of root assumptions now follow those pages.</li> <li><strong>Changed</strong>: Sidecar: the resource moves from the README to <code>docs/architecture.md</code>, and the body follows that page for the doorway, the workflow and the build output.</li> <li><strong>Changed</strong>: Installing the skills now follows <code>docs/install.md</code>: gh skill first, npx with <code>--global</code>, the <code>/plugin</code> commands, a copy of the repository, user or project scope, the pin, the workflow switch and what each skill needs.</li> <li><strong>Added</strong>: Who owns which file, from the ownership, never-run and keeping-current sections of <code>docs/architecture.md</code>, which no concept covered.</li> <li><strong>Added</strong>: Portability, the reference page on which hosts the sidecar works on and what each loses: RHEL, WSL2, Windows, a company proxy or package mirror, other forges, and the template from a company copy.</li> <li><strong>Changed</strong>: Knowledge sources: <code>docs/</code> joins the map, its two pages take over what the README stated, and the Forgejo workflow template joins the workflow row.</li> <li><strong>Changed</strong>: the assumptions catalogue cites linkml-project-copier#187, where the layout proposal is filed, in place of the draft that left the skill.</li> <li><strong>Removal</strong>: Upstream layout proposal; the draft left <code>skills/linkml-sidecar/references/</code> once it was filed as linkml-project-copier#187.</li> <li><strong>Prose</strong>: reworded 6 concept bodies in plain English. No fact, link, number or frontmatter changed.</li> <li><strong>Changed</strong>: The linkml-sidecar skill playbook drops the claim that most schema repositories have no project, as SKILL.md has.</li> <li><strong>Changed</strong>: Releasing now describes the semantic-release and publish.yml workflows that replaced tagging by hand, as CONTRIBUTING.md states.</li> <li><strong>Changed</strong>: Two patterns no longer claims that most schema repositories have no project, and names the files that mark a schema, as README.md now does.</li> <li><strong>Changed</strong>: Schema layouts follows layouts.md, which no longer says most schemas were made without a template.</li> <li><strong>Changed</strong>: KTL mode says a bundle beside a schema may be about the repository, where ktl.md no longer says often.</li> <li><strong>Changed</strong>: the preflight concept drops the repository count, which the authors line no longer prints.</li> <li><strong>Changed</strong>: the schema design concept says that a name defined twice across imports passes lint but fails the gate's gen-project, as the page now does.</li> <li><strong>Changed</strong>: the publishing concept follows the page's corrected importmap rules: the base directory of a relative value, and gen-project's route through generator_args.</li> <li><strong>Changed</strong>: the preflight concept says the authors line counts bot commits apart and quotes the names it prints.</li> <li><strong>Changed</strong>: the linkml-author playbook says how the skill reads the authors line.</li> <li><strong>Added</strong>: the publishing page, on where a schema is served, how an importer takes it, the importmap and lokf's adapt.</li> <li><strong>Changed</strong>: the schema design page gained the collision gradient, a core plus modules, and the refactoring moves that touch no record.</li> <li><strong>Changed</strong>: the linkml-author playbook names the refactor offer, the preflight's <code>authors</code> line and the publishing page.</li> <li><strong>Changed</strong>: the preflight prints an <code>authors</code> line with the people in the schema folder's history and the repository's.</li> <li><strong>Changed</strong>: the scaffold renames the template's config.yaml to generators.yaml, and <code>--repair generators.yaml</code> moves an existing project's file.</li> <li><strong>Changed</strong>: the preflight's generators line offers to move a project's config.yaml to .linkml/generators.yaml.</li> <li><strong>Changed</strong>: the linkml-sidecar skill keeps the generators' settings in .linkml/generators.yaml, and offers the move to an existing project.</li> <li><strong>Changed</strong>: the linkml-author skill edits generators.yaml as the project's own, and offers the move from config.yaml.</li> <li><strong>Changed</strong>: the gate's gen-project reads generators.yaml, or config.yaml before the move.</li> <li><strong>Changed</strong>: the catalogue has a twentieth row, on the generators' settings and what copier update leaves alone after the move.</li> <li><strong>Changed</strong>: where a LinkML schema lives says both uses of .linkml/ keep the generators' settings at .linkml/generators.yaml.</li> <li><strong>Changed</strong>: the copier reference cites the catalogue for why the template needs --trust.</li> <li><strong>Changed</strong>: schema design for reuse follows its source page, now written in its own words and examples.</li> <li><strong>Prose</strong>: reworded 3 concept bodies in plain English. No fact, link, number or frontmatter changed.</li> <li><strong>Changed</strong>: the linkml-author skill finds a schema by what files say in any repository, runs tools through the host's justfile, Makefile or environment, and follows the new design rules.</li> <li><strong>Changed</strong>: the linkml-sidecar skill now covers three cases, adopts a schema the host already holds, and installs around configuration files in .linkml/.</li> <li><strong>Changed</strong>: the preflight finds a schema project or schema file by what files say, in any layout, and names how the tools run on it.</li> <li><strong>Changed</strong>: the scaffold stages its output, never removes .linkml/, refuses a clash, and adopts a schema in place with --adopt.</li> <li><strong>Changed</strong>: KTL mode says an adopted schema, or any schema beside a bundle, is the domain schema only when .lokf/justfile names it or it imports lokf.yaml.</li> <li><strong>Changed</strong>: two patterns became three cases: a schema the repository already holds gets the sidecar around it.</li> <li><strong>Changed</strong>: a schema beside a bundle is a domain schema only when .lokf/justfile names it or it imports lokf.yaml.</li> <li><strong>Changed</strong>: the sidecar term covers adoption and a .linkml/ folder that also holds LinkML configuration files.</li> <li><strong>Changed</strong>: an adopted schema gets no dummy, and --dummy asks for one beside an existing schema.</li> <li><strong>Changed</strong>: the gate runs through any project's justfile or Makefile, and has a form for a schema with no project.</li> <li><strong>Changed</strong>: an adopted schema gets no doorway.</li> <li><strong>Changed</strong>: the catalogue has a nineteenth row, on config.public.mk and its possible retirement.</li> <li><strong>Changed</strong>: the upstream proposal carries the caveat that .linkml/ is also proposed for LinkML's configuration files.</li> <li><strong>Changed</strong>: the KTL reference says an adopted schema is not made the domain schema.</li> <li><strong>Changed</strong>: the workflow concept says an adopted schema's folder joins both paths lists.</li> <li><strong>Changed</strong>: the source map names the README's Three cases section.</li> <li><strong>Added</strong>: where a LinkML schema lives, from <code>skills/linkml-sidecar/references/layouts.md</code>.</li> <li><strong>Added</strong>: schema design for reuse, from <code>skills/linkml-author/references/schema-design.md</code>.</li> <li><strong>Prose</strong>: reworded 3 concept bodies in plain English. No fact, link, number or frontmatter changed.</li> </ul> https://w3id.org/ktl/linkml-sidecar/knowledge/log#2026-10-21 2026-10-21T22:25:46Z 2026-10-21T22:48:04Z <ul> <li><strong>Added</strong>: the knowledge website, from <code>website/README.md</code>, <code>site.config.mjs</code> and <code>knowledge-website.yaml</code>.</li> <li><strong>Changed</strong>: the knowledge sources map lists <code>website/</code> and its workflow, which the new website playbook covers.</li> <li><strong>Prose</strong>: reworded 7 concept bodies in plain English. No fact, link, number or frontmatter changed.</li> <li><strong>Added</strong>: the linkml-sidecar skill, from <code>skills/linkml-sidecar/SKILL.md</code>.</li> <li><strong>Added</strong>: the linkml-author skill, from <code>skills/linkml-author/SKILL.md</code>.</li> <li><strong>Added</strong>: installing the skills, from the README's Install and Run it yourself sections.</li> <li><strong>Added</strong>: the contributor checklist, from <code>CONTRIBUTING.md</code>.</li> <li><strong>Added</strong>: the scaffold script, from its header and Step 1 of the linkml-sidecar skill.</li> <li><strong>Added</strong>: the preflight script, from its header, Step 0 of the linkml-sidecar skill and the prerequisites page.</li> <li><strong>Added</strong>: the hoisted workflow, from the template and <code>references/automation.md</code>.</li> <li><strong>Added</strong>: the repository contract, from <code>scripts/validate-repository.sh</code> and <code>validate.yml</code>.</li> <li><strong>Added</strong>: the two patterns, from the README and the linkml-sidecar skill.</li> <li><strong>Added</strong>: KTL mode, from <code>references/ktl.md</code> and the author's KTL page.</li> <li><strong>Added</strong>: the template assumptions catalogue, from <code>references/template-assumptions.md</code>.</li> <li><strong>Added</strong>: the upstream layout proposal, from <code>references/upstream-proposal.md</code>.</li> <li><strong>Added</strong>: the upstream template, from the linkml-sidecar skill and the scaffold driver.</li> <li><strong>Added</strong>: LinkML, as both skills cite it.</li> <li><strong>Added</strong>: the Agent Skills specification, as the README and the contract cite it.</li> <li><strong>Added</strong>: the Knowledge Trust Ladder, as the README and <code>references/ktl.md</code> cite it.</li> <li><strong>Added</strong>: the AI covenant, from <code>AI_COVENANT.md</code>.</li> <li><strong>Added</strong>: the code of conduct, from <code>CODE_OF_CONDUCT.md</code>.</li> <li><strong>Added</strong>: the release policy, from <code>CONTRIBUTING.md</code>.</li> <li><strong>Added</strong>: the sidecar term, from the README.</li> <li><strong>Added</strong>: the doorway term, from Step 2 of the linkml-sidecar skill.</li> <li><strong>Added</strong>: the dummy schema term, from linkml-author and the assumptions catalogue.</li> <li><strong>Added</strong>: the template pin term, from the scaffold driver and <code>CONTRIBUTING.md</code>.</li> <li><strong>Added</strong>: the domain schema term, from <code>references/ktl.md</code> and linkml-author.</li> <li><strong>Added</strong>: the gate term, from linkml-author.</li> <li><strong>Added</strong>: the knowledge sources map.</li> <li><strong>Removal</strong>: Example Service A, the sidecar's placeholder.</li> <li><strong>Removal</strong>: Example Service B, the sidecar's placeholder.</li> <li><strong>Initialization</strong>: Scaffolded the LOKF bundle for linkml-sidecar with placeholder services. Real concepts to follow.</li> </ul>