gorsee 0.2.16 → 1.0.0

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.
Files changed (3) hide show
  1. package/README.md +12 -0
  2. package/dist-pkg/ai/framework-context.js +12 -0
  3. package/package.json +13 -4
package/README.md CHANGED
@@ -23,6 +23,9 @@ Read the strategic docs:
23
23
  - [Top-Tier Competition Plan](./docs/TOP_TIER_COMPETITION_PLAN.md)
24
24
  - [Competition Closure Plan](./docs/COMPETITION_CLOSURE_PLAN.md)
25
25
  - [External Proof Intake](./docs/EXTERNAL_PROOF_INTAKE.md)
26
+ - [External Proof Claims](./docs/EXTERNAL_PROOF_CLAIMS.json)
27
+ - [External Proof Execution](./docs/EXTERNAL_PROOF_EXECUTION.md)
28
+ - [External Proof Outreach](./docs/EXTERNAL_PROOF_OUTREACH.json)
26
29
  - [External Proof Pipeline](./docs/EXTERNAL_PROOF_PIPELINE.json)
27
30
  - [External Proof Review](./docs/EXTERNAL_PROOF_REVIEW.md)
28
31
  - [Canonical Language Plan](./docs/CANONICAL_LANGUAGE_PLAN.md)
@@ -35,6 +38,7 @@ Read the strategic docs:
35
38
  - [Reactive Hydration](./docs/REACTIVE_HYDRATION.md)
36
39
  - [Reactive Debugging](./docs/REACTIVE_DEBUGGING.md)
37
40
  - [Reactive Measurement Gaps](./docs/REACTIVE_MEASUREMENT_GAPS.md)
41
+ - [Reactive Evidence Summary](./docs/REACTIVE_EVIDENCE_SUMMARY.md)
38
42
  - [Benchmark Policy](./docs/BENCHMARK_POLICY.md)
39
43
  - [Benchmark Contract](./docs/BENCHMARK_CONTRACT.json)
40
44
  - [Benchmark Methodology](./docs/BENCHMARK_METHODOLOGY.md)
@@ -56,6 +60,7 @@ Read the strategic docs:
56
60
  - [CLI Contract](./docs/CLI_CONTRACT.json)
57
61
  - [Product Surface Audit](./docs/PRODUCT_SURFACE_AUDIT.md)
58
62
  - [AI Integration Contract](./docs/AI_INTEGRATION_CONTRACT.json)
63
+ - [Third-Party Editor Integrations](./docs/THIRD_PARTY_EDITOR_INTEGRATIONS.md)
59
64
  - [AI IDE Sync Workflow](./docs/AI_IDE_SYNC_WORKFLOW.md)
60
65
  - [AI MCP Workflow](./docs/AI_MCP_WORKFLOW.md)
61
66
  - [AI Bridge Workflow](./docs/AI_BRIDGE_WORKFLOW.md)
@@ -76,6 +81,7 @@ Read the strategic docs:
76
81
  - [Auth / Cache / Data Paths](./docs/AUTH_CACHE_DATA_PATHS.md)
77
82
  - [Recipe Boundaries](./docs/RECIPE_BOUNDARIES.md)
78
83
  - [Workspace Adoption](./docs/WORKSPACE_ADOPTION.md)
84
+ - [Node and npm Adoption](./docs/NODE_NPM_ADOPTION.md)
79
85
  - [Downstream Testing](./docs/DOWNSTREAM_TESTING.md)
80
86
  - [Test Coverage Audit](./docs/TEST_COVERAGE_AUDIT.md)
81
87
  - [Team Failures](./docs/TEAM_FAILURES.md)
@@ -156,6 +162,12 @@ For agent cold-start context:
156
162
  bunx gorsee ai framework --format markdown
