Every note in the Foundry.

cli/ (35)

• Cwl Utils cli-tool CWL document utilities. summarize-cwl uses cwl-normalizer to gather references and upgrade to v1.2 JSON.
• Cwltool cli-tool Reference CWL runner and validator. Used by summarize-cwl for entrypoint validation.
• Foundry cli-tool Foundry CLI: bundles all Mold IO validators and a summarize-nextflow subcommand.
• foundry check-workflow-brief cli-command Check Workflow Brief structure and stop on explicit workflow or agent environment blockers.
• foundry summarize-nextflow cli-command Statically introspect a Nextflow / nf-core pipeline tree and emit a validated JSON summary.
• foundry validate-galaxy-tool-discovery cli-command AJV gate for discover-shed-tool recommendation documents.
• foundry validate-galaxy-tool-summary cli-command AJV gate for galaxy-tool-cache summarize manifests, including the nested parsed_tool subtree.
• foundry validate-galaxy-workflow-test-plan cli-command AJV gate for Galaxy workflow test-plan YAML documents.
• foundry validate-markdown cli-command Validate Markdown sections with the schemas shared by Foundry build and runtime consumers.
• foundry validate-summary-cwl cli-command AJV gate for summarize-cwl JSON documents.
• foundry validate-summary-galaxy-workflow cli-command AJV gate for summarize-galaxy-workflow JSON documents.
• foundry validate-summary-nextflow cli-command AJV gate for summarize-nextflow JSON documents.
• foundry validate-tests-format cli-command AJV gate for Galaxy workflow tests YAML, with optional workflow cross-check.
• foundry validate-workflow-brief cli-command Validate the title and required sections of a Markdown Workflow Brief.
• Galaxy Tool Cache cli-tool Cache and inspect Galaxy tool metadata (fetch from ToolShed, summarize ParsedTool, export input JSON Schema).
• galaxy-tool-cache add cli-command Fetch a tool from the Tool Shed (shed-path or bare/stock id) and cache its ParsedTool locally for later summarize/schema.
• galaxy-tool-cache list cli-command Enumerate the tools in a cache directory with their resolved versions; the surface for confirming which stock/shed pin got cached.
• galaxy-tool-cache summarize cli-command Emit a deterministic galaxy-tool-summary manifest (cache provenance + embedded ParsedTool + generated input JSON Schemas) for a cached tool.
• Gxwf cli-tool Galaxy workflow design-time CLI (validate, convert, lint, roundtrip, tool-cache discovery).
• gxwf convert cli-command Convert a Galaxy workflow between native (.ga) and format2 (.gxwf.yml) representations.
• gxwf draft-extract cli-command Extract the concrete subset of a draft workflow: trim drafty steps, strip `_plan_*`, promote class when fully resolved.
• gxwf draft-next-step cli-command Pick the next drafty step a harness should work on, or report no remaining work; deterministic topological + alphabetical tiebreak.
• gxwf draft-validate cli-command Validate a `class: GalaxyWorkflowDraft` workflow against draft-contract rules; with --concrete, also validate the extracted concrete subset.
• gxwf tool-revisions cli-command Resolve a Tool Shed tool to changeset revisions for reproducible workflow pinning. Final step in discover-and-pin.
• gxwf tool-search cli-command Free-text Tool Shed search returning candidate tools as JSON; first step in the discover-and-pin sequence.
• gxwf tool-versions cli-command List TRS-published versions of a Tool Shed tool, oldest→newest. Second step in the discover-and-pin sequence.
• gxwf validate cli-command Validate Galaxy workflow structure, tool state, and optional connection compatibility before runtime execution.
• gxwf validate-tests cli-command Validate Galaxy workflow test files and optionally cross-check labels against their workflow.
• Planemo cli-tool Galaxy tool/workflow runtime testing CLI; used by run-workflow-test and friends.
• planemo cli_metadata cli-command Export structured metadata for Planemo CLI commands.
• planemo lint cli-command Check for common errors and best practices.
• planemo output_schema cli-command Export JSON Schemas for Planemo machine-readable outputs.
• planemo test cli-command Run specified tool or workflow tests within Galaxy.
• planemo workflow_test_init cli-command Initialize a Galaxy workflow test description for supplied workflow.
• planemo workflow_test_on_invocation cli-command Run defined tests against existing workflow invocation.

meta/ (17)

