feat(export): native Open Knowledge Format (OKF) v0.2 bundle support by d-oit · Pull Request #624 · d-oit/do-knowledge-studio

d-oit · 2026-08-08T17:34:03Z

Introduces native Open Knowledge Format (OKF) v0.2 bundle export/import support in the Knowledge Studio. Built native client-side zip creation/extraction, structured Zod schemas, provenance/attribution stable footnotes, trust evaluation, update logging, and Conformance §11 robust error-handling/passthroughs. Fully verified with Jest/Vitest test suites and repository quality gates.

Fixes #623

PR created automatically by Jules for task 17257068464195044926 started by @d-oit

Introduces native OKF v0.2 bundle support in the studio: - Structured Zod validation schemas matching Google Cloud's OKF v0.2 spec in types.ts. - Export engine converting studio entities, claims, and edges to zipped Markdown bundles in bundle.ts. - Import engine reconstructing studio data from zipped OKF bundles in import.ts. - Trust tier and staleness evaluation helpers in trust.ts. - Native integration in export-types.ts, use-export-handlers.ts, and UI views. - Comprehensive unit and integration test coverage. - New ADR 031 documenting the design decision. Co-authored-by: d-oit <6849456+d-oit@users.noreply.github.com>

google-labs-jules · 2026-08-08T17:34:04Z

👋 Jules, reporting for duty! I'm here to lend a hand with this pull request.

When you start a review, I'll add a 👀 emoji to each comment to let you know I've read it. I'll focus on feedback directed at me and will do my best to stay out of conversations between you and other bots or reviewers to keep the noise down.

I'll push a commit with your requested changes shortly after. Please note there might be a delay between these steps, but rest assured I'm on the job!

For more direct control, you can switch me to Reactive Mode. When this mode is on, I will only act on comments where you specifically mention me with @jules. You can find this option in the Pull Request section of your global Jules UI settings. You can always switch back!

New to Jules? Learn more at jules.google/docs.

For security, I will only act on instructions from the user who triggered this task.

vercel · 2026-08-08T17:34:05Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
do-knowledge-studio	Ready	Preview, v0	Aug 9, 2026 8:16pm

deepsource-io · 2026-08-08T17:34:57Z

DeepSource Code Review

We reviewed changes in 63558b9...f2fd442 on this pull request. Below is the summary for the review, and you can see the individual issues we found as inline review comments.

See full review on DeepSource ↗

Important

Some issues found as part of this review are outside of the diff in this pull request and aren't shown in the inline review comments due to GitHub's API limitations. You can see those issues on the DeepSource dashboard.

PR Report Card

Overall Grade	Security Reliability Complexity Hygiene

Code Review Summary

Analyzer	Updated (UTC)	Details
JavaScript	Aug 9, 2026 8:15p.m.	Review ↗
Python	Aug 9, 2026 8:15p.m.	Review ↗
Shell	Aug 9, 2026 8:15p.m.	Review ↗
SQL	Aug 9, 2026 8:15p.m.	Review ↗

Important

AI Review is run only on demand for your team. We're only showing results of static analysis review right now. To trigger AI Review, comment @deepsourcebot review on this thread.

owl-watch

🦉 OwlWatch reviewed this change — 2 new finding(s).

codacy-production · 2026-08-08T17:35:44Z

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

🟢 Metrics 104 complexity · 2 duplication

Metric Results

Complexity 104

Duplication 2

View in Codacy

_{NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer}
_{TIP This summary will be updated as you push new changes.}

Introduces native OKF v0.2 bundle support in the studio: - Structured Zod validation schemas matching Google Cloud's OKF v0.2 spec in types.ts. - Export engine converting studio entities, claims, and edges to zipped Markdown bundles in bundle.ts. - Import engine reconstructing studio data from zipped OKF bundles in import.ts. - Trust tier and staleness evaluation helpers in trust.ts. - Native integration in export-types.ts, use-export-handlers.ts, and UI views. - Comprehensive unit and integration test coverage. - New ADR 031 documenting the design decision. Co-authored-by: d-oit <6849456+d-oit@users.noreply.github.com>

owl-watch

🦉 OwlWatch reviewed this change — 1 new finding(s).

Introduces native OKF v0.2 bundle support in the studio: - Structured Zod validation schemas matching Google Cloud's OKF v0.2 spec in types.ts. - Export engine converting studio entities, claims, and edges to zipped Markdown bundles in bundle.ts. - Import engine reconstructing studio data from zipped OKF bundles in import.ts. - Trust tier and staleness evaluation helpers in trust.ts. - Native integration in export-types.ts, use-export-handlers.ts, and UI views. - Comprehensive unit and integration test coverage. - New ADR 031 documenting the design decision. Co-authored-by: d-oit <6849456+d-oit@users.noreply.github.com>

