Skip to content

chore(release): v1.1.0 with a validated single-source release version - #8

Merged
TheStreamCode merged 3 commits into
mainfrom
release/v1.1.0
Aug 2, 2026
Merged

chore(release): v1.1.0 with a validated single-source release version#8
TheStreamCode merged 3 commits into
mainfrom
release/v1.1.0

Conversation

@TheStreamCode

@TheStreamCode TheStreamCode commented Aug 1, 2026

Copy link
Copy Markdown
Owner

Summary

  • Prepare the public Agent Skill for v1.1.0 and keep package.json, SKILL.md metadata, CITATION.cff, the README badge, the dated changelog, and issue metadata synchronized.
  • Make package.json the validated release-version source of truth and remove the hardcoded activation version from the host-smoke runner.
  • Preflight every managed init destination before the first write, preventing late path conflicts from leaving partial scaffolding.
  • Reject contradictory currentPhase and stage-gate decision metadata before state-changing commands can persist an invalid workflow.
  • Stop repository Markdown validation from following symlinked directories; required files must be regular files.
  • Restrict disposable repository test copies to project-owned roots and report malformed package.json content as a validation finding instead of crashing.
  • Add a dated v1.1.0 security review and synchronize README, SECURITY.md, CHANGELOG.md, AGENTS.md, and release guidance.

Versioning: minor bump under SemVer for the additive workflow 1.1 contract. Existing workflow 1.0 state remains readable, the v1 artifact layout is unchanged, and v0.3 workspaces remain preserved and rejected rather than migrated.

Validation

Local environment: Windows 11, Node.js 24.18.0, npm 11.16.0, Python 3.12.10, GitHub CLI 2.96.0.

  • npm run check: repository validation passed; 33 tests, 30 passed, 0 failed, 3 skipped because Windows symlink creation returned EPERM; benchmark passed.
  • Benchmark package: 18 files, 86,693 bytes; p95 init 60.27 ms, status 60.24 ms, validate 58.99 ms, all within guardrails.
  • Hash-pinned official Agent Skills validator: valid skill, exit 0.
  • gh skill publish --dry-run: passed, exit 0.
  • Local gh skill install smoke: 18 files installed into a disposable custom directory; installed CLI help and official validation passed; no artifact secret pattern found; temporary copy removed.
  • Syntax, diff, Git integrity, tracked-secret pattern, and dependency inventory checks completed; the runtime dependency tree is empty.
  • Host discovery smoke executed but was inconclusive: GitHub Copilot CLI and OpenCode were not installed, so zero eligible checks ran and exit 3 was preserved. No model-backed smoke was run.
  • Remote CI and CodeQL on eaa0e0f: 12/12 checks passed across Node.js 20/22/24, Linux, Windows, macOS, specification/discovery, performance, Actions analysis, JavaScript analysis, and aggregate quality.

Compatibility And Safety Notes

  • Breaking workflow or state change: none.
  • Workflow versions read/written: new runs write 1.1; existing 1.0 state remains readable.
  • Host compatibility impact: none beyond metadata version alignment; no host-specific allowed-tools were introduced.
  • Authorization or safety impact: stronger local path/state validation only; no new network, credential, deployment, or external-mutation capability.
  • Security evidence: evals/security-review-v1.1.0.md records fixed findings and residual limits.
  • GitHub release immutability is now enabled at repository level and verified through the official API. Existing v1.0.0 remains mutable; v1.1.0 must be checked after publication.

Release State And Remaining Gate

  • Head commit: eaa0e0f.
  • The branch and PR are pushed and all required automated checks are green.
  • Main requires one approving review and resolved conversations. This PR remains blocked only by review; no protection bypass or direct main push was used.
  • Tag v1.1.0, GitHub Release, and public gh skill publication have not been created. They must be produced from the reviewed merge commit and verified immutable.

Existing Commit Metadata

The first two pre-existing commits on this branch contain AI co-author trailers that conflict with the current AGENTS.md convention. Their history was not rewritten. Prefer squash merge with a clean maintainer-authored message so the main-branch commit follows repository policy.

TheStreamCode and others added 3 commits August 1, 2026 21:55
…truth

The repository validator hardcoded the literal 1.0.0 for package.json,
SKILL.md metadata, and CITATION.cff, and never checked the README badge or
the changelog at all, even though RELEASING.md requires all five to be
aligned. A partial bump therefore passed the local gate. The model-backed
host smoke had the same defect: it asserted a hardcoded
"DISCOVERED agentic-rd-skill 1.0.0" marker that a release bump would
silently invalidate.

package.json is now the single source of truth. The validator derives the
expected version from it and fails when SKILL.md metadata, CITATION.cff,
the README version badge, or a dated CHANGELOG.md release section
disagrees. The host smoke reads the shipped SKILL.md frontmatter instead.

Also scope the validator's Markdown walk to tracked product source: it no
longer descends into the documented local .venv or treats the ignored
project-brief.md dogfood artifact as source, so link validation stops
depending on the contributor's local environment, and a directory whose
name ends in .md is no longer misread as a file.

Adds regression tests that mutate a copied repository tree to prove drift
is reported on every synchronized surface.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Workflow contract 1.1 has been on main since the previous release but was
still described as unreleased. Promote the accumulated Unreleased section
to a dated 1.1.0 entry and align every synchronized surface: package.json,
skills/agentic-rd-skill/SKILL.md metadata, CITATION.cff, the README version
badge, and the bug-report template placeholder.

Minor bump: additive workflow contract 1.1, validator and host-smoke
hardening, and documentation. Workflow 1.0 state remains readable, the v1
artifact layout and CLI surface are unchanged, and no breaking change is
introduced.

Also record the known issues carried into this release (Windows EPERM
symlink test skips and the environment-dependent, not-rerun host smoke)
and refresh the deterministic-check date to the day the gate was actually
rerun.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@TheStreamCode
TheStreamCode enabled auto-merge (squash) August 1, 2026 21:38
@TheStreamCode
TheStreamCode merged commit eaa0e0f into main Aug 2, 2026
12 checks passed
@TheStreamCode
TheStreamCode deleted the release/v1.1.0 branch August 2, 2026 09:20
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