• Architecture Map meta A short map of the Foundry's major parts, boundaries, and focused architecture records.
• Build and Validation meta How authored Foundry source is checked, generated, cast, assembled, rendered, and kept current.
• Cast Walkthrough meta One real committed cast (discover-shed-tool) annotated end to end: every bundle file traced back through per-kind dispatch and _provenance.json.
• Compilation Pipeline meta How typed Mold references become target-specific cast artifacts with provenance.
• Code Architecture meta Implementation components, dependency direction, entry points, and contracts across the Foundry codebase.
• Comparisons meta Where the Foundry sits versus wikis, skill bundles, and the KB-to-skill landscape (MCP, Agent Skills, llms.txt, Corpus2Skill, RAG) — a dated snapshot.
• Content Model meta How Foundry notes, kinds, metadata, tags, links, references, and companions represent knowledge.
• Corpus Integration meta How IWC evidence grounds Foundry patterns and Molds without making the corpus part of the content model.
• Eval Philosophy meta Why eval.md is an abstract oracle and scenarios.md holds the concrete cases, and the eval/scenario/refinement split.
• Guiding Principles meta The design pressure behind source authority, progressive disclosure, validation, portability, and corpus grounding.
• Harness Pipelines meta The translation and lifecycle journeys that compose Molds, loops, branch phases, and harness-owned behavior.
• Mold Spec meta The Mold authoring contract: source layout, which files may sit beside index.md, and who enforces it.
• Molds meta The axes a Mold buckets on, the boundary against reference content, and where the Mold set is still uneven.
• Pattern Authorship Policy meta Developer-facing authorship rules for operation-named, corpus-grounded pattern pages.
• Repository Layout meta Where authored source, implementation code, generated artifacts, fixtures, and site files belong.
• Roadmap meta The current development direction of the Galaxy Workflow Foundry, grounded in live GitHub issue metadata.
• Schema Packages meta Where a Mold IO schema lives, how cast resolves one through a schema note, and why there is no separate schema package.

molds/ (50)

