Skip to content

feat(docs): Add workflow specification and schema#107

Closed
x1unix wants to merge 244 commits into
masterfrom
feat/add-spec
Closed

feat(docs): Add workflow specification and schema#107
x1unix wants to merge 244 commits into
masterfrom
feat/add-spec

Conversation

@x1unix

@x1unix x1unix commented May 28, 2026

Copy link
Copy Markdown
Member

This PR adds workflow file (gilbert.yaml) specification in markdown format and file schema definitions in following formats:

  • docs/spec/src/schema.d.ts: original source of truth schema in TypeScript.
  • docs/spec/schema.tsp: Schema in TypeSpec format. Used to generate JSON schema file. Generated from schema.d.ts.
  • docs/spec/gilbert.schema.json: Final JSON schema. Generated from TypeSpec schema.

The workflow formal spec is docs/spec/workflow.md.

Besides that, the PR includes following:

  • tools/post-process-schema.mjs: Script to patch JSON schema file for YAML language server support. See docs/man/schema_build.md for background.
  • docs/spec/src: Source files with original brainstorming info, used to generate spec.

@x1unix x1unix closed this May 28, 2026
@x1unix x1unix deleted the feat/add-spec branch May 28, 2026 05:09
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