@t275005746/gse 0.1.0 → 0.1.1

package/examples/README.md

@@ -1,22 +1,22 @@
-# GSE Example Fixtures
-
-These fixtures are intentionally small. They are project shapes for forward tests and future agents, not full applications.
-
-Use `references/adoption-recipes.md` to map fixture behavior to fresh install, existing repo adoption, update, or host adapter adoption paths.
-
-## Fixtures
-
-| Fixture | Shape | GSE workflows it can exercise |
-|---|---|---|
-| `small-app` | JavaScript/TypeScript app shape with package scripts, CI, Playwright config, and `.env.example` | bootstrap, project-profile discovery, quality gates, release evidence |
-| `agent-runtime-host` | Agent-runtime product shape with `.gse/`, host adapter notes, MCP config placeholder, and runtime docs | host adapter, drift audit, recovery/handoff, tool/model status classification |
-| `cli-tool` | JavaScript/TypeScript CLI package shape with `bin`, smoke, build, lint, typecheck, and package dry-run scripts | package adoption, command smoke evidence, release dry-run evidence, project-profile discovery |
-
-## Rules
-
-- No secrets. Use `.env.example` with placeholder names only.
-- No lockfiles, caches, screenshots, build outputs, or generated noise.
-- Keep fixture files short enough for a future agent to inspect quickly.
-- Treat config presence as documented, not verified, until a focused command is run.
-- Use these fixtures for structural and fixture forward tests; do not claim fresh-session acceptance from fixture presence alone.
-- Run `node scripts/audit-fixtures.mjs --root <gse-skill-root> --json` for the repeatable fixture smoke.
+# GSE Example Fixtures
+
+These fixtures are intentionally small. They are project shapes for forward tests and future agents, not full applications.
+
+Use `references/adoption-recipes.md` to map fixture behavior to fresh install, existing repo adoption, update, or host adapter adoption paths.
+
+## Fixtures
+
+| Fixture | Shape | GSE workflows it can exercise |
+|---|---|---|
+| `small-app` | JavaScript/TypeScript app shape with package scripts, CI, Playwright config, and `.env.example` | bootstrap, project-profile discovery, quality gates, release evidence |
+| `agent-runtime-host` | Agent-runtime product shape with `.gse/`, host adapter notes, MCP config placeholder, and runtime docs | host adapter, drift audit, recovery/handoff, tool/model status classification |
+| `cli-tool` | JavaScript/TypeScript CLI package shape with `bin`, smoke, build, lint, typecheck, and package dry-run scripts | package adoption, command smoke evidence, release dry-run evidence, project-profile discovery |
+
+## Rules
+
+- No secrets. Use `.env.example` with placeholder names only.
+- No lockfiles, caches, screenshots, build outputs, or generated noise.
+- Keep fixture files short enough for a future agent to inspect quickly.
+- Treat config presence as documented, not verified, until a focused command is run.
+- Use these fixtures for structural and fixture forward tests; do not claim fresh-session acceptance from fixture presence alone.
+- Run `node scripts/audit-fixtures.mjs --root <gse-skill-root> --json` for the repeatable fixture smoke.

package/examples/agent-runtime-host/.claude/gse-adapter.md

@@ -1,6 +1,6 @@
-# Claude Code Adapter
-
-Source of truth: `.gse/`.
-
-- Commands and agents should point back to `.gse/` for goals, evidence, quality gates, and learning rules.
-- Do not copy the goal map into this folder.
+# Claude Code Adapter
+
+Source of truth: `.gse/`.
+
+- Commands and agents should point back to `.gse/` for goals, evidence, quality gates, and learning rules.
+- Do not copy the goal map into this folder.

package/examples/agent-runtime-host/.codex/gse-adapter.md

@@ -1,7 +1,7 @@
-# Codex Adapter
-
-Source of truth: `.gse/`.
-
-- Read `.gse/project-profile.md` before using host-specific tools.
-- Mark subagent, MCP, browser, and LSP capabilities as verified only after current-session evidence.
-- Use `references/drift-audit.md` when adapter claims and current tools disagree.
+# Codex Adapter
+
+Source of truth: `.gse/`.
+
+- Read `.gse/project-profile.md` before using host-specific tools.
+- Mark subagent, MCP, browser, and LSP capabilities as verified only after current-session evidence.
+- Use `references/drift-audit.md` when adapter claims and current tools disagree.