• advance-galaxy-draft-step mold Advance the gxformat2 draft by one step: pick the next drafty step, resolve a wrapper, implement the step, and validate.
• apply-galaxy-workflow-changeset mold Apply a reviewed change-set to a concrete Galaxy workflow: untouched regions preserved, tool-introducing edits injected as drafty steps.
• author-galaxy-tool-wrapper mold Author a new Galaxy user-defined tool YAML definition when discovery yields nothing acceptable.
• changeset-to-galaxy-test-plan mold Carry an existing Galaxy workflow's tests forward as a regression baseline and augment them for a change-set's deltas, emitting a Galaxy test plan.
• compare-against-iwc-exemplar mold Find nearest IWC exemplar(s) and surface a structural diff against the upstream Galaxy design briefs to guide template authoring.
• convert-nfcore-module-to-galaxy-tool mold Convert one nf-core module directory into a Galaxy wrapper with local macros, provenance, and remote fixture-backed tests.
• cwl-summary-to-galaxy-data-flow mold Translate a CWL summary into a Galaxy data-flow design brief.
• cwl-summary-to-galaxy-interface mold Map a CWL summary into a Galaxy workflow interface design brief.
• cwl-summary-to-galaxy-template mold gxformat2 skeleton with per-step TODOs from a CWL summary and prior Galaxy design briefs.
• cwl-test-to-galaxy-test-plan mold Translate CWL test fixtures into a Galaxy workflow test plan.
• cwl-to-test-data mold Resolve a CWL workflow's own declared test cases into Galaxy workflow test-data refs.
• debug-cwl-workflow-output mold Triage failing CWL run outputs; classify failure modes; propose fixes.
• debug-galaxy-workflow-output mold Triage failing Galaxy run outputs; classify the failure surface and capture evidence before recommending repairs.
• discover-shed-tool mold Search the Tool Shed for an existing wrapper, drill from hit to a pinnable changeset, classify candidates, and recommend or fall through.
• find-test-data mold Search IWC fixtures and public sources for test data matching a data-flow shape.
• freeform-summary-to-cwl-design mold Translate a free-form source summary into a CWL workflow design brief.
• freeform-summary-to-galaxy-data-flow mold Translate a free-form source summary into a Galaxy data-flow design brief.
• freeform-summary-to-galaxy-interface mold Map a free-form source summary into a Galaxy workflow interface design brief.
• freeform-summary-to-galaxy-template mold gxformat2 skeleton with per-step TODOs from a free-form summary and Galaxy design brief.
• freeform-summary-to-galaxy-test-plan mold Synthesize a Galaxy workflow test plan from a free-form summary and the Galaxy design briefs.
• implement-cwl-tool-step mold Convert an abstract step into a concrete CWL CommandLineTool + step.
• implement-cwl-workflow-test mold Assemble CWL job file(s) and expected-output assertions.
• implement-galaxy-tool-step mold Convert an abstract step into a concrete gxformat2 step using a tool summary.
• implement-galaxy-workflow-test mold Assemble Galaxy workflow test fixtures and assertions.
• interview-to-freeform-summary mold Normalize a free-form user interview into the shared freeform-summary workflow handoff.
• interview-to-galaxy-workflow-changeset mold Interview a user against an existing Galaxy workflow summary and emit a reviewable, step-anchored change-set.
• mature-galaxy-workflow-for-iwc mold Apply the IWC publication checklist to an existing Galaxy workflow and emit a generalized, reviewable submission set.
• nextflow-summary-to-cwl-data-flow mold Translate a Nextflow summary into a CWL data-flow design brief.
• nextflow-summary-to-cwl-interface mold Map a Nextflow summary into a CWL Workflow interface design brief.
• nextflow-summary-to-galaxy-data-flow mold Translate a Nextflow summary into a Galaxy data-flow design brief.
• nextflow-summary-to-galaxy-interface mold Map a Nextflow summary into a Galaxy workflow interface design brief.
• nextflow-summary-to-galaxy-reference-data mold Decide the Galaxy-side shape of external reference data declared by a Nextflow pipeline.
• nextflow-summary-to-galaxy-template mold gxformat2 skeleton with per-step TODOs from a Nextflow summary and prior Galaxy design briefs.
• nextflow-test-to-cwl-test-plan mold Translate Nextflow test evidence into a CWL workflow test plan.
• nextflow-test-to-galaxy-test-plan mold Translate Nextflow test evidence into a Galaxy workflow test plan.
• nextflow-to-test-data mold Resolve a Nextflow pipeline's own declared test fixtures into Galaxy workflow test-data refs.
• paper-to-test-data mold Derive workflow test inputs and expected outputs from a paper.
• repair-galaxy-draft-topology mold Re-wire a Galaxy draft region when a step's declared output can't be computed from its wired inputs.
• report-foundry-run-feedback mold Triage a completed or partial Foundry feedback ledger into a run review and confirmed, deduplicated upstream issue drafts.
• review-galaxy-workflow mold Apply the pinned upstream IWC review policy to one Galaxy workflow or pull request and emit one evidenced advisory Markdown review.
• run-workflow-test mold Execute a workflow's tests via Planemo; emit structured pass/fail and outputs.
• summarize-cwl mold Validate and normalize a CWL Workflow tree, then emit a lightweight structured summary for downstream Galaxy translation.
• summarize-cwl-tool mold Derive a CommandLineTool description (container, baseCommand, IO) for a CWL target.
• summarize-galaxy-tool mold Pull JSON schema, container, source, inputs/outputs for a Galaxy tool.
• summarize-galaxy-workflow mold Read an existing Galaxy gxformat2 (or .ga) workflow and emit a structured summary for interview and change-set steps.
• summarize-nextflow mold Read a Nextflow pipeline source tree (nf-core or ad-hoc DSL2) and emit a structured JSON summary for downstream translation Molds.
• summarize-paper mold Extract methods, tools, sample data, and references from a paper.
• summary-to-cwl-template mold CWL Workflow skeleton with per-step TODOs from source and design handoffs.
• validate-cwl mold Run cwltool --validate / schema lint, classify failures, recommend fixes.
• validate-galaxy-workflow mold Run terminal gxwf validation on an assembled Galaxy workflow and classify workflow-level failures.

patterns/ (54)

