v1.3.0

Release Notes

Summary

This release improves pod registration reliability, adds in-browser pod file inspection and editing tools, expands Pod Browser functionality, and introduces a repo-level version bump workflow to keep displayed version metadata synchronized across the app and documentation.

Highlights

Pod registration improvements

• Fixed multiple Pod Registration workflow regressions and refresh-state issues.
• Added support for manually registering a newly created pod URL to an existing WebID.
• Added optional WebID-based pod inference with validation and clearer failure messaging.
• Improved validation so manually entered pod URLs are checked before being written to the user’s WebID.
• Refined Pod Registration styling and responsive behavior for no-pod and selected-pod states.

Pod Browser enhancements

• Added creation of empty containers directly from the Pod Browser UI.
• Added richer item detail views and better display of base file/container names in the main listing.
• Added direct container size calculation on demand, with session-level caching and invalidation after create / move / rename / delete actions.
• Added download support for individual files from the Pod Browser.
• Improved metadata rendering and parser diagnostics for malformed RDF/Turtle resources.

In-browser file inspection

• Added a lazy-loaded resource inspector for supported file types.
• Supported preview / validation / editing workflows for:
  • plain text
  • JSON / JSON-LD
  • CSV
  • RDF serializations such as Turtle, N-Triples, and related text-based formats
• Added bounded preview loading, scrollable previews, collapsible long previews, and format-aware structure summaries.

Guides and documentation

• Updated landing and Pod Browser guides to document:
  • pod registration edge cases
  • browser inspection workflow
  • direct container size behavior
• Synchronized citation and README version references.
• Added a dedicated version bump script and release-tag workflow documentation.

Versioning workflow

• Added a single script to bump and synchronize version references across:
  • package.json
  • package-lock.json
  • README.md
  • CITATION.cff
  • CITATION.bib
• Simplified release tag convention from web-app-vX.Y.Z to vX.Y.Z.

Developer-facing changes

• Added:
  • src/components/PodResourceInspector.vue
  • src/composables/usePodResourceInspector.ts
  • src/services/solid/resourceInspector.ts
  • src/stores/containerSize.ts
  • scripts/bump-version.mjs
• Expanded automated test coverage for:
  • Pod Registration
  • Pod Browser
  • resource inspection helpers
  • container size caching
  • version bump script behavior

Testing

• Added/updated component and unit tests covering the new Pod Browser, Pod Registration, resource inspector, cache store, and version bump workflow.

v1.2.1

Hot-Fix Release Report (since v1.2.0)

Scope

• Base version: v1.2.0
• Compared to: HEAD (0c894aa)
• Type: Hot-fix patch

Summary

This hot-fix cycle focused on stabilizing query-mode behavior, correcting login redirect handling, and aligning example query coverage with the supported Comunica engines.

What Changed

1) Query Mode & Examples

• Fixed link-traversal example-query behavior and visibility.
• Replaced/updated example query assets for clearer mode-specific usage:
  • Added new link-traversal and federated demonstration queries.
  • Removed outdated link-traversal examples.
• Updated query-mode validation coverage to match current execution rules.

2) DataQuery UX & Guide Alignment

• Updated DataQuery logic and guide content to reflect current query-engine modes and examples.
• Improved consistency between selectable examples and the active query mode.

3) Login Redirect Reliability

• Fixed Solid login redirect handling by sanitizing callback URLs (notably hash/query edge cases).
• Reduced redirect-related failures for deep-link routes.

Test Coverage Updates

• Updated component and unit tests tied to:
  • Example-query selection/display behavior
  • Login redirect flow
  • Query mode validation

Files Touched (High-Level)

