@t275005746/gse 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/ISSUE_TEMPLATE/bug_report.yml +42 -42
- package/.github/ISSUE_TEMPLATE/change_request.yml +50 -50
- package/.github/ISSUE_TEMPLATE/config.yml +5 -5
- package/.github/PULL_REQUEST_TEMPLATE.md +38 -38
- package/.github/workflows/validate-gse.yml +33 -33
- package/.gse/README.md +18 -18
- package/.gse/gse-development-protocol.md +50 -50
- package/.gse/project-profile.md +29 -29
- package/.gse/quality-gates.md +25 -25
- package/.gse/releases/public-registry-publication-npm.md +49 -0
- package/.gse/releases/public-release-owner-required.md +65 -65
- package/.gse/releases/public-security-contact-owner-required.md +45 -45
- package/.gse/state.json +3 -4
- package/CHANGELOG.md +24 -24
- package/CONTRIBUTING.md +64 -64
- package/LICENSE +21 -21
- package/README.md +1 -1
- package/README.zh-CN.md +1 -1
- package/SECURITY.md +41 -41
- package/SUPPORT.md +38 -38
- package/assets/marketplace/README.md +7 -7
- package/assets/marketplace/gse-listing.json +75 -75
- package/assets/templates/acceptance-execution-packet.md +73 -73
- package/assets/templates/adr.md +14 -14
- package/assets/templates/change-brief.md +16 -16
- package/assets/templates/design.md +18 -18
- package/assets/templates/dispatch-packet.md +104 -104
- package/assets/templates/evidence.md +14 -14
- package/assets/templates/execution-quality-pack.md +65 -65
- package/assets/templates/goal-map.md +21 -21
- package/assets/templates/host-adapter.md +48 -48
- package/assets/templates/host-ui-invocation-record.md +42 -42
- package/assets/templates/incident-review.md +60 -60
- package/assets/templates/public-channel-publication-record.md +49 -49
- package/assets/templates/public-ci-run-record.md +53 -53
- package/assets/templates/public-release-record.md +65 -65
- package/assets/templates/public-repository-settings-record.md +59 -59
- package/assets/templates/public-security-contact-record.md +45 -45
- package/assets/templates/release-trust-record.md +32 -32
- package/assets/templates/review.md +18 -18
- package/assets/templates/spec.md +16 -16
- package/assets/templates/target-adoption-evidence.md +29 -29
- package/assets/templates/tasks.md +17 -17
- package/assets/templates/update-release-acceptance-record.md +58 -58
- package/examples/README.md +22 -22
- package/examples/agent-runtime-host/.claude/gse-adapter.md +6 -6
- package/examples/agent-runtime-host/.codex/gse-adapter.md +7 -7
- package/examples/agent-runtime-host/.gse/goal-map.md +7 -7
- package/examples/agent-runtime-host/.gse/project-profile.md +27 -27
- package/examples/agent-runtime-host/.gse/tooling.md +5 -5
- package/examples/agent-runtime-host/.mcp.json +9 -9
- package/examples/agent-runtime-host/AGENTS.md +5 -5
- package/examples/agent-runtime-host/README.md +10 -10
- package/examples/agent-runtime-host/docs/model-routing.md +5 -5
- package/examples/cli-tool/.gse/project-profile.md +21 -21
- package/examples/cli-tool/AGENTS.md +5 -5
- package/examples/cli-tool/README.md +12 -12
- package/examples/cli-tool/package.json +21 -21
- package/examples/small-app/.env.example +2 -2
- package/examples/small-app/.github/workflows/ci.yml +8 -8
- package/examples/small-app/AGENTS.md +5 -5
- package/examples/small-app/README.md +12 -12
- package/examples/small-app/package.json +26 -26
- package/examples/small-app/playwright.config.ts +4 -4
- package/package.json +53 -53
- package/references/adoption-recipes.md +171 -171
- package/references/agent-roles.md +49 -49
- package/references/architecture-health.md +101 -101
- package/references/benchmark-audit.md +73 -73
- package/references/community-channels.md +46 -46
- package/references/compatibility.md +70 -70
- package/references/design-basis.md +38 -38
- package/references/domain-model.md +129 -129
- package/references/domain-quality-gates.md +75 -75
- package/references/drift-audit.md +81 -81
- package/references/evidence-taxonomy.md +123 -123
- package/references/file-ownership.md +107 -107
- package/references/final-readiness.md +84 -84
- package/references/forward-test.md +133 -133
- package/references/goal-map.md +36 -36
- package/references/host-adapters.md +119 -119
- package/references/learning-system.md +35 -35
- package/references/marketplace-discovery.md +46 -46
- package/references/model-routing.md +103 -103
- package/references/open-source-defaults.md +39 -39
- package/references/operating-model.md +52 -52
- package/references/packaging.md +277 -277
- package/references/project-agent-workspace.md +89 -89
- package/references/project-bootstrap.md +122 -122
- package/references/project-profile.md +57 -57
- package/references/public-release.md +174 -174
- package/references/quality-gates.md +100 -100
- package/references/recovery.md +176 -176
- package/references/release-trust.md +43 -43
- package/references/release.md +126 -126
- package/references/review.md +141 -141
- package/references/router.md +90 -90
- package/references/spec-workflow.md +66 -66
- package/references/task-levels.md +81 -81
- package/references/tool-adapters.md +73 -73
- package/scripts/audit-acceptance-execution-packet.mjs +133 -133
- package/scripts/audit-adoption-recipes.mjs +99 -99
- package/scripts/audit-change-lifecycle.mjs +77 -77
- package/scripts/audit-change-system.mjs +134 -134
- package/scripts/audit-ci-readiness.mjs +107 -107
- package/scripts/audit-close-gate.mjs +323 -323
- package/scripts/audit-command-adapters.mjs +91 -91
- package/scripts/audit-command-execution.mjs +210 -210
- package/scripts/audit-compatibility.mjs +149 -149
- package/scripts/audit-completion-readiness.mjs +292 -292
- package/scripts/audit-distribution.mjs +251 -251
- package/scripts/audit-domain-quality-gates.mjs +108 -108
- package/scripts/audit-evidence-placeholders.mjs +126 -126
- package/scripts/audit-final-readiness-promotion.mjs +255 -255
- package/scripts/audit-final-readiness.mjs +226 -226
- package/scripts/audit-fixtures.mjs +154 -154
- package/scripts/audit-fresh-session-readiness.mjs +177 -177
- package/scripts/audit-host-runtime-evidence-handoff.mjs +159 -159
- package/scripts/audit-host-runtime-invocation-drill.mjs +240 -240
- package/scripts/audit-host-runtime-invocations.mjs +254 -254
- package/scripts/audit-host-ui-invocation.mjs +132 -132
- package/scripts/audit-marketplace-discovery.mjs +122 -122
- package/scripts/audit-npm-package-metadata.mjs +155 -155
- package/scripts/audit-npm-publish-dry-run.mjs +191 -169
- package/scripts/audit-npm-tarball-install.mjs +191 -191
- package/scripts/audit-open-source-defaults.mjs +92 -92
- package/scripts/audit-open-source-readiness.mjs +97 -97
- package/scripts/audit-project.mjs +138 -138
- package/scripts/audit-public-acceptance-command-dry-run-drill.mjs +203 -203
- package/scripts/audit-public-acceptance-readiness.mjs +224 -224
- package/scripts/audit-public-channel-publication.mjs +248 -248
- package/scripts/audit-public-ci-run.mjs +184 -184
- package/scripts/audit-public-collaboration-templates.mjs +98 -98
- package/scripts/audit-public-external-gate-probe.mjs +206 -206
- package/scripts/audit-public-release-decision.mjs +201 -201
- package/scripts/audit-public-release-metadata.mjs +176 -176
- package/scripts/audit-public-repository-settings.mjs +237 -237
- package/scripts/audit-public-security-contact.mjs +171 -171
- package/scripts/audit-readme-docs.mjs +6 -4
- package/scripts/audit-recovery-readiness.mjs +98 -98
- package/scripts/audit-release-readiness.mjs +106 -106
- package/scripts/audit-release-trust.mjs +62 -62
- package/scripts/audit-remote-distribution.mjs +266 -266
- package/scripts/audit-roadmap-consistency.mjs +235 -235
- package/scripts/audit-signing.mjs +147 -147
- package/scripts/audit-state-freshness.mjs +14 -9
- package/scripts/audit-target-adoption-evidence.mjs +117 -117
- package/scripts/audit-target-project.mjs +507 -507
- package/scripts/audit-update-release-acceptance.mjs +136 -136
- package/scripts/audit-v1-target-validation.mjs +269 -269
- package/scripts/audit-validation-profiles.mjs +125 -125
- package/scripts/close-change.mjs +116 -116
- package/scripts/discover-project-profile.mjs +307 -307
- package/scripts/generate-command-adapter.mjs +231 -231
- package/scripts/generate-final-acceptance-packet.mjs +181 -181
- package/scripts/generate-final-form-progress-report.mjs +205 -205
- package/scripts/generate-host-runtime-evidence-handoff.mjs +206 -206
- package/scripts/generate-owner-external-gate-kit.mjs +295 -295
- package/scripts/generate-public-acceptance-handoff.mjs +168 -168
- package/scripts/generate-public-release-checklist.mjs +207 -207
- package/scripts/generate-release-bundle.mjs +505 -505
- package/scripts/generate-release-owner-action-plan.mjs +172 -172
- package/scripts/generate-release-status-manifest.mjs +200 -200
- package/scripts/generate-session-prompt.mjs +188 -188
- package/scripts/gse.mjs +67 -67
- package/scripts/init-change.mjs +265 -265
- package/scripts/init-project.mjs +785 -785
- package/scripts/install-gse.mjs +234 -234
- package/scripts/lib/evidence-placeholders.mjs +28 -28
- package/scripts/package-gse.mjs +174 -174
- package/scripts/probe-public-external-gates.mjs +167 -167
- package/scripts/record-host-invocation.mjs +151 -151
- package/scripts/record-public-channel-publication.mjs +178 -178
- package/scripts/record-public-ci-run.mjs +180 -180
- package/scripts/record-public-release.mjs +175 -175
- package/scripts/record-public-repository-settings.mjs +209 -209
- package/scripts/record-public-security-contact.mjs +157 -157
- package/scripts/sign-gse-package.mjs +83 -83
- package/scripts/update-project-state.mjs +223 -223
- package/scripts/verify-gse-package.mjs +85 -85
|
@@ -1,42 +1,42 @@
|
|
|
1
|
-
name: Bug report
|
|
2
|
-
description: Report a reproducible GSE workflow, install, validation, or host-adapter issue.
|
|
3
|
-
title: "[Bug]: "
|
|
4
|
-
labels: ["bug", "needs-evidence"]
|
|
5
|
-
body:
|
|
6
|
-
- type: textarea
|
|
7
|
-
id: outcome
|
|
8
|
-
attributes:
|
|
9
|
-
label: Outcome
|
|
10
|
-
description: What should have happened?
|
|
11
|
-
validations:
|
|
12
|
-
required: true
|
|
13
|
-
- type: textarea
|
|
14
|
-
id: actual
|
|
15
|
-
attributes:
|
|
16
|
-
label: Actual behavior
|
|
17
|
-
description: What happened instead?
|
|
18
|
-
validations:
|
|
19
|
-
required: true
|
|
20
|
-
- type: textarea
|
|
21
|
-
id: reproduce
|
|
22
|
-
attributes:
|
|
23
|
-
label: Reproduction
|
|
24
|
-
description: Minimal commands, project shape, or host steps.
|
|
25
|
-
placeholder: |
|
|
26
|
-
node scripts/validate-gse.mjs --root . --json
|
|
27
|
-
validations:
|
|
28
|
-
required: true
|
|
29
|
-
- type: textarea
|
|
30
|
-
id: evidence
|
|
31
|
-
attributes:
|
|
32
|
-
label: Evidence
|
|
33
|
-
description: Focused logs, audit output, host invocation record, or screenshots. Do not paste secrets.
|
|
34
|
-
validations:
|
|
35
|
-
required: true
|
|
36
|
-
- type: textarea
|
|
37
|
-
id: risk
|
|
38
|
-
attributes:
|
|
39
|
-
label: Risk and claim boundary
|
|
40
|
-
description: Note whether this affects install, release, public CI, native slash commands, or host support claims.
|
|
41
|
-
validations:
|
|
42
|
-
required: true
|
|
1
|
+
name: Bug report
|
|
2
|
+
description: Report a reproducible GSE workflow, install, validation, or host-adapter issue.
|
|
3
|
+
title: "[Bug]: "
|
|
4
|
+
labels: ["bug", "needs-evidence"]
|
|
5
|
+
body:
|
|
6
|
+
- type: textarea
|
|
7
|
+
id: outcome
|
|
8
|
+
attributes:
|
|
9
|
+
label: Outcome
|
|
10
|
+
description: What should have happened?
|
|
11
|
+
validations:
|
|
12
|
+
required: true
|
|
13
|
+
- type: textarea
|
|
14
|
+
id: actual
|
|
15
|
+
attributes:
|
|
16
|
+
label: Actual behavior
|
|
17
|
+
description: What happened instead?
|
|
18
|
+
validations:
|
|
19
|
+
required: true
|
|
20
|
+
- type: textarea
|
|
21
|
+
id: reproduce
|
|
22
|
+
attributes:
|
|
23
|
+
label: Reproduction
|
|
24
|
+
description: Minimal commands, project shape, or host steps.
|
|
25
|
+
placeholder: |
|
|
26
|
+
node scripts/validate-gse.mjs --root . --json
|
|
27
|
+
validations:
|
|
28
|
+
required: true
|
|
29
|
+
- type: textarea
|
|
30
|
+
id: evidence
|
|
31
|
+
attributes:
|
|
32
|
+
label: Evidence
|
|
33
|
+
description: Focused logs, audit output, host invocation record, or screenshots. Do not paste secrets.
|
|
34
|
+
validations:
|
|
35
|
+
required: true
|
|
36
|
+
- type: textarea
|
|
37
|
+
id: risk
|
|
38
|
+
attributes:
|
|
39
|
+
label: Risk and claim boundary
|
|
40
|
+
description: Note whether this affects install, release, public CI, native slash commands, or host support claims.
|
|
41
|
+
validations:
|
|
42
|
+
required: true
|
|
@@ -1,50 +1,50 @@
|
|
|
1
|
-
name: Change request
|
|
2
|
-
description: Propose a GSE capability, adapter, gate, template, or workflow change.
|
|
3
|
-
title: "[Change]: "
|
|
4
|
-
labels: ["change", "needs-spec"]
|
|
5
|
-
body:
|
|
6
|
-
- type: textarea
|
|
7
|
-
id: goal
|
|
8
|
-
attributes:
|
|
9
|
-
label: Goal
|
|
10
|
-
description: What durable GSE capability should become true?
|
|
11
|
-
validations:
|
|
12
|
-
required: true
|
|
13
|
-
- type: textarea
|
|
14
|
-
id: spec
|
|
15
|
-
attributes:
|
|
16
|
-
label: Spec
|
|
17
|
-
description: Outcome, scope, acceptance, evidence, risk, and next action.
|
|
18
|
-
placeholder: |
|
|
19
|
-
Outcome:
|
|
20
|
-
Scope:
|
|
21
|
-
Acceptance:
|
|
22
|
-
Evidence:
|
|
23
|
-
Risk:
|
|
24
|
-
Next action:
|
|
25
|
-
validations:
|
|
26
|
-
required: true
|
|
27
|
-
- type: dropdown
|
|
28
|
-
id: level
|
|
29
|
-
attributes:
|
|
30
|
-
label: Task level
|
|
31
|
-
options:
|
|
32
|
-
- lite
|
|
33
|
-
- standard
|
|
34
|
-
- enterprise
|
|
35
|
-
validations:
|
|
36
|
-
required: true
|
|
37
|
-
- type: textarea
|
|
38
|
-
id: tools
|
|
39
|
-
attributes:
|
|
40
|
-
label: Tool or host impact
|
|
41
|
-
description: Which hosts, scripts, adapters, CI, package, marketplace, or release gates are affected?
|
|
42
|
-
validations:
|
|
43
|
-
required: true
|
|
44
|
-
- type: textarea
|
|
45
|
-
id: evidence
|
|
46
|
-
attributes:
|
|
47
|
-
label: Proposed evidence
|
|
48
|
-
description: Which focused audit, test, or external record would prove this?
|
|
49
|
-
validations:
|
|
50
|
-
required: true
|
|
1
|
+
name: Change request
|
|
2
|
+
description: Propose a GSE capability, adapter, gate, template, or workflow change.
|
|
3
|
+
title: "[Change]: "
|
|
4
|
+
labels: ["change", "needs-spec"]
|
|
5
|
+
body:
|
|
6
|
+
- type: textarea
|
|
7
|
+
id: goal
|
|
8
|
+
attributes:
|
|
9
|
+
label: Goal
|
|
10
|
+
description: What durable GSE capability should become true?
|
|
11
|
+
validations:
|
|
12
|
+
required: true
|
|
13
|
+
- type: textarea
|
|
14
|
+
id: spec
|
|
15
|
+
attributes:
|
|
16
|
+
label: Spec
|
|
17
|
+
description: Outcome, scope, acceptance, evidence, risk, and next action.
|
|
18
|
+
placeholder: |
|
|
19
|
+
Outcome:
|
|
20
|
+
Scope:
|
|
21
|
+
Acceptance:
|
|
22
|
+
Evidence:
|
|
23
|
+
Risk:
|
|
24
|
+
Next action:
|
|
25
|
+
validations:
|
|
26
|
+
required: true
|
|
27
|
+
- type: dropdown
|
|
28
|
+
id: level
|
|
29
|
+
attributes:
|
|
30
|
+
label: Task level
|
|
31
|
+
options:
|
|
32
|
+
- lite
|
|
33
|
+
- standard
|
|
34
|
+
- enterprise
|
|
35
|
+
validations:
|
|
36
|
+
required: true
|
|
37
|
+
- type: textarea
|
|
38
|
+
id: tools
|
|
39
|
+
attributes:
|
|
40
|
+
label: Tool or host impact
|
|
41
|
+
description: Which hosts, scripts, adapters, CI, package, marketplace, or release gates are affected?
|
|
42
|
+
validations:
|
|
43
|
+
required: true
|
|
44
|
+
- type: textarea
|
|
45
|
+
id: evidence
|
|
46
|
+
attributes:
|
|
47
|
+
label: Proposed evidence
|
|
48
|
+
description: Which focused audit, test, or external record would prove this?
|
|
49
|
+
validations:
|
|
50
|
+
required: true
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
blank_issues_enabled: false
|
|
2
|
-
contact_links:
|
|
3
|
-
- name: Support boundary
|
|
4
|
-
url: https://github.com/
|
|
5
|
-
about: Read SUPPORT.md before filing broad usage questions. Replace this placeholder URL when the public repository URL is owner-approved.
|
|
1
|
+
blank_issues_enabled: false
|
|
2
|
+
contact_links:
|
|
3
|
+
- name: Support boundary
|
|
4
|
+
url: https://github.com/
|
|
5
|
+
about: Read SUPPORT.md before filing broad usage questions. Replace this placeholder URL when the public repository URL is owner-approved.
|
|
@@ -1,38 +1,38 @@
|
|
|
1
|
-
## Outcome
|
|
2
|
-
|
|
3
|
-
What does this change make true for GSE users or maintainers?
|
|
4
|
-
|
|
5
|
-
## Scope
|
|
6
|
-
|
|
7
|
-
Changed files or areas:
|
|
8
|
-
|
|
9
|
-
-
|
|
10
|
-
|
|
11
|
-
Out of scope:
|
|
12
|
-
|
|
13
|
-
-
|
|
14
|
-
|
|
15
|
-
## Acceptance
|
|
16
|
-
|
|
17
|
-
How should reviewers know this is complete?
|
|
18
|
-
|
|
19
|
-
-
|
|
20
|
-
|
|
21
|
-
## Evidence
|
|
22
|
-
|
|
23
|
-
Commands, logs, screenshots, or records:
|
|
24
|
-
|
|
25
|
-
- [ ] `node scripts/validate-gse.mjs --root . --json`
|
|
26
|
-
- [ ] Focused audit or test:
|
|
27
|
-
|
|
28
|
-
## Risk
|
|
29
|
-
|
|
30
|
-
Residual risk, unsupported claims, migration notes, or rollback path:
|
|
31
|
-
|
|
32
|
-
-
|
|
33
|
-
|
|
34
|
-
## Claim Boundary
|
|
35
|
-
|
|
36
|
-
- [ ] This PR does not claim public release acceptance unless owner/public evidence is attached.
|
|
37
|
-
- [ ] This PR does not claim host-native support unless a host invocation record is attached.
|
|
38
|
-
- [ ] This PR does not duplicate `.gse/` policy in host-specific folders.
|
|
1
|
+
## Outcome
|
|
2
|
+
|
|
3
|
+
What does this change make true for GSE users or maintainers?
|
|
4
|
+
|
|
5
|
+
## Scope
|
|
6
|
+
|
|
7
|
+
Changed files or areas:
|
|
8
|
+
|
|
9
|
+
-
|
|
10
|
+
|
|
11
|
+
Out of scope:
|
|
12
|
+
|
|
13
|
+
-
|
|
14
|
+
|
|
15
|
+
## Acceptance
|
|
16
|
+
|
|
17
|
+
How should reviewers know this is complete?
|
|
18
|
+
|
|
19
|
+
-
|
|
20
|
+
|
|
21
|
+
## Evidence
|
|
22
|
+
|
|
23
|
+
Commands, logs, screenshots, or records:
|
|
24
|
+
|
|
25
|
+
- [ ] `node scripts/validate-gse.mjs --root . --json`
|
|
26
|
+
- [ ] Focused audit or test:
|
|
27
|
+
|
|
28
|
+
## Risk
|
|
29
|
+
|
|
30
|
+
Residual risk, unsupported claims, migration notes, or rollback path:
|
|
31
|
+
|
|
32
|
+
-
|
|
33
|
+
|
|
34
|
+
## Claim Boundary
|
|
35
|
+
|
|
36
|
+
- [ ] This PR does not claim public release acceptance unless owner/public evidence is attached.
|
|
37
|
+
- [ ] This PR does not claim host-native support unless a host invocation record is attached.
|
|
38
|
+
- [ ] This PR does not duplicate `.gse/` policy in host-specific folders.
|
|
@@ -1,33 +1,33 @@
|
|
|
1
|
-
name: Validate GSE
|
|
2
|
-
|
|
3
|
-
on:
|
|
4
|
-
pull_request:
|
|
5
|
-
push:
|
|
6
|
-
branches:
|
|
7
|
-
- main
|
|
8
|
-
- master
|
|
9
|
-
workflow_dispatch:
|
|
10
|
-
|
|
11
|
-
jobs:
|
|
12
|
-
validate:
|
|
13
|
-
name: Validate skill package
|
|
14
|
-
runs-on: ubuntu-latest
|
|
15
|
-
timeout-minutes: 15
|
|
16
|
-
|
|
17
|
-
steps:
|
|
18
|
-
- name: Checkout
|
|
19
|
-
uses: actions/checkout@v4
|
|
20
|
-
|
|
21
|
-
- name: Setup Node.js
|
|
22
|
-
uses: actions/setup-node@v4
|
|
23
|
-
with:
|
|
24
|
-
node-version: "20"
|
|
25
|
-
|
|
26
|
-
- name: Run GSE validation
|
|
27
|
-
run: node scripts/validate-gse.mjs --root . --skip-skill-validator --json
|
|
28
|
-
|
|
29
|
-
- name: Audit final readiness boundaries
|
|
30
|
-
run: node scripts/audit-final-readiness.mjs --root . --json
|
|
31
|
-
|
|
32
|
-
- name: Audit final acceptance packet
|
|
33
|
-
run: node scripts/audit-final-acceptance-packet.mjs --root . --json
|
|
1
|
+
name: Validate GSE
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
pull_request:
|
|
5
|
+
push:
|
|
6
|
+
branches:
|
|
7
|
+
- main
|
|
8
|
+
- master
|
|
9
|
+
workflow_dispatch:
|
|
10
|
+
|
|
11
|
+
jobs:
|
|
12
|
+
validate:
|
|
13
|
+
name: Validate skill package
|
|
14
|
+
runs-on: ubuntu-latest
|
|
15
|
+
timeout-minutes: 15
|
|
16
|
+
|
|
17
|
+
steps:
|
|
18
|
+
- name: Checkout
|
|
19
|
+
uses: actions/checkout@v4
|
|
20
|
+
|
|
21
|
+
- name: Setup Node.js
|
|
22
|
+
uses: actions/setup-node@v4
|
|
23
|
+
with:
|
|
24
|
+
node-version: "20"
|
|
25
|
+
|
|
26
|
+
- name: Run GSE validation
|
|
27
|
+
run: node scripts/validate-gse.mjs --root . --skip-skill-validator --json
|
|
28
|
+
|
|
29
|
+
- name: Audit final readiness boundaries
|
|
30
|
+
run: node scripts/audit-final-readiness.mjs --root . --json
|
|
31
|
+
|
|
32
|
+
- name: Audit final acceptance packet
|
|
33
|
+
run: node scripts/audit-final-acceptance-packet.mjs --root . --json
|
package/.gse/README.md
CHANGED
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
# GSE Self-Development Workspace
|
|
2
|
-
|
|
3
|
-
This folder tracks development of the GSE skill itself.
|
|
4
|
-
|
|
5
|
-
Read order:
|
|
6
|
-
|
|
7
|
-
1. `SKILL.md`
|
|
8
|
-
2. `.gse/state.json`
|
|
9
|
-
3. `.gse/project-profile.md`
|
|
10
|
-
4. `.gse/goal-map.md`
|
|
11
|
-
5. `.gse/quality-gates.md`
|
|
12
|
-
6. `.gse/current-slice.md`
|
|
13
|
-
7. `.gse/gse-design-master-plan.md`
|
|
14
|
-
8. `.gse/evidence/index.jsonl`
|
|
15
|
-
|
|
16
|
-
The canonical product plan is `.gse/gse-design-master-plan.md`.
|
|
17
|
-
|
|
18
|
-
Keep this folder short and evidence-driven. Long command output belongs in terminal logs, not in roadmap files.
|
|
1
|
+
# GSE Self-Development Workspace
|
|
2
|
+
|
|
3
|
+
This folder tracks development of the GSE skill itself.
|
|
4
|
+
|
|
5
|
+
Read order:
|
|
6
|
+
|
|
7
|
+
1. `SKILL.md`
|
|
8
|
+
2. `.gse/state.json`
|
|
9
|
+
3. `.gse/project-profile.md`
|
|
10
|
+
4. `.gse/goal-map.md`
|
|
11
|
+
5. `.gse/quality-gates.md`
|
|
12
|
+
6. `.gse/current-slice.md`
|
|
13
|
+
7. `.gse/gse-design-master-plan.md`
|
|
14
|
+
8. `.gse/evidence/index.jsonl`
|
|
15
|
+
|
|
16
|
+
The canonical product plan is `.gse/gse-design-master-plan.md`.
|
|
17
|
+
|
|
18
|
+
Keep this folder short and evidence-driven. Long command output belongs in terminal logs, not in roadmap files.
|
|
@@ -1,50 +1,50 @@
|
|
|
1
|
-
# GSE Development Protocol
|
|
2
|
-
|
|
3
|
-
This file governs changes to the GSE skill itself.
|
|
4
|
-
|
|
5
|
-
## Purpose
|
|
6
|
-
|
|
7
|
-
GSE development must be proactive. When improving this skill, do not wait for the user to discover missing workflow requirements through manual testing.
|
|
8
|
-
|
|
9
|
-
## Required Loop For GSE Changes
|
|
10
|
-
|
|
11
|
-
1. Read `SKILL.md`, `.gse/goal-map.md`, and `.gse/current-slice.md`.
|
|
12
|
-
2. Classify the GSE change: wording, reference, template, script, scaffold, adapter, validation, or release.
|
|
13
|
-
3. Run or update `references/benchmark-audit.md` for any non-trivial change.
|
|
14
|
-
4. Compare against verified mature sources before adding design goals.
|
|
15
|
-
5. Separate verified facts, design judgments, and open questions.
|
|
16
|
-
6. Prefer scripts/templates over prose when the behavior should be repeatable.
|
|
17
|
-
7. Validate the changed behavior with focused smoke tests.
|
|
18
|
-
8. Update `.gse/evidence/YYYY-MM-DD.md` and the short goal map status.
|
|
19
|
-
|
|
20
|
-
## Benchmark Sources To Check First
|
|
21
|
-
|
|
22
|
-
- `skill-creator` for skill structure, progressive disclosure, validation, and forward testing.
|
|
23
|
-
- `mattpocock/skills` snapshot for setup skill, router, domain docs, TDD, review, and architecture scan patterns.
|
|
24
|
-
- `comet` for state machine, phase detection, OpenSpec/Superpowers split, verification, and archive rules.
|
|
25
|
-
- `openspec-*` for proposal/design/tasks/spec lifecycle.
|
|
26
|
-
- `agentic-engineering` for eval-first loop, decomposition, model routing, session strategy, and cost discipline.
|
|
27
|
-
- `subagent-driven-development` for role isolation, dispatch packets, review loops, and no fake delegation.
|
|
28
|
-
- `self-improvement` for reusable learning capture and promotion.
|
|
29
|
-
|
|
30
|
-
## Design Bar
|
|
31
|
-
|
|
32
|
-
A GSE change should improve at least one of these:
|
|
33
|
-
|
|
34
|
-
- New-agent startup success.
|
|
35
|
-
- Long-project continuity.
|
|
36
|
-
- Requirement completeness before implementation.
|
|
37
|
-
- Evidence quality.
|
|
38
|
-
- Tool efficiency without hard prerequisites.
|
|
39
|
-
- Cross-agent portability.
|
|
40
|
-
- Failure prevention or recovery.
|
|
41
|
-
- Learning reuse.
|
|
42
|
-
|
|
43
|
-
## Anti-Patterns
|
|
44
|
-
|
|
45
|
-
- Adding process because it sounds professional but does not prevent a real failure.
|
|
46
|
-
- Copying a tool-specific folder layout as the portable source of truth.
|
|
47
|
-
- Treating optional tools as required.
|
|
48
|
-
- Claiming a benchmark source says something without reading it.
|
|
49
|
-
- Letting GSE become only documentation with no scripts, templates, or validation.
|
|
50
|
-
|
|
1
|
+
# GSE Development Protocol
|
|
2
|
+
|
|
3
|
+
This file governs changes to the GSE skill itself.
|
|
4
|
+
|
|
5
|
+
## Purpose
|
|
6
|
+
|
|
7
|
+
GSE development must be proactive. When improving this skill, do not wait for the user to discover missing workflow requirements through manual testing.
|
|
8
|
+
|
|
9
|
+
## Required Loop For GSE Changes
|
|
10
|
+
|
|
11
|
+
1. Read `SKILL.md`, `.gse/goal-map.md`, and `.gse/current-slice.md`.
|
|
12
|
+
2. Classify the GSE change: wording, reference, template, script, scaffold, adapter, validation, or release.
|
|
13
|
+
3. Run or update `references/benchmark-audit.md` for any non-trivial change.
|
|
14
|
+
4. Compare against verified mature sources before adding design goals.
|
|
15
|
+
5. Separate verified facts, design judgments, and open questions.
|
|
16
|
+
6. Prefer scripts/templates over prose when the behavior should be repeatable.
|
|
17
|
+
7. Validate the changed behavior with focused smoke tests.
|
|
18
|
+
8. Update `.gse/evidence/YYYY-MM-DD.md` and the short goal map status.
|
|
19
|
+
|
|
20
|
+
## Benchmark Sources To Check First
|
|
21
|
+
|
|
22
|
+
- `skill-creator` for skill structure, progressive disclosure, validation, and forward testing.
|
|
23
|
+
- `mattpocock/skills` snapshot for setup skill, router, domain docs, TDD, review, and architecture scan patterns.
|
|
24
|
+
- `comet` for state machine, phase detection, OpenSpec/Superpowers split, verification, and archive rules.
|
|
25
|
+
- `openspec-*` for proposal/design/tasks/spec lifecycle.
|
|
26
|
+
- `agentic-engineering` for eval-first loop, decomposition, model routing, session strategy, and cost discipline.
|
|
27
|
+
- `subagent-driven-development` for role isolation, dispatch packets, review loops, and no fake delegation.
|
|
28
|
+
- `self-improvement` for reusable learning capture and promotion.
|
|
29
|
+
|
|
30
|
+
## Design Bar
|
|
31
|
+
|
|
32
|
+
A GSE change should improve at least one of these:
|
|
33
|
+
|
|
34
|
+
- New-agent startup success.
|
|
35
|
+
- Long-project continuity.
|
|
36
|
+
- Requirement completeness before implementation.
|
|
37
|
+
- Evidence quality.
|
|
38
|
+
- Tool efficiency without hard prerequisites.
|
|
39
|
+
- Cross-agent portability.
|
|
40
|
+
- Failure prevention or recovery.
|
|
41
|
+
- Learning reuse.
|
|
42
|
+
|
|
43
|
+
## Anti-Patterns
|
|
44
|
+
|
|
45
|
+
- Adding process because it sounds professional but does not prevent a real failure.
|
|
46
|
+
- Copying a tool-specific folder layout as the portable source of truth.
|
|
47
|
+
- Treating optional tools as required.
|
|
48
|
+
- Claiming a benchmark source says something without reading it.
|
|
49
|
+
- Letting GSE become only documentation with no scripts, templates, or validation.
|
|
50
|
+
|
package/.gse/project-profile.md
CHANGED
|
@@ -1,29 +1,29 @@
|
|
|
1
|
-
# Project Profile
|
|
2
|
-
|
|
3
|
-
## Product
|
|
4
|
-
|
|
5
|
-
GSE is a portable Goal-Spec-Evidence Engineering skill for long-running agent-assisted software projects.
|
|
6
|
-
|
|
7
|
-
## Canonical Plan
|
|
8
|
-
|
|
9
|
-
- Master plan: `.gse/gse-design-master-plan.md`
|
|
10
|
-
- Goal map: `.gse/goal-map.md`
|
|
11
|
-
- Current slice: `.gse/current-slice.md`
|
|
12
|
-
- Evidence index: `.gse/evidence/index.jsonl`
|
|
13
|
-
|
|
14
|
-
## Commands
|
|
15
|
-
|
|
16
|
-
- Full validation: `node scripts/validate-gse.mjs --root <skill-root> --json`
|
|
17
|
-
- Structural audit: `node scripts/audit-gse.mjs --root <skill-root> --json`
|
|
18
|
-
- Change pack audit: `node scripts/audit-change-system.mjs --root <skill-root> --json`
|
|
19
|
-
- Close gate: `node scripts/audit-close-gate.mjs --target <skill-root> --json`
|
|
20
|
-
|
|
21
|
-
## Tool Notes
|
|
22
|
-
|
|
23
|
-
- This skill folder is not a git repository.
|
|
24
|
-
- Use `py` instead of bare `python` for skill validator commands on this machine.
|
|
25
|
-
- Keep OpenSpec, Superpowers, Comet, subagents, MCP, LSP, and browser automation optional unless current-session evidence proves they are available.
|
|
26
|
-
|
|
27
|
-
## Ownership
|
|
28
|
-
|
|
29
|
-
Do not mark GSE v1.0 complete until configured target-project evidence confirms real consumption or an explicit owner acceptance policy replaces that requirement.
|
|
1
|
+
# Project Profile
|
|
2
|
+
|
|
3
|
+
## Product
|
|
4
|
+
|
|
5
|
+
GSE is a portable Goal-Spec-Evidence Engineering skill for long-running agent-assisted software projects.
|
|
6
|
+
|
|
7
|
+
## Canonical Plan
|
|
8
|
+
|
|
9
|
+
- Master plan: `.gse/gse-design-master-plan.md`
|
|
10
|
+
- Goal map: `.gse/goal-map.md`
|
|
11
|
+
- Current slice: `.gse/current-slice.md`
|
|
12
|
+
- Evidence index: `.gse/evidence/index.jsonl`
|
|
13
|
+
|
|
14
|
+
## Commands
|
|
15
|
+
|
|
16
|
+
- Full validation: `node scripts/validate-gse.mjs --root <skill-root> --json`
|
|
17
|
+
- Structural audit: `node scripts/audit-gse.mjs --root <skill-root> --json`
|
|
18
|
+
- Change pack audit: `node scripts/audit-change-system.mjs --root <skill-root> --json`
|
|
19
|
+
- Close gate: `node scripts/audit-close-gate.mjs --target <skill-root> --json`
|
|
20
|
+
|
|
21
|
+
## Tool Notes
|
|
22
|
+
|
|
23
|
+
- This skill folder is not a git repository.
|
|
24
|
+
- Use `py` instead of bare `python` for skill validator commands on this machine.
|
|
25
|
+
- Keep OpenSpec, Superpowers, Comet, subagents, MCP, LSP, and browser automation optional unless current-session evidence proves they are available.
|
|
26
|
+
|
|
27
|
+
## Ownership
|
|
28
|
+
|
|
29
|
+
Do not mark GSE v1.0 complete until configured target-project evidence confirms real consumption or an explicit owner acceptance policy replaces that requirement.
|
package/.gse/quality-gates.md
CHANGED
|
@@ -1,25 +1,25 @@
|
|
|
1
|
-
# Quality Gates
|
|
2
|
-
|
|
3
|
-
## Universal
|
|
4
|
-
|
|
5
|
-
- One slice must have outcome, scope, acceptance, evidence, risk, and next action.
|
|
6
|
-
- Do not claim external tools ran unless command output or host evidence proves it.
|
|
7
|
-
- Keep `result`, `verified`, and `accepted` distinct.
|
|
8
|
-
- Preserve optional adapters: GSE must work without OpenSpec, Superpowers, Comet, subagents, MCP, LSP, or browser tooling.
|
|
9
|
-
|
|
10
|
-
## GSE Skill Changes
|
|
11
|
-
|
|
12
|
-
- Run `node scripts/validate-gse.mjs --root <skill-root> --json` before closing a GSE skill change.
|
|
13
|
-
- For change/spec behavior, run `node scripts/audit-change-system.mjs --root <skill-root> --json`.
|
|
14
|
-
- For README or command behavior, ensure the relevant audit remains wired into `scripts/validate-gse.mjs`.
|
|
15
|
-
- Update `.gse/evidence/YYYY-MM-DD.md` and `.gse/evidence/index.jsonl` for verified slices.
|
|
16
|
-
|
|
17
|
-
## Target-Project Claims
|
|
18
|
-
|
|
19
|
-
- Use `scripts/audit-target-project.mjs` before claiming a target project is GSE-ready.
|
|
20
|
-
- Use `scripts/audit-close-gate.mjs` before saying a slice can close.
|
|
21
|
-
- Real project adoption still needs project-specific tests, smokes, or owner acceptance according to that repo's rules.
|
|
22
|
-
|
|
23
|
-
## Release Boundary
|
|
24
|
-
|
|
25
|
-
Local validation is not marketplace release, external install verification, CI publication, or owner acceptance.
|
|
1
|
+
# Quality Gates
|
|
2
|
+
|
|
3
|
+
## Universal
|
|
4
|
+
|
|
5
|
+
- One slice must have outcome, scope, acceptance, evidence, risk, and next action.
|
|
6
|
+
- Do not claim external tools ran unless command output or host evidence proves it.
|
|
7
|
+
- Keep `result`, `verified`, and `accepted` distinct.
|
|
8
|
+
- Preserve optional adapters: GSE must work without OpenSpec, Superpowers, Comet, subagents, MCP, LSP, or browser tooling.
|
|
9
|
+
|
|
10
|
+
## GSE Skill Changes
|
|
11
|
+
|
|
12
|
+
- Run `node scripts/validate-gse.mjs --root <skill-root> --json` before closing a GSE skill change.
|
|
13
|
+
- For change/spec behavior, run `node scripts/audit-change-system.mjs --root <skill-root> --json`.
|
|
14
|
+
- For README or command behavior, ensure the relevant audit remains wired into `scripts/validate-gse.mjs`.
|
|
15
|
+
- Update `.gse/evidence/YYYY-MM-DD.md` and `.gse/evidence/index.jsonl` for verified slices.
|
|
16
|
+
|
|
17
|
+
## Target-Project Claims
|
|
18
|
+
|
|
19
|
+
- Use `scripts/audit-target-project.mjs` before claiming a target project is GSE-ready.
|
|
20
|
+
- Use `scripts/audit-close-gate.mjs` before saying a slice can close.
|
|
21
|
+
- Real project adoption still needs project-specific tests, smokes, or owner acceptance according to that repo's rules.
|
|
22
|
+
|
|
23
|
+
## Release Boundary
|
|
24
|
+
|
|
25
|
+
Local validation is not marketplace release, external install verification, CI publication, or owner acceptance.
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# Public Channel Publication Record
|
|
2
|
+
|
|
3
|
+
Publication status: accepted
|
|
4
|
+
|
|
5
|
+
Channel type: package-registry
|
|
6
|
+
|
|
7
|
+
Channel name: npm
|
|
8
|
+
|
|
9
|
+
Channel URL: https://www.npmjs.com/package/@t275005746/gse
|
|
10
|
+
|
|
11
|
+
Package or listing version: 0.1.0
|
|
12
|
+
|
|
13
|
+
Artifact digest: sha512-DcnRp6yZv/LjON/uowlze5yuV2JIAWfOD9GGQhVpIGX5IgmA7r9j2FkIDFT3n4abSZ5q/3SH7rh56gICFrml3Q==
|
|
14
|
+
|
|
15
|
+
Review or approval status: published
|
|
16
|
+
|
|
17
|
+
Evidence owner: t275005746
|
|
18
|
+
|
|
19
|
+
Evidence date: 2026-07-08
|
|
20
|
+
|
|
21
|
+
Evidence URL or run id: https://www.npmjs.com/package/@t275005746/gse
|
|
22
|
+
|
|
23
|
+
## Verification
|
|
24
|
+
|
|
25
|
+
Verification command: node scripts/validate-gse.mjs --root . --json
|
|
26
|
+
|
|
27
|
+
Verification result: passed
|
|
28
|
+
|
|
29
|
+
## Acceptance
|
|
30
|
+
|
|
31
|
+
Evidence status: accepted
|
|
32
|
+
|
|
33
|
+
Accepted by: 275005746
|
|
34
|
+
|
|
35
|
+
Accepted at: 2026-07-08
|
|
36
|
+
|
|
37
|
+
## Boundaries
|
|
38
|
+
|
|
39
|
+
- Does this prove public registry publication? true
|
|
40
|
+
- Does this prove marketplace approval? unknown
|
|
41
|
+
- Does this prove installability from the channel? true
|
|
42
|
+
|
|
43
|
+
## Residual Risk
|
|
44
|
+
|
|
45
|
+
- Public channel publication is not accepted until real external evidence is attached.
|
|
46
|
+
|
|
47
|
+
## Next Action
|
|
48
|
+
|
|
49
|
+
- Attach public channel publication evidence and re-run final readiness.
|