• Cleanup, sync, and publish non-empty results pattern Clean sparse mapped outputs, keep sibling collections aligned, then gate report publishing on non-empty results.
• Collection: build list paired with Apply Rules pattern Use Apply Rules to promote identifier columns into a list:paired collection, with optional cleanup first.
• Collection: build named bundle pattern Use BUILD_LIST to assemble named outputs into a collection bundle for publishing or downstream fan-in.
• Collection: cleanup after map-over failure pattern Use FILTER_EMPTY or FILTER_FAILED after map-over when bad elements would break downstream collection steps.
• Collection: flatten after fan-out pattern Use FLATTEN to collapse nested collection outputs to a flat list once the outer axis no longer matters.
• Collection: split identifier via rules pattern Use Apply Rules regex columns to split one collection identifier into nested list identifiers.
• Collection: swap nesting with Apply Rules pattern Use Apply Rules to regroup a list:list collection by swapping outer and inner identifier columns.
• Collection: unbox singleton pattern Use __EXTRACT_DATASET__ with which: first when a one-element collection must become a dataset.
• Parameter: compose runtime text parameter pattern Use compose_text_param to build connected text expressions from constants plus runtime scalar values.
• Conditional: gate on non-empty result pattern Derive a boolean from empty or non-empty data, then use when to skip reporting or export steps.
• Conditional: route between alternative outputs pattern Use when-gated alternatives plus pick_value to merge binary or one-of-N routes into one downstream value.
• Conditional: run optional step pattern Use a workflow boolean connected as inputs.when to skip an optional Galaxy step or branch.
• Conditional: transform or pass through pattern Gate an optional transform, then use pick_value to pass transformed data when present or original data otherwise.
• Parameter: derive from file pattern Read a one-value dataset with param_value_from_file, including count recipes that feed typed parameters.
• Fan-in bundle, consume, and flatten pattern Bundle parallel outputs into a collection consumer, then flatten nested results for pooled downstream processing.
• Galaxy: collection patterns pattern Choose a Galaxy collection operation or map-over recipe from the current and required data shapes.
• Galaxy: conditionals patterns pattern Choose a Galaxy when gate, routed output, fallback, or collection cleanup by what must change downstream.
• Galaxy: genomic interval patterns pattern Use this MOC to choose corpus-grounded Galaxy genomic interval operations and recipes on coordinate features.
• Galaxy: sequence patterns pattern Use this MOC to choose corpus-grounded Galaxy operations on sequence records (FASTA) — interconvert, reformat, merge, length, extract/mask by region.
• Galaxy: tabular patterns pattern Use this MOC to choose corpus-grounded Galaxy tabular transformation patterns.
• Collection: harmonize by sortlist from identifiers pattern Use SORTLIST with sort_type:file to reorder one collection by another collection's identifiers.
• Interval: consensus regions by multi-intersect pattern Find features reproducible across replicates: multi-intersect per-replicate sets, threshold by replicate count, then intersect back against the merged call.
• Interval: compute coverage pattern Two coverage modes: genome-wide depth as a bedgraph (genomecoveragebed) and reads counted in given regions (coveragebed). Same family, different question.
• Interval: build a mask by set algebra pattern Compute regions from regions: concatenate candidate intervals, merge into non-overlapping spans, then subtract the set to keep. The gops_* set-algebra recipe.
• Interval: merge overlapping features pattern Collapse overlapping or book-ended intervals within one set into single spans; bedtools mergebed or the gops_merge Operate-on-Genomic-Intervals tool.
• Interval: filter or annotate by overlap pattern Keep, drop, or annotate coordinate features by overlap with a second feature set; bedtools intersect (BED) or vcfvcfintersect (VCF), mapped over a collection.
• Interval: window or flank features pattern Extend features by a fixed or fractional amount to build neighborhood windows, clamped to chromosome ends; bedtools slopbed with a genome file.
• Interval: windowed coverage around features pattern Quantify signal in fixed neighborhoods around point features: window the features (slop), collapse overlaps (merge), then count reads in each window (coverage).
• Manifest to mapped collection lifecycle pattern Use a manifest or table to build a collection, map a tool per row, then relabel or reshape outputs.
• Parameter: map workflow enum to tool parameter pattern Use map_param_value to translate workflow enum values into downstream tool codes, flags, or snippets.
• Collection: regex relabel via tabular pattern Derive collection element identifiers in a tabular mapping, then apply them with RELABEL_FROM_FILE.
• Sequence: relabel FASTA headers via tabular pattern Edit FASTA headers you cannot easily regex in place: fasta2tab, rewrite column 1 with find/replace, then tab2fasta back. The high-value sequence recipe.
• Collection: relabel via rules and find/replace pattern Use Apply Rules, identifier extraction, find/replace, and relabeling for structural fan-out cleanup.
• Reshape, relabel, and remap by collection axis pattern Use Apply Rules and deterministic relabeling when domain fan-out creates the wrong map-over axis.
• Sequence: compute record lengths pattern Emit a (id, length) table from a FASTA so downstream tabular steps can filter, sort, or threshold records by length; fasta_compute_length.
• Sequence: extract or mask by region pattern Turn coordinates into sequence: extract FASTA at BED intervals (getfasta), mask regions by BED (maskfasta), or extract transcripts from a GFF (gffread).
• Sequence: interconvert FASTA and tabular pattern Move sequence records between FASTA and a (header, sequence) table so tabular tools can edit them; fasta2tab one way, tab2fasta back.
• Sequence: merge FASTA and filter unique pattern Concatenate several FASTA files into one and drop duplicate records by sequence identity in a single step; fasta_merge_files_and_filter_unique_sequences.
• Sequence: reformat FASTA line width pattern Rewrap FASTA records to a fixed sequence-line width so downstream tools and viewers get canonical 60/70/80-column output; cshl_fasta_formatter.
• Collection: sync collections by identifier pattern Use collection_element_identifiers with FILTER_FROM_FILE or RELABEL_FROM_FILE to align sibling collections.
• Tabular: compute a new column pattern Use column_maker (Add_a_column1) with strict error_handling to insert/replace a computed column. Per-expression-kind auto_col_types rule.
• Tabular: concatenate collection to table pattern Use collapse_dataset to row-bind a collection of tabulars into one table, with optional element IDs and header dedupe.
• Tabular: cut and reorder columns pattern Use Cut1 with a comma-separated cN list to project — and reorder — columns. Listing out of order is the canonical reorder idiom.
• Tabular: filter rows by column value pattern Use Filter1 with a Python expression over cN columns to drop rows. Highest-frequency tabular row filter in IWC.
• Tabular: filter rows by regex pattern Use tp_grep_tool for whole-line regex row filters on tabular input. Grep1 is the legacy alternative.
• Tabular: group and aggregate pattern Use datamash_ops for grouped tabular aggregation: multi-column grouping, collapse, countunique, min/max, and reductions.
• Tabular: join on key pattern Use tp_easyjoin_tool for two-tabular key joins; use tp_multijoin_tool for many files and query_tabular for SQL joins.
• Tabular: pivot collection to wide pattern Use collection_column_join to outer-join a collection of 2-column id/value tables into one wide table.
• Tabular: prepend header pattern Use tp_awk_tool to prepend a constant header line, optionally skipping or reformatting an existing first row.
• Tabular: relabel by row counter pattern Use tp_awk_tool to replace each row or label with deterministic sample_N values from awk NR.
• Tabular: split taxonomy string pattern Use tp_awk_tool to split semicolon-delimited taxonomy strings into explicit rank columns with missing-rank handling.
• Tabular: SQL query pattern Use query_tabular when SQL semantics justify it: windows, joins, anti-joins, or fused project+compute over tabulars.
• Tabular: synthesize BED from 3-column input pattern Use tp_awk_tool to convert chrom/start/end rows into 6-column BED, subtracting 1 from start and setting constants.
• Tabular: to collection by row pattern Use split_file_to_collection split_by:col to fan a tabular into collection elements by row/key.