• src/components/DataQuery.vue
• src/components/Guides/DataQueryGuide.vue
• src/services/query/queryPod.ts
• src/services/solid/login.ts
• tests/components/DataQueryExamples.test.ts
• tests/unit/login.test.ts
• tests/unit/queryModeValidation.test.ts
• demonstrator/*.rq (example query set refresh)

Compatibility / Breaking Changes

• Breaking changes: None expected.

v1.2.0

Solid Cockpit — Release Notes (v1.2.0)

Highlights

• Major UI/UX refactor across core pages for a more consistent, professional layout.
• Query system upgraded with multiple Comunica engine modes and clearer mode-specific behavior.
• Privacy workflows expanded with spec-aligned sharing notifications and automated revocation support.
• Build/test pipeline stabilized with npm-first workflows, stricter compliance checks, and CI hardening.

Query & DataQuery Improvements

• Added engine mode selection in Query:
• SPARQL endpoint(s) via @comunica/query-sparql.
• Solid (no traversal) via @comunica/query-sparql-solid.
• Solid (link traversal) via @comunica/query-sparql-link-traversal-solid.
• Improved query error handling:
• Clearer endpoint/mode-aware messages and user-facing troubleshooting hints.
• Better handling for empty/missing cached result files.
• Query cache UX significantly expanded:
• Rename, delete, share, filter, sort, and search capabilities for cache entries.
• Better cached-results previews (compact display and improved rendering lifecycle).
• URL/query-state synchronization refactors:
• One-way synchronization model for YASQE stability.
• Query share URL behavior updated and simplified.
• Mode-scoped example queries:
• Example list now filtered by selected query engine.
• Added simple Solid no-traversal and link-traversal examples.
• Removed mixed-engine sample example.
• Updated example datasource parsing to support whitespace-delimited datasource declarations.

Privacy Editing & Notifications

• Brought SharedWithMe / SharedWithOthers handling closer to the permissions-notification spec.
• Added support for scheduled auto-revoke:
• Revoke by future date-time or duration.
• Automatic revocation checks when users log in/select pod.
• Improved sharing record interactions:
• Better expanded-detail layout, copy actions, and inline actions.
• Improved notification surface:
• Header-level notification integration with better unread-state visibility and routing to Privacy view.
• Improved ACL/help clarity:
• Added clearer explanatory/help affordances around ACL behavior and constraints.

Pod Browser / Upload / Navigation

• Refactored ContainerNav interactions and visual consistency across components.
• PodBrowser enhancements:
• Better item cards/details layout and metadata handling.
• Move, rename, delete workflows improved.
• Added per-file download action in item details.
• Added item filtering/search UX (hidden-by-default filter panel pattern).
• DataUpload refinements:
• Better path input and validation behavior.
• More responsive/mobile-friendly layout and cleaner destination selection flow.
• Multiple consistency fixes for icons, spacing, typography, and hover behavior.

Guides & Documentation

• Reworked in-app guides for consistency and completeness across components.
• Landing guide updates:
• Added embedded product demo video section.
• Replaced older onboarding references with current component capability guidance.
• Updated README:
• npm-based workflows and current scripts.
• Current architecture/features/spec references.
• Removed outdated Yarn/onboarding references.

Tooling, CI, and Repo Maintenance

• Migrated package manager workflow to npm (package-lock.json authoritative).
• CI/workflow hardening:
• Node pinned to 22.12.0 in workflows.
• Added Rollup optional-binary fallback step for Linux CI.
• Improved compliance/coverage pipeline reliability and diagnostics.
• Expanded/updated tests to cover new functionality and prevent regressions.
• Removed legacy Materialize dependency usage patterns causing style/runtime inconsistencies.

Dependency & Platform Updates

• Upgraded Comunica stack toward current v5 line where applicable.
• Added link traversal engine dependency.
• Node engine constraints updated for modern runtime support.
• Restored/standardized MDI icon rendering support across components.

Notable Breaking/Behavioral Changes

• npm is now the supported package manager for this repo.
• Query example visibility is now tied to selected query engine mode.
• Query example datasource parsing now expects whitespace-separated values.
• Query URL sharing/state behavior changed from older encoding strategy.

v1.1.0

Highlights

• Major UX refactor across core pages (LandingPage, PodUpload, PodBrowser, DataQuery, EditPrivacy) for consistent layout, typography, responsiveness, and guide presentation.
• Query caching was brought closer to the materialization-container specification, with significant improvements to query history and cache workflows.
• Privacy editing was aligned to the permissions-notification specification and expanded with scheduled auto-revocation.
• Project runtime/package workflow moved to npm + Node 22, including lockfile and CI updates.

User-Facing Features

Pod Browser

• Stronger item-detail presentation and metadata handling, including malformed Turtle diagnostics.
• Added/iterated item actions: download resource, move, rename, delete.
• Added filtering and search for container contents.
• Improved container navigation consistency with upload workflows.

Data Query

• Improved datasource editing flow (editable entries, validation, truncation/overflow handling, mobile-friendly controls).
• Improved query error display and cached result rendering behavior.
• Expanded and refined query URL sharing behavior.
• Enhanced sample-query UX and expanded query-guide documentation.

Privacy Editing

• Improved “Shared with me / Shared with others” displays and expanded-detail organization.
• Added permission edit paths in shared entries.
• Added auto-revoke scheduling by duration or future datetime, plus revoke sweep logic on pod load.
• Improved notifications display/organization and header integration.

Landing / Home

• Guide system refreshed and restructured.
• Embedded video demo support in guides.
• Session/pod status and pod-registration presentation refined.

Developer / Platform Changes

• Migrated from Yarn to npm workflow (package-lock.json as source of truth).
• Standardized runtime/tooling around Node 22, with CI/workflow updates.
• Removed dependency on materialize.css patterns and replaced with app-native/Vuetify-compatible styling.
• Restored/fixed icon rendering consistency (MDI/material icon usage).
• Improved pre-commit/component-test setup to reduce noisy Vuetify unresolved-component warnings.

Testing and Quality

• Expanded unit/component coverage for new browser/query/privacy functionality.
• Added tests around PodBrowser features, query examples, and shared UI behavior.
• Updated compliance/test workflows and coverage scripts alongside runtime/package-manager migration.

Documentation

• README updated for current npm-based setup and current feature set.
• Outdated TRIPLE onboarding references replaced by current in-app guidance.