Skip to content

docs(discern): add repository README and contributor setup - #6

Merged
kiro-systemf[bot] merged 1 commit into
mainfrom
docs-discern-readme-setup
Nov 7, 2026
Merged

kiro-systemf[bot] merged 1 commit into
mainfrom
docs-discern-readme-setup

Conversation

@systemfsoftware-maker

Copy link
Copy Markdown
Contributor

Summary

Readers can evaluate the published package and contributors can set up the source workspace using the root README and contributor guide.

Copy provenance

One approved Gemini browser operation used 3.8 Flash All-around help / Flash High: https://gemini.google.com/app/2646efedc0e35116. The output was treated as a draft and source-checked; flattened Markdown was restored and unsupported human-review and recovery wording was removed.

Verification

  • The fresh detached source setup succeeded with pnpm 12.9.0 and 447 packages; the tracked tree was clean at the source documentation commit. The two documentation files in this PR are byte-identical to that commit.
  • The consumer install used published @systemfsoftware/discern 1.0.0 with effect 4.1.2. The example exited 0 and printed block: rename User.id to User.key.
  • The write-readme-md scorer returned 5/13 for the root README. The score is not proof of factual correctness.
  • Fresh independent review at this PR head and required CI remain pending. The repository's pnpm check:local requirement remains pending off-host; it was not run as a full local gate. Mergify and default-main verification also remain pending.
Unaltered README scorer output
{
  "file": "README.md",
  "total": 5,
  "of": 13,
  "criteria": {
    "sections_5": {
      "pass": true,
      "count": 6
    },
    "sections_3": {
      "pass": true,
      "count": 6
    },
    "contributing": {
      "pass": true,
      "count": 1
    },
    "prose_density": {
      "pass": false,
      "count": 2.98
    },
    "relative_links": {
      "pass": true,
      "count": 4
    },
    "relative_links_3": {
      "pass": true,
      "count": 4
    },
    "emoji_3": {
      "pass": false,
      "count": 0
    },
    "emoji_10": {
      "pass": false,
      "count": 0
    },
    "emoji_20": {
      "pass": false,
      "count": 0
    },
    "details_3": {
      "pass": false,
      "count": 0
    },
    "tables_10": {
      "pass": false,
      "count": 0
    },
    "blockquote": {
      "pass": false,
      "count": 0
    },
    "blockquote_3": {
      "pass": false,
      "count": 0
    }
  }
}

@kiro-systemf kiro-systemf Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved only for the README.md / CONTRIBUTING.md documentation slice under signed plan 169f4737c06aec92b842980222886f33113c573f.

Independent exact-head review at ccf7b313c46688b88c1e4a6d46f61b903eb34ca0 completed clean: no P0/P1/P2/P3 findings. Required checks at this head are green, including the gate (pnpm check:ci); the docs-only test matrix was skipped, not run. The reviewer successfully re-executed the published-package Quick Start. Full source installation was not rerun, and the scorer prose-density formula was not re-derived; these remain disclosed coverage limits.

This approval does not satisfy full SYS-1163 acceptance. The constitution subtree, ordinary setup, and template license require a separately authorized protected-stage plan. The root item and Linear SYS-1163 remain In Progress. Post-merge default-main checks and artifact/provenance verification are still required.

@kiro-systemf

kiro-systemf Bot commented Nov 6, 2026

Copy link
Copy Markdown

@Mergifyio queue

@mergify

mergify Bot commented Nov 6, 2026

Copy link
Copy Markdown

queue

⚠️ Cannot use the command queue

Details

⚠ The product Merge Queue needs to be activated to enable this feature.

@kiro-systemf
kiro-systemf Bot merged commit b7cb9c3 into main Nov 7, 2026
10 checks passed
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