pipelines/ (9)

• CWL → GALAXY pipeline Translate a CWL Workflow into a Galaxy gxformat2 workflow, then assemble and run a Galaxy workflow test.
• GALAXY WORKFLOW MATURATION pipeline Apply the pinned IWC publication checklist to an existing Galaxy workflow, then validate and retest the matured result.
• GALAXY WORKFLOW REVIEW pipeline Post-construction review journey: summarize, validate, and test an existing Galaxy workflow, then apply pinned IWC policy.
• INTERVIEW → GALAXY pipeline Interview-driven path to a Galaxy gxformat2 workflow through the shared freeform-summary handoff.
• NEXTFLOW → CWL pipeline Direct path from a Nextflow pipeline to a CWL Workflow + CommandLineTool set.
• NEXTFLOW → GALAXY pipeline Direct path from a Nextflow pipeline to a Galaxy gxformat2 workflow.
• PAPER → CWL pipeline Direct path from a paper to a CWL Workflow + CommandLineTool set.
• PAPER → GALAXY pipeline Direct path from a paper to a Galaxy gxformat2 workflow. No CWL intermediate.
• UPDATE-INTERVIEW → GALAXY pipeline Interview-driven, edit-in-place modification of an existing Galaxy gxformat2 workflow via a reviewable change-set, reusing the per-step draft loop.

prompts/ (5)

• Galaxy custom tool container critic prompt Vendored Galaxy internal prompt inferring the conda packages a generated custom tool needs.
• Galaxy custom tool critic prompt Vendored Galaxy internal prompt for critiquing generated custom tool definitions.
• Galaxy custom tool structured generator prompt Vendored Galaxy internal prompt for generating structured custom tool definitions.
• IWC Copilot workflow review instructions prompt Vendored IWC repository instructions that guide Copilot reviews of workflow contributions.
• IWC workflow pull request review command prompt Vendored IWC command for reviewing a workflow pull request against the contributor and reviewer checklist.

research/ (69)