package/examples/agent-runtime-host/.gse/goal-map.md

@@ -1,7 +1,7 @@
-# Goal Map
-
-## Current Focus
-
-- Priority: P1
-- Active slice: Verify host adapter and drift audit behavior.
-- Next action: Inspect host adapter notes before claiming capabilities.
+# Goal Map
+
+## Current Focus
+
+- Priority: P1
+- Active slice: Verify host adapter and drift audit behavior.
+- Next action: Inspect host adapter notes before claiming capabilities.

package/examples/agent-runtime-host/.gse/project-profile.md

@@ -1,27 +1,27 @@
-# Project Profile
-
-## Identity
-
-- Product/system name: Example Runtime
-- Repository type: agent-runtime product fixture
-- Main languages/frameworks: TypeScript, Node.js
-
-## Tool Connections
-
-| Tool | Purpose | Command/config | Status |
-|---|---|---|---|
-| MCP | external tools/data | `.mcp.json` | documented |
-| Subagents | delegated work | host-specific | unknown |
-| Browser | UI smoke | not configured | unknown |
-| Model router | provider/model routing | docs/model-routing.md | documented |
-
-## Agent Host Adapters
-
-- Codex: `.codex/gse-adapter.md` documented.
-- Claude Code: `.claude/gse-adapter.md` documented.
-- Other hosts: unknown.
-
-## Known Gotchas
-
-- Config presence is documented, not verified.
-- Drift audit is required before trusting old host capability claims.
+# Project Profile
+
+## Identity
+
+- Product/system name: Example Runtime
+- Repository type: agent-runtime product fixture
+- Main languages/frameworks: TypeScript, Node.js
+
+## Tool Connections
+
+| Tool | Purpose | Command/config | Status |
+|---|---|---|---|
+| MCP | external tools/data | `.mcp.json` | documented |
+| Subagents | delegated work | host-specific | unknown |
+| Browser | UI smoke | not configured | unknown |
+| Model router | provider/model routing | docs/model-routing.md | documented |
+
+## Agent Host Adapters
+
+- Codex: `.codex/gse-adapter.md` documented.
+- Claude Code: `.claude/gse-adapter.md` documented.
+- Other hosts: unknown.
+
+## Known Gotchas
+
+- Config presence is documented, not verified.
+- Drift audit is required before trusting old host capability claims.

package/examples/agent-runtime-host/.gse/tooling.md

@@ -1,5 +1,5 @@
-# Tooling
-
-- MCP config: documented by `.mcp.json`, not verified.
-- Model routing docs: documented by `docs/model-routing.md`, not verified.
-- Subagent capability: unknown until host tools are visible in the active session.
+# Tooling
+
+- MCP config: documented by `.mcp.json`, not verified.
+- Model routing docs: documented by `docs/model-routing.md`, not verified.
+- Subagent capability: unknown until host tools are visible in the active session.

package/examples/agent-runtime-host/.mcp.json

@@ -1,9 +1,9 @@
-{
-  "mcpServers": {
-    "fixture-docs": {
-      "command": "node",
-      "args": ["scripts/fixture-mcp.js"],
-      "status": "documented-not-verified"
-    }
-  }
-}
+{
+  "mcpServers": {
+    "fixture-docs": {
+      "command": "node",
+      "args": ["scripts/fixture-mcp.js"],
+      "status": "documented-not-verified"
+    }
+  }
+}

package/examples/agent-runtime-host/AGENTS.md

@@ -1,5 +1,5 @@
-# Fixture Agent Runtime Rules
-
-- Product identity in this fixture is `Example Runtime`; runtime internals are not user-facing product names.
-- `.gse/` is the portable source of truth.
-- Host folders are adapters and must not duplicate the goal map or evidence log.
+# Fixture Agent Runtime Rules
+
+- Product identity in this fixture is `Example Runtime`; runtime internals are not user-facing product names.
+- `.gse/` is the portable source of truth.
+- Host folders are adapters and must not duplicate the goal map or evidence log.

package/examples/agent-runtime-host/README.md

