@sayoriqwq/effect-harness 0.0.4 → 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.
Files changed (105) hide show
  1. package/README.md +9 -77
  2. package/diagnostics/effect-routes.md +6 -0
  3. package/diagnostics/index.md +10 -0
  4. package/diagnostics/tsgo-routes.md +5 -0
  5. package/dist/src/eslint.d.ts +57 -0
  6. package/dist/src/eslint.js +42 -0
  7. package/dist/src/eslint.js.map +1 -0
  8. package/dist/src/index.d.ts +2 -0
  9. package/dist/src/index.js +3 -0
  10. package/dist/src/index.js.map +1 -0
  11. package/dist/src/prelude.d.ts +6 -0
  12. package/dist/src/prelude.js +161 -0
  13. package/dist/src/prelude.js.map +1 -0
  14. package/package.json +25 -17
  15. package/prelude-assets/effect/managed/docs/diagnostics.md +6 -0
  16. package/prelude-assets/effect/managed/docs/editor-policy.md +5 -0
  17. package/prelude-assets/effect/managed/docs/effect-code.md +5 -0
  18. package/prelude-assets/effect/managed/docs/index.md +14 -0
  19. package/prelude-assets/effect/managed/docs/managed-surfaces.md +5 -0
  20. package/prelude-assets/effect/managed/docs/package-config.md +20 -0
  21. package/prelude-assets/effect/managed/docs/quality-policy.md +5 -0
  22. package/prelude-assets/effect/managed/docs/source-identity.md +5 -0
  23. package/prelude-assets/guidance/eslint.md +15 -0
  24. package/repos/effect.subtree.json +2 -2
  25. package/repos/tsgo.subtree.json +2 -2
  26. package/HARNESS.md +0 -66
  27. package/dist/bin/effect-harness.d.ts +0 -2
  28. package/dist/bin/effect-harness.js +0 -34
  29. package/dist/bin/effect-harness.js.map +0 -1
  30. package/dist/src/cli/Main.d.ts +0 -7
  31. package/dist/src/cli/Main.js +0 -45
  32. package/dist/src/cli/Main.js.map +0 -1
  33. package/dist/src/harness/Errors.d.ts +0 -24
  34. package/dist/src/harness/Errors.js +0 -26
  35. package/dist/src/harness/Errors.js.map +0 -1
  36. package/dist/src/harness/Guardrails.d.ts +0 -7
  37. package/dist/src/harness/Guardrails.js +0 -50
  38. package/dist/src/harness/Guardrails.js.map +0 -1
  39. package/dist/src/harness/Model.d.ts +0 -52
  40. package/dist/src/harness/Model.js +0 -170
  41. package/dist/src/harness/Model.js.map +0 -1
  42. package/dist/src/harness/ModuleSources.d.ts +0 -5
  43. package/dist/src/harness/ModuleSources.js +0 -47
  44. package/dist/src/harness/ModuleSources.js.map +0 -1
  45. package/dist/src/harness/ProviderDiscovery.d.ts +0 -172
  46. package/dist/src/harness/ProviderDiscovery.js +0 -157
  47. package/dist/src/harness/ProviderDiscovery.js.map +0 -1
  48. package/dist/src/harness/SourcePin.d.ts +0 -4
  49. package/dist/src/harness/SourcePin.js +0 -214
  50. package/dist/src/harness/SourcePin.js.map +0 -1
  51. package/dist/src/harness/verify/JsonFields.d.ts +0 -1
  52. package/dist/src/harness/verify/JsonFields.js +0 -4
  53. package/dist/src/harness/verify/JsonFields.js.map +0 -1
  54. package/dist/src/harness/verify/Pipeline.d.ts +0 -7
  55. package/dist/src/harness/verify/Pipeline.js +0 -55
  56. package/dist/src/harness/verify/Pipeline.js.map +0 -1
  57. package/dist/src/harness/verify/ProviderProfile.d.ts +0 -3
  58. package/dist/src/harness/verify/ProviderProfile.js +0 -726
  59. package/dist/src/harness/verify/ProviderProfile.js.map +0 -1
  60. package/dist/src/harness/verify/ProviderRepository.d.ts +0 -4
  61. package/dist/src/harness/verify/ProviderRepository.js +0 -127
  62. package/dist/src/harness/verify/ProviderRepository.js.map +0 -1
  63. package/dist/src/harness/verify/Tsgo.d.ts +0 -3
  64. package/dist/src/harness/verify/Tsgo.js +0 -166
  65. package/dist/src/harness/verify/Tsgo.js.map +0 -1
  66. package/dist/src/harness/verify/TsgoMetadata.d.ts +0 -4
  67. package/dist/src/harness/verify/TsgoMetadata.js +0 -50
  68. package/dist/src/harness/verify/TsgoMetadata.js.map +0 -1
  69. package/dist/src/harness/verify/TsgoPolicy.d.ts +0 -208
  70. package/dist/src/harness/verify/TsgoPolicy.js +0 -143
  71. package/dist/src/harness/verify/TsgoPolicy.js.map +0 -1
  72. package/dist/src/harness/verify/TsgoSuppressions.d.ts +0 -2
  73. package/dist/src/harness/verify/TsgoSuppressions.js +0 -24
  74. package/dist/src/harness/verify/TsgoSuppressions.js.map +0 -1
  75. package/dist/src/harness/verify/VerifyStage.d.ts +0 -62
  76. package/dist/src/harness/verify/VerifyStage.js +0 -85
  77. package/dist/src/harness/verify/VerifyStage.js.map +0 -1
  78. package/dist/src/platform/Json.d.ts +0 -4
  79. package/dist/src/platform/Json.js +0 -16
  80. package/dist/src/platform/Json.js.map +0 -1
  81. package/dist/src/platform/Process.d.ts +0 -6
  82. package/dist/src/platform/Process.js +0 -35
  83. package/dist/src/platform/Process.js.map +0 -1
  84. package/harness/code.md +0 -83
  85. package/harness/diagnostic-layers.md +0 -94
  86. package/harness/effect-routes.md +0 -50
  87. package/harness/feedback-loop.md +0 -156
  88. package/harness/index.md +0 -83
  89. package/harness/offcial-guide.md +0 -50
  90. package/harness/offcial-migrate.md +0 -220
  91. package/harness/source.md +0 -91
  92. package/harness/tsgo-routes.md +0 -58
  93. package/harness/tsgo.md +0 -241
  94. package/provider/docs/diagnostics.md +0 -48
  95. package/provider/docs/discovery.md +0 -104
  96. package/provider/docs/editor-policy.md +0 -55
  97. package/provider/docs/effect-code.md +0 -41
  98. package/provider/docs/index.md +0 -48
  99. package/provider/docs/managed-surfaces.md +0 -51
  100. package/provider/docs/package-config.md +0 -71
  101. package/provider/docs/quality-policy.md +0 -68
  102. package/provider/docs/source-identity.md +0 -48
  103. package/provider/effect-harness.provider.json +0 -1020
  104. package/provider/index.md +0 -189
  105. package/provider/snippets/agents.md +0 -34