• Component Archon research Archon remains a heavy-harness candidate; HITL gates are stronger, but per-step sub-DAG looping is still the main gap.
• Component Claude Dynamic Workflows research Dynamic workflows natively solve the per-step sub-DAG loop Archon couldn't, with schema-typed step handoffs; cost is in-session-only resume and no mid-run gate.
• CWL workflow anatomy research CWL structure relevant to summarize-cwl: normalized documents, steps, scatter, conditionals, requirements, and dependency handling.
• Component Nextflow Channel Operators research Structured digest of Nextflow channel operators (47 entries) with cardinality and shape semantics; backs summarize-nextflow §6 edge reconciliation.
• Component Nextflow Containers And Envs research Container URL grammar (depot, BioContainers, mulled-v2, Wave, ORAS) and conda directive resolution rules backing summarize-nextflow §5.
• Component Nextflow Inspect research White paper on Nextflow's native introspection subcommands — `nextflow inspect`, `nextflow config`, and adjacent tooling. Survey, not decision.
• Component Nextflow Pipeline Anatomy research Stub. DSL2 layout, channel idioms, operator-chain reading rules. Grows from cast contact with rnaseq/sarek/ad-hoc — see issue #17.
• Component Nextflow Testing research nf-test patterns mapped to Galaxy planemo asserts and CWL test equivalents — backs the nextflow test-plan Molds and summarize-nextflow §7.
• Component Nf Core Module Conventions research RFC 2119 conventions enforced by nf-core/tools module lint, with lint-check pointers. Backs summarize-nextflow + author-galaxy-tool-wrapper.
• Component Nf Core Tools research White paper on nf-core/tools — conventions, CLI surface, schema universe, container resolution. Survey, not decision.
• Component Tool Shed Search research Tool Shed's Whoosh repo/tool search and partial GA4GH TRS v2, indexed from hg-walked metadata with no auto-refresh on upload
• CWL pickValue → Galaxy pick_value (post galaxy#22222) research CWL `pickValue` (first_non_null / the_only_non_null / all_non_null) → Galaxy's native `pick_value` workflow step added by galaxyproject/galaxy#22222.
• CWL v1.2 schema documents research Vendored official CWL v1.2.1 JSON/SALAD schema documents used as source-structure reference for CWL summarization.
• CWL when:/pickValue → Galaxy branching translation research CWL `when:`/`pickValue` → Galaxy. Three honest translations (paired_or_unpaired input, native pick_value step, sibling workflows) plus how to pick among them.
• Foundry feedback ledger research Runtime protocol for carrying actionable feedback about Foundry assets, and the related projects a run exercises, from cast skills back to Foundry maintainers.
• Galaxy Apply Rules DSL research Reference for Galaxy's Apply Rules DSL: rule operations, mapping operations, composition patterns, pitfalls.
• Galaxy collection semantics research Vendored formal spec of Galaxy dataset-collection mapping/reduction semantics, with labeled examples and pinned test references.
• Galaxy collection-operation tools research Catalog of Galaxy's collection-operation tools — purpose, IO, parameters, selection guide. Companion to galaxy-collection-semantics.
• Galaxy data-flow draft contract research Defines the proposed boundary between Galaxy data-flow drafts, gxformat2 templates, and concrete step implementation.
• Galaxy datatypes registry sample research Vendored Galaxy datatypes registry sample: extension → datatype class mapping, sniff order, converters, and display applications.
• Galaxy <discover_datasets> research Reference for the <discover_datasets> Galaxy XML element — attributes, named/regex patterns, <data> vs <collection> contexts, test assertions.
• Galaxy native workflow (.ga) structural JSON Schema research Vendored structural JSON Schema for Galaxy native workflow (.ga) format: vocabulary for the JSON shape Galaxy emits and consumes.
• Galaxy paired_or_unpaired collection type research Galaxy's `paired_or_unpaired` collection type: discriminated-union shape for paired-or-single reads, no workflow-level mode switch needed. Galaxy PR #19377.
• Galaxy sample_sheet collection types research Galaxy's sample_sheet collection family: typed column metadata, four variants, mapping rules, validator allowlist.
• Galaxy tool and job failure reference research Reference for Galaxy tool stdio rules, job failure detection, job states, and job API failure surfaces.
• Galaxy tool summary input source research Decides that summarize-galaxy-tool reads cached ParsedTool JSON as its v1 input source.
• Galaxy user-defined tool authoring rules research What validates in a GalaxyUserTool definition — fields, expression syntax, script placement, package inference — derived from Galaxy's own generator prompts.
• Galaxy user-defined tool critique criteria research What to flag in a structurally-valid GalaxyUserTool definition, what to leave alone, and when a fix is structural.
• Galaxy Workflow Comments research How to annotate a gxformat2 workflow with editor comments: one titled frame per analysis stage, populate contains_steps, color decorative.
• Galaxy workflow draft format research gxformat2 draft superset: wrapper-tier TODOs (tool_id, state, port names) plus _plan_state / _plan_context / _plan_in / _plan_out per tool step.
• Galaxy workflow invocation failure reference research Reference for Galaxy workflow invocation states, messages, failure reasons, and invocation API surfaces.
• Galaxy Workflow Testability Design research Design guidance for Galaxy workflow inputs, outputs, and checkpoints that make IWC-style workflow tests possible.
• Galaxy tool XML schema research Vendored Galaxy tool XML schema for wrapper structure, parameters, outputs, tests, and assertion syntax.
• gxformat2 structural JSON Schema research Vendored gxformat2 structural schema, its input, output, and step vocabulary, and the limits of schema-only validation.
• gxformat2 workflow inputs research Conceptual model, current aliases, and schema gaps for gxformat2 workflow inputs.
• Alignment: gxy-sketches ↔ Galaxy Workflow Foundry research Where the Foundry's per-source summary Molds align with gxy-sketches on field names and source/test-fixture vocabulary, and where they intentionally do not.
• Iwc Comments Survey research How IWC uses the gxformat2 `comments:` array: titled stage frames dominate, color is decorative, frames travel with template forks. An authoring convention.
• Iwc Conditionals Survey research Corpus survey of Galaxy conditional step usage in IWC, covering when-gates, boolean shims, and routed output selection.
• Iwc Interval Operations Survey research IWC corpus survey of coordinate-aware genomic interval operations; sizing and candidate boundaries for a galaxy-interval-patterns MOC, with hold-if-thin gate.
• Iwc Map Over Lifecycle Survey research Survey of IWC map-over lifecycle recipes, with a Nextflow-to-Galaxy crosswalk for collection construction, cleanup, reshape, reduce, and publish phases.
• Iwc Parameter Derivation Survey research Corpus survey of Galaxy workflow recipes that turn upstream data, metadata, or small files into runtime parameters.
• Iwc Runtime Parameter Shims Survey research Focused survey of tiny IWC runtime parameter shims for flags, enums, counts, booleans, and composed text.
• Iwc Sequence Operations Survey research IWC survey of record-level FASTA manipulation (interconversion, reformat, merge/dedup, subset, extract-at-intervals); sizes a galaxy-sequence-patterns MOC.
• Iwc Shortcuts Anti Patterns research Judgments for when weak Galaxy workflow-test assertions are useful smoke checks and when they conceal untested results.
• Iwc Tabular Operations Survey research Corpus survey of tabular tools and operations across IWC workflows; map for the operation pattern hierarchy on row/column data manipulation.
• Iwc Test Data Conventions research IWC and Planemo workflow-test fixture shapes, file provenance, collection identifiers, input hashes, and built-in index values.
• Iwc Transformations Survey research Corpus survey of collection-shape transformations across IWC: built-in collection ops, toolshed transformers, and the multi-step recipes that bracket map-over.
• Iwc Workflow Testability Survey research IWC evidence survey for Galaxy workflow structures that make workflow tests meaningful.
• Markdown Document Contract research Declarative Markdown section schemas and a shared parser for Foundry build checks and runtime artifact validation.
• Nextflow conditional to Galaxy subworkflow / when research Stub. Translate Nextflow conditionals into Galaxy `when:` (single-workflow v1). Subworkflow vs inline is an aesthetic call, not a rule.
• Nextflow operators to Galaxy collection recipes research Classifies common Nextflow operators as Galaxy wiring, collection semantics, explicit steps, or review triggers.
• Nextflow params to Galaxy workflow inputs research Rules for translating Nextflow params, sample sheets, channels, and control flags into gxformat2 inputs.
• Nextflow path/glob to Galaxy datatype mapping research Rules for mapping Nextflow path, glob, sample-sheet, and output filename evidence to Galaxy datatype extensions.
• Nextflow reference-data classification research Source-side taxonomy of how Nextflow pipelines use reference data — eight classifications detectable from a summary-nextflow artifact.
• Nextflow nf-test snapshots to Galaxy/Planemo assertions research Translates nf-test snapshot assertions into Galaxy workflow test-format assertions, broken out by module-level vs pipeline-level test shape.
• Selecting the first Nextflow test case research A deterministic policy for choosing the first whole-pipeline Nextflow test case without mistaking profile names for coverage.
• Nextflow-to-Galaxy channel shape mapping research Maps common Nextflow channel, tuple, and path shapes to Galaxy dataset and collection shapes.
• Nextflow to Galaxy reference-data mapping research Galaxy-side translation of Nextflow reference-data classifications: idioms available, the v1 posture, datatype defaults, and the in-tool rebuild trade-off.
• Nextflow workflow I/O semantics research Defines Nextflow workflow inputs and outputs from docs plus observed fixture pipeline structures.
• nf-schema sample sheet validation gaps in Galaxy research nf-schema validation mapped to Galaxy column_definitions: what survives, degrades, or is lost; Galaxy work items + cast loss-recording vocabulary.
• nf-core channel input → Galaxy data / collection research Map an nf-core process's tuple(meta, path) input channel to a Galaxy <param type="data"> or paired/list collection input.
• nf-core meta-map → Galaxy params research Promote nf-core meta-map keys to Galaxy <param>s only when they drive script behavior; drop identity-only keys; pull naming from $input.element_identifier.
• nf-core stub: block → Galaxy (intentional drop) research nf-core's stub: block has no Galaxy analog; the convert Mold drops it intentionally and records the drop in _provenance.yml.
• nf-core task.ext.args → Galaxy additional-options bag research Map nf-core's task.ext.args escape hatch to a single Galaxy text param surfacing extra command-line arguments.
• nf-core versions emit → Galaxy <version_command> research Translate nf-core's versions emit (heredoc or topic: versions) into Galaxy's <version_command>, dropping the versions output channel.
• Open-requirements ledger research Carried unresolved-requirements artifact the source→Galaxy pipeline discharges or explicitly surrenders, autonomously.
• Planemo Asserts Idioms research Choose Galaxy workflow-test output assertions by the failure they should catch, the output's stability, and the available checkpoints.
• Planemo workflow-test architecture research Reference for Planemo workflow test/run architecture, Galaxy modes, API polling, and noisy failure boundaries.
• Workflow Brief research Markdown Workflow Brief definition and section contract for scope, constraints, agent environment, and explicit blockers.

schemas/ (14)

• Cast provenance (_provenance.json, schema v4) schema _provenance.json contract beside every cast: Mold revision, per-ref src/dst hashes, license lineage, artifact handoff. Schema v4 — deterministic casts only.
• Galaxy tool discovery recommendation schema JSON Schema for Tool Shed discovery hit, weak, and miss recommendations.
• Galaxy tool summary manifest schema JSON Schema for the deterministic per-tool manifest emitted by `galaxy-tool-cache summarize`.
• Galaxy workflow draft (gxformat2 superset) schema JSON Schema for `class: GalaxyWorkflowDraft` — gxformat2 with `TODO_*` sentinels and `_plan_*` planning fields per draft step.
• Galaxy workflow test plan schema JSON Schema for the intermediate Galaxy workflow test-plan handoff produced by the test-plan Molds and consumed by implement-galaxy-workflow-test.
• Nextflow parameter schema (nf-schema meta-schema) schema JSON Schema (Draft 2020-12) meta-schema validating per-pipeline nextflow_schema.json files. Upstream from nextflow-io/nf-schema.
• nf-core module meta.yml schema schema JSON Schema (Draft-07) validating nf-core module meta.yml — channel IO, tools, containers, conda lockfiles. Upstream from nf-core/modules.
• nf-core subworkflow meta.yml schema schema JSON Schema (Draft-07) validating nf-core subworkflow meta.yml — channel IO, components dependencies, authors. Upstream from nf-core/modules.
• Galaxy ParsedTool schema JSON Schema for the upstream Galaxy `ParsedTool` model, vendored from `@galaxy-tool-util/schema`.
• Planemo test report (JSON) schema JSON Schema for the report emitted by `planemo test --test_output_json` (and friends), vendored from upstream planemo.
• CWL workflow summary schema JSON Schema for the structured summary emitted by the summarize-cwl Mold.
• Galaxy workflow summary schema JSON Schema for the structured summary emitted by the summarize-galaxy-workflow Mold.
• Nextflow pipeline summary schema JSON Schema for the structured summary emitted by the summarize-nextflow Mold.
• Galaxy workflow test format schema JSON Schema for the planemo workflow test format (`<workflow>-tests.yml`), vendored from `@galaxy-tool-util/schema`.

source-patterns/ (7)

• Nextflow: branch, filter, and ifEmpty to Galaxy filters and gates source-pattern Route Nextflow branch, filter, and ifEmpty channel idioms to Galaxy collection cleanup, identifier filters, when gates, or review.
• Nextflow: grouped channel to regrouped Galaxy collection source-pattern Route Nextflow groupTuple, transpose, and grouped tuple payloads to Galaxy collection reshape patterns when the key is a real axis.
• Nextflow: keyed join/combine(by:) to identifier-synchronized map-over source-pattern Route Nextflow keyed joins and combine(by:) pairings to Galaxy collection identifier sync, ordering, relabeling, or table joins.
• Nextflow: mapped output cleanup and publishing source-pattern Route Nextflow mapped-output cleanup and publishDir-style intent to Galaxy filtering, relabeling, gating, bundling, and reports.
• Nextflow: mix and collect to report aggregation source-pattern Route Nextflow mix, collect, toList, and collectFile report fan-in idioms to Galaxy aggregation and bundle patterns.
• Nextflow: source pattern map source-pattern Use this source-pattern map to route recurring Nextflow channel and operator idioms to Galaxy implementation patterns.
• Nextflow: samplesheet rows to Galaxy collections source-pattern Route Nextflow samplesheet row streams and repeated tuple inputs to Galaxy list, paired, or list:paired collections.

docs/ (17)