…k on PR #624

owl-watch

🦉 OwlWatch reviewed this change — 2 new finding(s).

…#624

owl-watch

🦉 OwlWatch reviewed this change — 1 new finding(s).

Additional findings:

[LOW · hunter] 'unsafe-inline' in CSP for Encrypted Reader (src/lib/export/encrypt.ts:147)

owl-watch

🦉 OwlWatch reviewed this change — 1 new finding(s).

…uplication)

Ensure that the main navigation sidebar is fully visible and hydrated before running tests that press Control+K, preventing timing-related event drop flakiness. Co-authored-by: d-oit <6849456+d-oit@users.noreply.github.com>

owl-watch

🦉 OwlWatch reviewed this change — 1 new finding(s).

…ent Web Crypto

owl-watch

🦉 OwlWatch reviewed this change — 1 new finding(s).

…se, concurrent-agent reconciliation

owl-watch

🦉 OwlWatch reviewed this change — 1 new finding(s).

Co-authored-by: d-oit <6849456+d-oit@users.noreply.github.com>

owl-watch

🦉 OwlWatch reviewed this change — 2 new finding(s).

…upe test preview fixture

…t-agent reconciliation

owl-watch

🦉 OwlWatch reviewed this change — 1 new finding(s).

owl-watch · 2026-08-09T20:01:44Z

+      if (errors.length > 0 && ents.length === 0) {
+        toast.error('Import failed', { description: errors.join('; ') })
+        return
+      }


🦉 OwlWatch [LOW · tracker] Partial import error message truncation

Partial import errors could be truncated or misleading when joined as a single string.

owl-watch

🦉 OwlWatch reviewed this change — 1 new finding(s).

owl-watch · 2026-08-09T20:16:46Z