@@ -1,10 +1,10 @@
-# agent-runtime-host fixture
-
-Purpose: representative agent-runtime product shape for host adapter, drift audit, recovery/handoff, and model/tool status tests.
-
-Suggested checks:
-
-- Inspect `.gse/project-profile.md` for host/tool status vocabulary.
-- Inspect `.codex/gse-adapter.md` and `.claude/gse-adapter.md` for `.gse/` source-of-truth pointers.
-- Run drift audit guidance against host capability claims and `.gse/tooling.md`.
-- Confirm no runtime or subagent capability is marked verified without evidence.
+# agent-runtime-host fixture
+
+Purpose: representative agent-runtime product shape for host adapter, drift audit, recovery/handoff, and model/tool status tests.
+
+Suggested checks:
+
+- Inspect `.gse/project-profile.md` for host/tool status vocabulary.
+- Inspect `.codex/gse-adapter.md` and `.claude/gse-adapter.md` for `.gse/` source-of-truth pointers.
+- Run drift audit guidance against host capability claims and `.gse/tooling.md`.
+- Confirm no runtime or subagent capability is marked verified without evidence.

package/examples/agent-runtime-host/docs/model-routing.md

@@ -1,5 +1,5 @@
-# Model Routing Fixture
-
-- Default model route: unknown until provider config is verified.
-- Fallback policy: do not claim provider support from docs alone.
-- Privacy: avoid sending secrets or raw internal traces to model providers.
+# Model Routing Fixture
+
+- Default model route: unknown until provider config is verified.
+- Fallback policy: do not claim provider support from docs alone.
+- Privacy: avoid sending secrets or raw internal traces to model providers.

package/examples/cli-tool/.gse/project-profile.md

@@ -1,21 +1,21 @@
-# CLI Tool Project Profile
-
-Status: fixture documentation only.
-
-## Identity
-
-- Repository type: JavaScript/TypeScript CLI package.
-- Primary interface: package `bin` command.
-- User-visible risk: command output, exit codes, package install/update, and release notes.
-
-## Adoption Notes
-
-- Preserve existing package scripts and release metadata.
-- Treat `smoke`, `release:dry-run`, and `bin` entries as `documented` until executed.
-- Keep package manager, registry, signing, and publish permissions as `unknown` unless checked in the target project.
-
-## Suggested Evidence
-
-- Profile discovery result from `scripts/discover-project-profile.mjs`.
-- Focused CLI smoke such as `npm run smoke` or project equivalent.
-- Package dry-run evidence such as `npm pack --dry-run` when release scope is involved.
+# CLI Tool Project Profile
+
+Status: fixture documentation only.
+
+## Identity
+
+- Repository type: JavaScript/TypeScript CLI package.
+- Primary interface: package `bin` command.
+- User-visible risk: command output, exit codes, package install/update, and release notes.
+
+## Adoption Notes
+
+- Preserve existing package scripts and release metadata.
+- Treat `smoke`, `release:dry-run`, and `bin` entries as `documented` until executed.
+- Keep package manager, registry, signing, and publish permissions as `unknown` unless checked in the target project.
+
+## Suggested Evidence
+
+- Profile discovery result from `scripts/discover-project-profile.mjs`.
+- Focused CLI smoke such as `npm run smoke` or project equivalent.
+- Package dry-run evidence such as `npm pack --dry-run` when release scope is involved.

package/examples/cli-tool/AGENTS.md

@@ -1,5 +1,5 @@
-# CLI Tool Fixture Rules
-
-- Preserve package scripts and release notes when adopting GSE.
-- Treat `bin` entries and publish scripts as documented until a focused smoke runs.
-- Do not claim package publishing, npm access, shell completion, or global install support without evidence.
+# CLI Tool Fixture Rules
+
+- Preserve package scripts and release notes when adopting GSE.
+- Treat `bin` entries and publish scripts as documented until a focused smoke runs.
+- Do not claim package publishing, npm access, shell completion, or global install support without evidence.

package/examples/cli-tool/README.md

@@ -1,12 +1,12 @@
-# cli-tool fixture
-
-Purpose: representative command-line package shape for GSE adoption tests.
-
-Suggested checks:
-
-- Run `node <gse>/scripts/discover-project-profile.mjs --target <fixture> --json`.
-- Confirm package scripts are documented, not verified.
-- Confirm CLI smoke, package validation, and release/publish signals are discovered from `package.json`.
-- Confirm host capabilities remain `unknown` unless a host-specific adapter or current-session evidence exists.
-
-No install or package publish is required for structural fixture use.
+# cli-tool fixture
+
+Purpose: representative command-line package shape for GSE adoption tests.
+
+Suggested checks:
+
+- Run `node <gse>/scripts/discover-project-profile.mjs --target <fixture> --json`.
+- Confirm package scripts are documented, not verified.
+- Confirm CLI smoke, package validation, and release/publish signals are discovered from `package.json`.
+- Confirm host capabilities remain `unknown` unless a host-specific adapter or current-session evidence exists.
+
+No install or package publish is required for structural fixture use.

