Skip to content

docs: note the authorized automated submission path in SPEC.md#1

Merged
MichaelTaylor3d merged 1 commit into
mainfrom
docs/submission-automated-path-226
Jul 4, 2026
Merged

docs: note the authorized automated submission path in SPEC.md#1
MichaelTaylor3d merged 1 commit into
mainfrom
docs/submission-automated-path-226

Conversation

@MichaelTaylor3d

Copy link
Copy Markdown
Contributor

What

Adds a normative note to SPEC.md (§1.1, cross-referenced from §7) that a listing's pull request MAY originate two ways, both governed identically by the existing validation contract:

  1. Manual — an author forks the repo and opens the PR by hand (the §7 checklist).
  2. Authorized automated path — an external, authorized service opens the PR on a submitter's behalf. In the DIG Network ecosystem this is the dApp-submission flow on hub.dig.net: a developer submits their dApp (metadata + assets, wallet as identity), a store maintainer approves, and on approval the hub authenticates to GitHub with a scoped, server-held token and opens a PR that adds apps/<slug>/metadata.json + the uploaded assets/ exactly per §2–§4.

The note is explicit that an automated PR is not privileged: featured MUST be false, it carries no special merge rights, and it MUST pass the same app.schema.json + CI validation gate (§3–§5) as any manual submission — so the store stays curated with no self-service publishing pipeline regardless of how a PR is opened (nothing ships without green CI + maintainer review). No secret or token value is embodied in the repository or the spec.

This is a spec-only prose change — no schema, listing, code, or behaviour change.

Version bump

Patch: 0.1.0 → 0.1.1 — docs-only, backwards-compatible, no public-API/schema/behaviour change.

How verified (local, mirrors CI ci.yml)

  • npm run validate:apps — spec gate: OK — 4 listing(s) conform to SPEC.md
  • npm run lint — 0 errors (4 pre-existing react-refresh warnings, unrelated)
  • npm run typecheck — clean
  • npm run test:coverage — green, coverage thresholds (≥80% lines/functions/branches/statements) met
  • npm run build — catalog + SPA + prerender + dist sanity gate all pass
  • npm run test:a11y — 46 Playwright a11y/SEO tests pass (axe WCAG 2.2 AA, desktop + mobile)
  • CI green on this PR (will monitor)

Add a normative note that a listing's pull request MAY originate two ways:
the manual fork+PR path (§7) or an authorized automated path — an external
authorized service (the hub.dig.net dApp-submission flow) opens an equivalent
PR on an admin-approved submitter's behalf, adding apps/<slug>/metadata.json +
assets per §2–§4. Both paths are governed identically by the same
app.schema.json + CI validation gate; an automated PR carries no merge
privilege, must have featured:false, and still requires green CI + maintainer
review — so the store remains curated with no self-service publishing pipeline.

Cross-referenced from the §7 author checklist. Spec-only prose change.

Bump: patch (0.1.0 -> 0.1.1) — docs-only, no behaviour or schema change.
@MichaelTaylor3d MichaelTaylor3d merged commit 5a95f8c into main Jul 4, 2026
3 checks passed
@MichaelTaylor3d MichaelTaylor3d deleted the docs/submission-automated-path-226 branch July 4, 2026 09:50
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