+ * @param files - Map of bundle-relative path → file content.
+ * @returns Entities, claims, and any non-fatal parse errors.
+ */
+export const parseOkfBundle = (files: Map<string, string>): OkfImportResult => {


🦉 OwlWatch [MEDIUM · tracker] Missing bundle validation in parseOkfBundle

The parseOkfBundle function fails to validate the okf_version within the index.md file, delegating this crucial validation to the UI layer and making the library vulnerable to processing arbitrary or incompatible files.

google-labs-jules Bot mentioned this pull request Aug 8, 2026

feat(export): Native Open Knowledge Format (OKF) v0.2 bundle export/import support #623

Open

4 tasks

github-actions Bot added documentation Documentation improvements config tests Related to automated/manual tests labels Aug 8, 2026

vercel Bot deployed to Preview August 8, 2026 17:34 View deployment

deepsource-io Bot reviewed Aug 8, 2026

View reviewed changes

owl-watch Bot reviewed Aug 8, 2026

View reviewed changes

Comment thread src/lib/okf/import.ts Outdated

Comment thread src/lib/okf/import.ts Outdated

vercel Bot deployed to Preview August 8, 2026 20:13 View deployment

vercel Bot deployed to Preview August 8, 2026 20:30 View deployment

owl-watch Bot reviewed Aug 8, 2026

View reviewed changes

Comment thread src/lib/okf/import.ts Outdated

vercel Bot deployed to Preview August 9, 2026 00:39 View deployment

fix(okf): address DeepSource, OwlWatch, and maintainer review feedbac…

dfff869

…k on PR #624

deepsource-io Bot reviewed Aug 9, 2026

View reviewed changes

Comment thread src/components/studio/views/use-export-handlers.ts

Comment thread src/lib/okf/bundle.ts

Comment thread src/lib/okf/bundle.ts

Comment thread src/lib/okf/import.ts

Comment thread src/lib/okf/import.ts

Comment thread src/lib/okf/import.ts

owl-watch Bot reviewed Aug 9, 2026

View reviewed changes

Comment thread src/components/studio/views/use-export-handlers.ts

Comment thread src/lib/okf/import.ts Outdated

vercel Bot deployed to Preview August 9, 2026 12:43 View deployment

d-oit mentioned this pull request Aug 9, 2026

fix(owlwatch): remediate issues 620-622 + Plan 111 reconciliation #626

Open

fix(okf): raise doc coverage and clear Codacy findings on PR #624

6d7fbcc

deepsource-io Bot reviewed Aug 9, 2026

View reviewed changes

Comment thread src/components/studio/views/use-export-handlers.ts

vercel Bot deployed to Preview August 9, 2026 13:15 View deployment

docs(okf): add JSDoc param tags to raise DeepSource doc coverage on PR …

3732cde

…#624

vercel Bot deployed to Preview August 9, 2026 13:32 View deployment

owl-watch Bot reviewed Aug 9, 2026

View reviewed changes

vercel Bot deployed to Preview August 9, 2026 18:45 View deployment

owl-watch Bot reviewed Aug 9, 2026

View reviewed changes

Comment thread src/components/studio/views/use-export-handlers.ts Outdated

refactor(export): extract shared LibraryPayload interface (OwlWatch d…

3c940be

…uplication)

vercel Bot deployed to Preview August 9, 2026 18:57 View deployment

d-oit enabled auto-merge (squash) August 9, 2026 18:58

test(e2e): improve command palette test robustness

223beca

Ensure that the main navigation sidebar is fully visible and hydrated before running tests that press Control+K, preventing timing-related event drop flakiness. Co-authored-by: d-oit <6849456+d-oit@users.noreply.github.com>

vercel Bot deployed to Preview August 9, 2026 19:08 View deployment

deepsource-io Bot reviewed Aug 9, 2026

View reviewed changes

fix(okf): restore reviewed fixes reverted by stale concurrent push

c6271e1

owl-watch Bot reviewed Aug 9, 2026

View reviewed changes

Comment thread src/lib/okf/import.ts

vercel Bot deployed to Preview August 9, 2026 19:30 View deployment

deepsource-io Bot reviewed Aug 9, 2026

View reviewed changes

Comment thread src/components/studio/views/use-export-handlers.ts

Comment thread src/lib/okf/bundle.ts

Comment thread src/lib/okf/bundle.ts

Comment thread src/lib/okf/import.ts

Comment thread src/lib/okf/import.ts

Comment thread src/lib/okf/import.ts

fix(okf): guard crypto.getRandomValues in uuid fallback; throw on abs…

46a642c

…ent Web Crypto

vercel Bot deployed to Preview August 9, 2026 19:35 View deployment

owl-watch Bot reviewed Aug 9, 2026

View reviewed changes

Comment thread src/components/studio/views/use-export-handlers.ts

docs(plans): finalize Plan 111 — PR sweep, DeepSource config root cau…

d57f97b

…se, concurrent-agent reconciliation

vercel Bot deployed to Preview August 9, 2026 19:44 View deployment

owl-watch Bot reviewed Aug 9, 2026

View reviewed changes

Comment thread src/components/studio/views/use-export-handlers.ts

fix(okf): clean up commit history and refine trust helpers

ad64d28

Co-authored-by: d-oit <6849456+d-oit@users.noreply.github.com>

vercel Bot deployed to Preview August 9, 2026 19:48 View deployment

owl-watch Bot reviewed Aug 9, 2026

View reviewed changes

Comment thread src/components/studio/views/use-export-handlers.test.ts

Comment thread src/lib/okf/import.ts

fix(export): surface partial OKF import errors via warning toast; ded…

ec9bc7b

…upe test preview fixture

vercel Bot deployed to Preview August 9, 2026 19:55 View deployment

deepsource-io Bot reviewed Aug 9, 2026

View reviewed changes

Comment thread src/components/studio/views/use-export-handlers.ts

docs(plans): finalize Plan 111 — full PR sweep record incl. concurren…

f2fd442

…t-agent reconciliation

vercel Bot deployed to Preview August 9, 2026 20:01 View deployment

owl-watch Bot reviewed Aug 9, 2026

View reviewed changes

d-oit force-pushed the feat/okf-bundle-export-import-17257068464195044926 branch from 9056d89 to f2fd442 Compare August 9, 2026 20:15

owl-watch Bot reviewed Aug 9, 2026

View reviewed changes

vercel Bot deployed to Preview August 9, 2026 20:16 View deployment

Conversation

d-oit commented Aug 8, 2026

Uh oh!

google-labs-jules Bot commented Aug 8, 2026

Uh oh!

vercel Bot commented Aug 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

deepsource-io Bot commented Aug 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

DeepSource Code Review

PR Report Card

Code Review Summary

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

owl-watch Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

codacy-production Bot commented Aug 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Up to standards ✅

Uh oh!

owl-watch Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

owl-watch Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

owl-watch Bot left a comment

Choose a reason for hiding this comment

Uh oh!

owl-watch Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

owl-watch Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

owl-watch Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

vercel Bot commented Aug 8, 2026 •

edited

Loading

deepsource-io Bot commented Aug 8, 2026 •

edited

Loading

codacy-production Bot commented Aug 8, 2026 •

edited

Loading