package/examples/cli-tool/package.json

@@ -1,21 +1,21 @@
-{
-  "name": "gse-cli-tool-fixture",
-  "version": "0.0.0-fixture",
-  "private": true,
-  "type": "module",
-  "bin": {
-    "gse-fixture": "./src/cli.mjs"
-  },
-  "scripts": {
-    "test": "node --test",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint .",
-    "smoke": "node ./src/cli.mjs --help",
-    "build": "tsc -p tsconfig.json",
-    "release:dry-run": "npm pack --dry-run"
-  },
-  "devDependencies": {
-    "typescript": "^5.0.0",
-    "eslint": "^9.0.0"
-  }
-}
+{
+  "name": "gse-cli-tool-fixture",
+  "version": "0.0.0-fixture",
+  "private": true,
+  "type": "module",
+  "bin": {
+    "gse-fixture": "./src/cli.mjs"
+  },
+  "scripts": {
+    "test": "node --test",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "smoke": "node ./src/cli.mjs --help",
+    "build": "tsc -p tsconfig.json",
+    "release:dry-run": "npm pack --dry-run"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "eslint": "^9.0.0"
+  }
+}

package/examples/small-app/.env.example

@@ -1,2 +1,2 @@
-PUBLIC_API_BASE_URL=http://localhost:3000
-FEATURE_FLAG_EXAMPLE=false
+PUBLIC_API_BASE_URL=http://localhost:3000
+FEATURE_FLAG_EXAMPLE=false

package/examples/small-app/.github/workflows/ci.yml

@@ -1,8 +1,8 @@
-name: fixture-ci
-on: [push]
-jobs:
-  check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - run: echo "fixture only; commands are documented, not verified"
+name: fixture-ci
+on: [push]
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: echo "fixture only; commands are documented, not verified"

package/examples/small-app/AGENTS.md

@@ -1,5 +1,5 @@
-# Fixture Agent Rules
-
-- Use `.gse/project-profile.md` when present.
-- Keep changes small and verified.
-- Do not commit secrets, lockfiles, caches, screenshots, or build outputs from this fixture.
+# Fixture Agent Rules
+
+- Use `.gse/project-profile.md` when present.
+- Keep changes small and verified.
+- Do not commit secrets, lockfiles, caches, screenshots, or build outputs from this fixture.

package/examples/small-app/README.md

@@ -1,12 +1,12 @@
-# small-app fixture
-
-Purpose: representative small web app shape for GSE bootstrap and project-profile discovery tests.
-
-Suggested checks:
-
-- Run `node <gse>/scripts/discover-project-profile.mjs --target <fixture> --json`.
-- Confirm package scripts are documented, not verified.
-- Confirm browser/Playwright and CI are detected from config files.
-- Confirm `.env.example` is treated as secrets documentation without reading real secrets.
-
-No install is required for structural fixture use.
+# small-app fixture
+
+Purpose: representative small web app shape for GSE bootstrap and project-profile discovery tests.
+
+Suggested checks:
+
+- Run `node <gse>/scripts/discover-project-profile.mjs --target <fixture> --json`.
+- Confirm package scripts are documented, not verified.
+- Confirm browser/Playwright and CI are detected from config files.
+- Confirm `.env.example` is treated as secrets documentation without reading real secrets.
+
+No install is required for structural fixture use.

package/examples/small-app/package.json

@@ -1,26 +1,26 @@
-{
-  "name": "gse-small-app-fixture",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "test": "vitest run",
-    "test:e2e": "playwright test",
-    "lint": "eslint .",
-    "typecheck": "tsc --noEmit",
-    "build": "vite build"
-  },
-  "dependencies": {
-    "@vitejs/plugin-react": "latest",
-    "react": "latest",
-    "react-dom": "latest",
-    "vite": "latest"
-  },
-  "devDependencies": {
-    "@playwright/test": "latest",
-    "eslint": "latest",
-    "prettier": "latest",
-    "typescript": "latest",
-    "vitest": "latest"
-  }
-}
+{
+  "name": "gse-small-app-fixture",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "test": "vitest run",
+    "test:e2e": "playwright test",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "build": "vite build"
+  },
+  "dependencies": {
+    "@vitejs/plugin-react": "latest",
+    "react": "latest",
+    "react-dom": "latest",
+    "vite": "latest"
+  },
+  "devDependencies": {
+    "@playwright/test": "latest",
+    "eslint": "latest",
+    "prettier": "latest",
+    "typescript": "latest",
+    "vitest": "latest"
+  }
+}

package/examples/small-app/playwright.config.ts

@@ -1,4 +1,4 @@
-export default {
-  testDir: "./tests/e2e",
-  use: { baseURL: "http://localhost:5173" },
-};
+export default {
+  testDir: "./tests/e2e",
+  use: { baseURL: "http://localhost:5173" },
+};

package/package.json

@@ -1,53 +1,53 @@
-{
-  "name": "@t275005746/gse",
-  "version": "0.1.0",
-  "description": "Goal-Spec-Evidence Engineering workflow skill for long-running agent-assisted software projects.",
-  "type": "module",
-  "license": "MIT",
-  "homepage": "https://gatehub.top/",
-  "bin": {
-    "gse": "scripts/gse.mjs"
-  },
-  "files": [
-    "SKILL.md",
-    "README.md",
-    "README.zh-CN.md",
-    "CHANGELOG.md",
-    "CONTRIBUTING.md",
-    "LICENSE",
-    "SECURITY.md",
-    "SUPPORT.md",
-    ".github",
-    ".gse/README.md",
-    ".gse/project-profile.md",
-    ".gse/quality-gates.md",
-    ".gse/gse-development-protocol.md",
-    ".gse/state.json",
-    ".gse/releases",
-    "agents",
-    "assets",
-    "examples",
-    "references",
-    "scripts"
-  ],
-  "scripts": {
-    "audit:npm": "node scripts/audit-npm-package-metadata.mjs --root . --json",
-    "audit:npm-install": "node scripts/audit-npm-tarball-install.mjs --root . --json",
-    "audit:npm-publish": "node scripts/audit-npm-publish-dry-run.mjs --root . --json",
-    "validate": "node scripts/validate-gse.mjs --root . --json",
-    "pack:dry-run": "npm pack --dry-run --json"
-  },
-  "keywords": [
-    "gse",
-    "goal-spec-evidence",
-    "agentic-engineering",
-    "ai-coding-agent",
-    "spec-driven-development",
-    "sdd",
-    "evidence-gates",
-    "workflow"
-  ],
-  "engines": {
-    "node": ">=18"
-  }
-}
+{
+  "name": "@t275005746/gse",
+  "version": "0.1.1",
+  "description": "Goal-Spec-Evidence Engineering workflow skill for long-running agent-assisted software projects.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://gatehub.top/",
+  "bin": {
+    "gse": "scripts/gse.mjs"
+  },
+  "files": [
+    "SKILL.md",
+    "README.md",
+    "README.zh-CN.md",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "LICENSE",
+    "SECURITY.md",
+    "SUPPORT.md",
+    ".github",
+    ".gse/README.md",
+    ".gse/project-profile.md",
+    ".gse/quality-gates.md",
+    ".gse/gse-development-protocol.md",
+    ".gse/state.json",
+    ".gse/releases",
+    "agents",
+    "assets",
+    "examples",
+    "references",
+    "scripts"
+  ],
+  "scripts": {
+    "audit:npm": "node scripts/audit-npm-package-metadata.mjs --root . --json",
+    "audit:npm-install": "node scripts/audit-npm-tarball-install.mjs --root . --json",
+    "audit:npm-publish": "node scripts/audit-npm-publish-dry-run.mjs --root . --json",
+    "validate": "node scripts/validate-gse.mjs --root . --json",
+    "pack:dry-run": "npm pack --dry-run --json"
+  },
+  "keywords": [
+    "gse",
+    "goal-spec-evidence",
+    "agentic-engineering",
+    "ai-coding-agent",
+    "spec-driven-development",
+    "sdd",
+    "evidence-gates",
+    "workflow"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}