@@ -1,68 +0,0 @@
1
- ---
2
- audience: [agent, human]
3
- authors:
4
- - codex
5
- reviewed_by: []
6
- purpose: 说明 target 接入 effect-harness 后 lint、test 与 verify policy 的受管口径。
7
- status: active
8
- sources:
9
- - provider/effect-harness.provider.json
10
- - harness/diagnostic-layers.md
11
- - harness/feedback-loop.md
12
- - harness/effect-routes.md
13
- updated: 2026-07-02
14
- ---
15
-
16
- # Quality Policy
17
-
18
- ## Lint
19
-
20
- lint policy 负责 repository boundary 和 syntax-level guardrails。
21
-
22
- target 的 lint entry 由 provider package contribution 暴露为 `pnpm lint`,底层脚本是 `eslint`。
23
- 需要 hard gate 时,verification policy 使用 `pnpm lint --max-warnings 0`。
24
-
25
- lint policy SHOULD block provider-internal source imports、`@effect/cli` imports、`node:test` imports、
26
- 从 `vitest` 导入测试入口(`describe`、`it`、`test`)、`Context.Tag` service definitions、指定 Effect
27
- member,以及关闭 Schema validation 的写法。
28
-
29
- lint policy SHOULD allow Vitest mock/lifecycle API(例如 `vi`、`beforeEach`)直接从 `vitest` 导入,因为
30
- Vitest 的 mock transformer 依赖直接导入。
31
-
32
- lint policy MUST NOT 替代 tsgo diagnostics。Effect semantic diagnostics、type requirement diagnostics 和
33
- strict rule severity map 由 tsgo policy 负责。
34
-
35
- ## Tests
36
-
37
- test policy 使用 `@effect/vitest`。
38
-
39
- target 的 test entry 由 provider package contribution 暴露为 `pnpm test`,底层脚本是
40
- `vitest run`。
41
-
42
- Effect tests SHOULD 使用 `it.effect`、`it.live` 或 layer 组织。
43
-
44
- target SHOULD 保留 provider record 中声明的 test entry pattern,并通过 package script 执行测试。
45
-
46
- ## Verification
47
-
48
- `pnpm verify` 是 completion gate。
49
-
50
- verification policy 描述 local diagnostic commands 和 stage semantics,但不实现 Prelude target lifecycle。
51
-
52
- Prelude 仍负责 target materialization、provider record maintain、drift handling 和 target-level verify
53
- orchestration。target 的总 `pnpm verify` MAY include build、knip 或 release gates;effect-harness
54
- 必须至少把 `pnpm typecheck`、`pnpm test` 和 `pnpm lint --max-warnings 0` 组合进 target verify。
55
-
56
- ## Stages
57
-
58
- source-pins stage 负责 source identity 与 pinned upstream source contract。
59
-
60
- harness-contract stage 负责 provider contract 与 self-conformance。
61
-
62
- tsgo-diagnostics stage 负责 Effect semantic diagnostics。
63
-
64
- tests stage 负责 behavior regression。
65
-
66
- lint stage 负责 repository boundary 和 syntax-level guardrails。
67
-
68
- knip stage 负责 package surface hygiene。
@@ -1,48 +0,0 @@
1
- ---
2
- audience: [agent, human]
3
- authors:
4
- - codex
5
- reviewed_by: []
6
- purpose: 说明 target 如何接收 effect-harness provider-internal source pin 的 identity。
7
- status: active
8
- sources:
9
- - provider/effect-harness.provider.json
10
- - harness/source.md
11
- - repos/effect.subtree.json
12
- - repos/tsgo.subtree.json
13
- updated: 2026-07-02
14
- ---
15
-
16
- # Source Identity
17
-
18
- ## Model
19
-
20
- effect-harness 在 provider 仓内部 pin 住 Effect 和 tsgo source entries。
21
-
22
- target 不接收 source tree 本体。target 只通过 provider record 接收 artifact/source identity。
23
-
24
- source tree、subtree contract、anchor docs 和 route docs 是 provider artifact reference。它们随
25
- effect-harness package artifact 可供审计或 agent 读取,但 delivery mode 是 artifact-only。
26
-
27
- ## Target Record
28
-
29
- provider record SHOULD 记录:
30
-
31
- - provider id、contract version、provider version 和 profile。
32
- - provider artifact identity。
33
- - Effect source identity。
34
- - tsgo source identity。
35
- - managed surfaces 和 verification record id。
36
-
37
- source identity 表示 provider 建设随着上游 source pin 住且可更新。它不是 target 本地源码目录。
38
-
39
- ## Boundary
40
-
41
- target MUST NOT materialize `repos/effect/`、`repos/tsgo/`、`repos/effect.subtree.json` 或
42
- `repos/tsgo.subtree.json`。
43
-
44
- target delivery 只允许 identity-only 字段,例如 source name、contract path、GitHub ref 和 subtree
45
- split。
46
-
47
- source pin lifecycle 由 Partita 处理。effect-harness 维护 Effect/tsgo source identity 与 provider
48
- artifact reference。target update 由 Prelude maintain 处理。