157
163
  ```
158
164
 
165
+ For the first real external proof draft:
166
+
167
+ ```bash
168
+ npm run external-proof:scaffold -- --type reference --id first-public-reference
169
+ ```
170
+
159
171
  ## Why Gorsee
160
172
 
161
173
  Most modern frameworks optimize for flexibility, historical compatibility, or ecosystem breadth.
package/dist-pkg/ai/framework-context.js CHANGED
@@ -19,6 +19,7 @@ const LOCAL_DOCS = [
19
19
  { path: "docs/PRODUCT_SURFACE_AUDIT.md", purpose: "\u041A\u0440\u0430\u0442\u043A\u0438\u0439 \u0438\u043D\u0434\u0435\u043A\u0441 \u0437\u0430\u043A\u0440\u044B\u0442\u044B\u0445 \u0438 \u0447\u0430\u0441\u0442\u0438\u0447\u043D\u043E \u0437\u0440\u0435\u043B\u044B\u0445 product surfaces" },
20
20
  { path: "docs/CLI_CONTRACT.json", purpose: "Machine-readable CLI command matrix \u0438 AI subcommand surface" },
21
21
  { path: "docs/AI_INTEGRATION_CONTRACT.json", purpose: "Machine-readable local editor/tool integration contract for AI artifacts" },
22
+ { path: "docs/THIRD_PARTY_EDITOR_INTEGRATIONS.md", purpose: "Artifact-first guidance for VS Code/Cursor and other editor consumers" },
22
23
  { path: "docs/SECURITY_MODEL.md", purpose: "Runtime/security guarantees \u0438 fail-closed \u043C\u043E\u0434\u0435\u043B\u044C" },
23
24
  { path: "docs/AI_WORKFLOWS.md", purpose: "\u041A\u0430\u043D\u043E\u043D\u0438\u0447\u0435\u0441\u043A\u0438\u0439 human+agent workflow" },
24
25
  { path: "docs/AI_SURFACE_STABILITY.md", purpose: "\u0421\u0442\u0430\u0431\u0438\u043B\u044C\u043D\u043E\u0441\u0442\u044C AI-facing surface" },
@@ -26,13 +27,18 @@ const LOCAL_DOCS = [
26
27
  { path: "docs/AI_SESSION_PACKS.md", purpose: "Cross-session handoff \u0434\u043B\u044F \u0430\u0433\u0435\u043D\u0442\u043E\u0432" },
27
28
  { path: "docs/REACTIVE_RUNTIME.md", purpose: "\u0420\u0435\u0430\u043A\u0442\u0438\u0432\u043D\u0430\u044F \u043C\u043E\u0434\u0435\u043B\u044C, diagnostics, resources, mutations, islands" },
28
29
  { path: "docs/REACTIVE_MEASUREMENT_CONTRACT.json", purpose: "Machine-readable reactive benchmark backlog and remaining evidence gaps" },
30
+ { path: "docs/REACTIVE_EVIDENCE_SUMMARY.md", purpose: "Release-facing summary of promoted realistic reactive benchmark metrics" },
29
31
  { path: "docs/COMPETITION_CLOSURE_PLAN.md", purpose: "\u041E\u043F\u0435\u0440\u0430\u0442\u043E\u0440\u0441\u043A\u0438\u0439 \u043F\u043B\u0430\u043D \u0437\u0430\u043A\u0440\u044B\u0442\u0438\u044F remaining external competition gaps" },
30
32
  { path: "docs/COMPETITION_BACKLOG.json", purpose: "Machine-readable backlog \u0434\u043B\u044F remaining external competition work" },
33
+ { path: "docs/EXTERNAL_PROOF_CLAIMS.json", purpose: "Machine-readable normalized claim ids for future external proof entries" },
34
+ { path: "docs/EXTERNAL_PROOF_EXECUTION.md", purpose: "\u041E\u043F\u0435\u0440\u0430\u0442\u043E\u0440\u0441\u043A\u0438\u0439 playbook \u0434\u043B\u044F \u043F\u043E\u0438\u0441\u043A\u0430 \u0438 \u043A\u0432\u0430\u043B\u0438\u0444\u0438\u043A\u0430\u0446\u0438\u0438 \u043F\u0435\u0440\u0432\u043E\u0433\u043E accepted external proof" },
35
+ { path: "docs/EXTERNAL_PROOF_OUTREACH.json", purpose: "Machine-readable sourcing and outreach queue for external proof leads" },
31
36
  { path: "docs/EXTERNAL_PROOF_INTAKE.md", purpose: "\u041A\u0430\u043D\u043E\u043D\u0438\u0447\u0435\u0441\u043A\u0438\u0439 intake workflow \u0434\u043B\u044F \u0432\u043D\u0435\u0448\u043D\u0438\u0445 migration/reference \u043A\u0435\u0439\u0441\u043E\u0432" },
32
37
  { path: "docs/EXTERNAL_PROOF_PIPELINE.json", purpose: "Pending queue for external proof candidates before acceptance" },
33
38
  { path: "docs/EXTERNAL_PROOF_REVIEW.md", purpose: "Review workflow \u0434\u043B\u044F \u043F\u0435\u0440\u0435\u0432\u043E\u0434\u0430 external proof \u0438\u0437 pending \u0432 accepted" },
34
39
  { path: "docs/EXTERNAL_PROOF_REGISTRY.json", purpose: "Accepted registry for public external proof entries" },
35
40
  { path: "docs/SUPPORT_MATRIX.md", purpose: "\u041F\u043E\u0434\u0434\u0435\u0440\u0436\u0438\u0432\u0430\u0435\u043C\u044B\u0435 runtime targets, CLI surfaces, and CI-validated contract" },
41
+ { path: "docs/NODE_NPM_ADOPTION.md", purpose: "Explicit Bun-first versus Node/npm adoption framing" },
36
42
  { path: "docs/DEPLOY_TARGET_GUIDE.md", purpose: "Mode-aware deploy target guidance \u0438 runtime profiles" },
37
43
  { path: "docs/STARTER_ONBOARDING.md", purpose: "\u0421\u0442\u0430\u0440\u0442\u043E\u0432\u044B\u0435 app-\u043A\u043B\u0430\u0441\u0441\u044B \u0438 onboarding path" },
38
44
  { path: "docs/MIGRATION_GUIDE.md", purpose: "\u041F\u0435\u0440\u0435\u0445\u043E\u0434 \u0441 compatibility imports \u043D\u0430 canonical surfaces" },
@@ -176,10 +182,16 @@ export async function buildAIFrameworkPacket(cwd) {
176
182
  "Read FRAMEWORK.md for the current app shape and syntax.",
177
183
  "Read docs/PUBLIC_SURFACE_MAP.md for the canonical import map and scoped stable surfaces.",
178
184
  "Read docs/PRODUCT_SURFACE_AUDIT.md for the current closed-vs-partial maturity snapshot before making broad product claims.",
185
+ "Read docs/NODE_NPM_ADOPTION.md before making package-manager or runtime adoption claims.",
179
186
  "Read docs/AI_INTEGRATION_CONTRACT.json when editor tooling, MCP, bridge, or session-handoff integration boundaries matter.",
187
+ "Read docs/THIRD_PARTY_EDITOR_INTEGRATIONS.md when wiring editor tooling beyond the packaged VS Code/Cursor extension.",
180
188
  "Read docs/SUPPORT_MATRIX.md when runtime, packaging, or deploy assumptions matter.",
181
189
  "Read docs/REACTIVE_MEASUREMENT_CONTRACT.json before making broad benchmark or reactivity evidence claims.",
190
+ "Read docs/REACTIVE_EVIDENCE_SUMMARY.md for release-facing reactive evidence and docs/REACTIVE_MEASUREMENT_GAPS.md for the broader remaining backlog.",
182
191
  "Read docs/COMPETITION_CLOSURE_PLAN.md and docs/COMPETITION_BACKLOG.json before making market-competition or adoption claims.",
192
+ "Read docs/EXTERNAL_PROOF_CLAIMS.json before writing or reviewing validatedClaims for external proof candidates.",
193
+ "Read docs/EXTERNAL_PROOF_EXECUTION.md and docs/EXTERNAL_PROOF_OUTREACH.json before sourcing or qualifying external proof leads.",
194
+ "Use npm run external-proof:scaffold -- --type migration|reference --id <candidate-id> when a real external proof lead needs a local draft bundle.",
183
195
  "Use the external-proof intake/review/registry docs for real public migration stories and external references; do not treat pending entries as accepted proof.",
184
196
  "Prefer inspect/propose modes before apply/operate when the task is still ambiguous.",
185
197
  `Respect the current app.mode contract: ${appMode}.`,
package/package.json CHANGED
@@ -1,11 +1,19 @@
1
1
  {
2
2
  "name": "gorsee",
3
- "version": "0.2.16",
3
+ "version": "1.0.0",
4
4
  "description": "AI-first reactive full-stack TypeScript framework for deterministic human and agent collaboration",
5
5
  "type": "module",
6
6
  "packageManager": "bun@1.3.9",
7
7
  "license": "MIT",
8
8
  "author": "Oleg Gorsky",
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "git+https://github.com/OlegGorsky/gorseejs.git"
12
+ },
13
+ "homepage": "https://github.com/OlegGorsky/gorseejs#readme",
14
+ "bugs": {
15
+ "url": "https://github.com/OlegGorsky/gorseejs/issues"
16
+ },
9
17
  "keywords": [
10
18
  "ai-first",
11
19
  "agentic",
@@ -77,17 +85,18 @@
77
85
  "cli:policy": "node scripts/cli-contract-check.mjs",
78
86
  "adoption:policy": "node scripts/adoption-proof-check.mjs",
79
87
  "competition:policy": "node scripts/competition-backlog-check.mjs",
88
+ "external-proof:scaffold": "node scripts/external-proof-scaffold.mjs",
80
89
  "ai:policy": "node scripts/ai-policy-check.mjs",
81
90
  "dx:policy": "node scripts/dx-policy-check.mjs",
82
91
  "maturity:policy": "node scripts/maturity-policy-check.mjs",
83
92
  "runtime:policy": "node scripts/runtime-diagnostics-policy-check.mjs",
84
93
  "runtime:security:policy": "node scripts/runtime-security-contract-check.mjs",
85
94
  "compiler:audit": "node scripts/compiler-platform-audit.mjs",
86
- "compiler:parity": "node scripts/compiler-backend-parity.mjs",
87
- "compiler:canary": "node scripts/compiler-backend-parity.mjs && bun test tests/cli/programmatic-runtime.test.ts tests/compiler/init.test.ts",
95
+ "compiler:parity": "bun scripts/compiler-backend-parity.mjs",
96
+ "compiler:canary": "bun scripts/compiler-backend-parity.mjs && bun test tests/cli/programmatic-runtime.test.ts tests/compiler/init.test.ts",
88
97
  "compiler:promotion:check": "node scripts/compiler-promotion-check.mjs",
89
98
  "compiler:dossier:check": "node scripts/compiler-dossier-check.mjs",
90
- "compiler:default:rehearsal": "node scripts/compiler-backend-parity.mjs && bun test tests/cli/programmatic-runtime.test.ts tests/compiler/init.test.ts && node scripts/compiler-dossier-check.mjs && node scripts/backend-default-switch-review-check.mjs",
99
+ "compiler:default:rehearsal": "bun scripts/compiler-backend-parity.mjs && bun test tests/cli/programmatic-runtime.test.ts tests/compiler/init.test.ts && node scripts/compiler-dossier-check.mjs && node scripts/backend-default-switch-review-check.mjs",
91
100
  "compiler:default:rehearsal:check": "node scripts/compiler-default-switch-rehearsal-check.mjs",
92
101
  "build:parity": "bun scripts/build-backend-parity.mjs",
93
102
  "build:canary": "bun scripts/build-backend-parity.mjs && bun test tests/cli/programmatic-runtime.test.ts tests/build/init.test.ts tests/integration/production-backend-parity.test.ts",