Skip to content

Sync Apps docs with the fileglancer more-apps PR#22

Open
krokicki wants to merge 14 commits into
mainfrom
docs-apps-updates
Open

Sync Apps docs with the fileglancer more-apps PR#22
krokicki wants to merge 14 commits into
mainfrom
docs-apps-updates

Conversation

@krokicki

@krokicki krokicki commented Jul 5, 2026

Copy link
Copy Markdown
Member

Updates the Apps user guide and the Authoring Apps developer docs to match the current state of the fileglancer more-apps PR.

User guide (Apps and Jobs)

  • Apps UX rework: detail pages for apps and catalog listings, card/table view toggles, actions menus, recent jobs on app detail
  • Commit pinning: apps pin an exact commit at add time, per-app updates, "Update available" badge, immutable per-SHA job checkouts
  • Trust notice shown on every add path (URL and catalog), warning that apps run repository code as the user
  • UNKNOWN job status: treated as active, cancellable but not deletable, marked FAILED after a server-configured cutoff (24h default), plus a troubleshooting entry
  • New "Deleting a Job" section: deletion removes the job's entire working directory including logs, behind a confirmation dialog
  • Large logs display only the trailing 5 MB, with the full file reachable via the file browser
  • Catalog listings are editable after sharing (name, description, repo URL, revision); unshare confirms first; the add dialog shows source, sharer, and share date
  • Extra scheduler arguments are shell-tokenized so LSF resource strings like -R "select[mem>8000]" work; relaunch preserves Environment-tab settings; launch-page install adds only the current app from a multi-app repo

Authoring guide

  • Seamless service/container runnables: auto_url, FG_SERVICE_PORT/FG_HOSTNAME/FG_SERVICE_TOKEN, service_url_suffix, readiness-gated URL publishing, and the "Downloading container image…" startup message
  • New parameter fields: value_separator (space/equals) and boolean_style (flag/value), with the Nextflow-safe forms forced for nextflow run commands
  • exists on file/directory parameters (replacing create_if_missing), with pre-launch directory creation for outputs
  • Stricter validation: conservative CLI-flag pattern, repo_url must parse as a GitHub URL, manifests require at least one runnable
  • Auto-detection: Nextflow apps named by repo only, --flag=value emission with explicit booleans, corrected example and Pixi naming rules
  • Server configuration: new worker_env_passthrough (allowlisted worker environment) and unknown_timeout_hours settings, container cache ~ expansion
  • Container bind mounts include manifest defaults and env-tab path parameters; removed a duplicated paragraph in the services page

@StephanPreibisch @JaneliaSciComp/fileglancer

krokicki and others added 14 commits July 1, 2026 21:23
…uffix

Document that auto_url now publishes the URL only once the port is accepting
connections, the new FG_SERVICE_TOKEN env var, and the service_url_suffix
template for one-click token URLs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The apps UI was reworked: cards are clickable with a banner (type icon,
Launch button, actions menu) and the app info dialog was replaced by a
detail page; the catalog got the same treatment with a listing detail
page; the launch and job detail pages moved under the apps tabs with a
shared back-arrow header.

Update the guide accordingly: Add from URL/Continue dialog flow, the
app detail page section (replacing App Info), actions-menu wording for
update/remove/share, catalog Add and listing detail page, and the job
detail header/overview description. Remove the info-icon and
info-dialog screenshots since that UI no longer exists; also drop the
listing-edit claim, which has no UI. Remaining screenshots predate the
redesign and should be retaken.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ob checkouts

Fileglancer apps are now pinned to an exact commit when added: jobs run
from an immutable per-commit checkout instead of a shared mutable clone,
updates move only the targeted app's pin (siblings in the same repo and
running jobs are unaffected), an "Update available" tag flags apps whose
source has newer commits, and job detail pages record the commit each
job executed. Update the user guide and authoring pages to match.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…params

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…st validation

- Document the new value_separator (space/equals) and boolean_style
  (flag/value) parameter fields and their effect on command building.
- Note that optional flagged parameters with an empty value are omitted
  entirely rather than emitted as --flag ''.
- Describe the Nextflow-safe forms forced at command-build time for
  'nextflow run' commands (equals separator, explicit booleans).
- Tighten the flag field description to the conservative CLI-flag
  pattern now enforced (one or two dashes, then letters/digits/_/./-).
- repo_url must parse as a GitHub URL and runnables requires at least
  one entry; both are now rejected at manifest load time.
…on fixes

- Nextflow apps are now named by repository only (rnaseq), not org/repo.
- Pipeline parameters emit --flag=value and explicit --flag=true/false,
  applied at command-build time so older cached manifests are fixed too;
  update the example command accordingly (extra args go at the end).
- Correct the Pixi naming rule: project metadata name first, then the
  Git repository name.
…bind sources

- Document the new apps.worker_env_passthrough setting and the
  allowlisted worker environment (FGC_* never passed through).
- Document apps.unknown_timeout_hours and the UNKNOWN status lifecycle
  from the admin's perspective.
- Note that ~/ container cache paths are expanded to the user's home.
- Clarify that container bind mounts come from the effective parameter
  values — manifest defaults and env_parameters included.
…ting edits

- Add a caution that apps run repository code as the user, shown when
  adding from a URL or the catalog.
- Document the UNKNOWN job status (treated as active, cancellable, not
  deletable) and the 24h default cutoff, plus a troubleshooting entry.
- New 'Deleting a Job' section: deletion removes the job's entire
  working directory including logs, behind a confirmation dialog.
- Note that large logs display only the trailing 5 MB and the full file
  is reachable through the file browser.
- Catalog: add-confirmation dialog shows source/sharer/date, listings
  are editable after sharing, and unshare asks for confirmation.
- Extra scheduler arguments are shell-tokenized (LSF resource strings
  work); relaunch preserves Environment-tab settings; launch-page
  install adds only the current app from a multi-app repo.
Co-authored-by: Codex <codex@openai.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant