lawspec 0.31.1 → 0.31.3

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 (79) hide show
  1. package/CHANGELOG.md +89 -2
  2. package/README.md +85 -9
  3. package/api.mjs +14 -9
  4. package/authoring.mjs +899 -0
  5. package/beam-coverage.mjs +190 -65
  6. package/beam-doctor.mjs +343 -124
  7. package/bin/lawspec.mjs +1949 -661
  8. package/build.json +134 -128
  9. package/component-packages.mjs +662 -176
  10. package/component.d.ts +82 -20
  11. package/component.mjs +317 -94
  12. package/core.wasm +2 -2
  13. package/core_jsffi.js +5 -5
  14. package/doctor.mjs +558 -299
  15. package/examples-command.mjs +44 -23
  16. package/failure-database.mjs +60 -17
  17. package/files.mjs +122 -62
  18. package/index.d.ts +585 -312
  19. package/input-files.mjs +90 -25
  20. package/launcher.mjs +72 -31
  21. package/learn/coverage.json +184 -112
  22. package/learn/curriculum.json +4 -1
  23. package/learn/vendor/fantomas/{LawSpec.Learn.Formatter.5arcua4vy0.wasm → LawSpec.Learn.Formatter.poiijdbsl9.wasm} +0 -0
  24. package/learn/vendor/fantomas/dotnet.js +3 -3
  25. package/learn/vendor/manifest.json +4 -8
  26. package/lsp.mjs +444 -133
  27. package/mcp.mjs +250 -0
  28. package/native-evidence.mjs +668 -182
  29. package/native-examples.mjs +56 -19
  30. package/native-host.mjs +136 -42
  31. package/native-parsers/clojure.LICENSE +121 -0
  32. package/native-parsers/clojure.wasm +0 -0
  33. package/native-parsers/csharp.LICENSE +21 -0
  34. package/native-parsers/csharp.wasm +0 -0
  35. package/native-parsers/elixir.LICENSE +176 -0
  36. package/native-parsers/elixir.wasm +0 -0
  37. package/native-parsers/erlang.LICENSE +201 -0
  38. package/native-parsers/erlang.wasm +0 -0
  39. package/native-parsers/fsharp.LICENSE +21 -0
  40. package/native-parsers/fsharp.wasm +0 -0
  41. package/native-parsers/gleam.LICENSE +202 -0
  42. package/native-parsers/gleam.wasm +0 -0
  43. package/native-parsers/go.LICENSE +21 -0
  44. package/native-parsers/go.wasm +0 -0
  45. package/native-parsers/groovy.LICENSE +21 -0
  46. package/native-parsers/groovy.wasm +0 -0
  47. package/native-parsers/haskell.LICENSE +21 -0
  48. package/native-parsers/haskell.wasm +0 -0
  49. package/native-parsers/java.LICENSE +21 -0
  50. package/native-parsers/java.wasm +0 -0
  51. package/native-parsers/javascript.LICENSE +21 -0
  52. package/native-parsers/javascript.wasm +0 -0
  53. package/native-parsers/kotlin.LICENSE +9 -0
  54. package/native-parsers/kotlin.wasm +0 -0
  55. package/native-parsers/lock.json +114 -0
  56. package/native-parsers/prolog.LICENSE +21 -0
  57. package/native-parsers/prolog.wasm +0 -0
  58. package/native-parsers/python.LICENSE +21 -0
  59. package/native-parsers/python.wasm +0 -0
  60. package/native-parsers/rust.LICENSE +21 -0
  61. package/native-parsers/rust.wasm +0 -0
  62. package/native-parsers/scala.LICENSE +21 -0
  63. package/native-parsers/scala.wasm +0 -0
  64. package/native-parsers/swift.LICENSE +21 -0
  65. package/native-parsers/swift.wasm +0 -0
  66. package/native-parsers/typescript.LICENSE +21 -0
  67. package/native-parsers/typescript.wasm +0 -0
  68. package/node-events-reporter.mjs +41 -17
  69. package/package.json +4 -3
  70. package/project.mjs +338 -0
  71. package/proof.d.ts +93 -19
  72. package/proof.mjs +1538 -447
  73. package/read-only-hpack.mjs +6 -5
  74. package/scala-build-state.mjs +131 -41
  75. package/scala-coverage.mjs +57 -34
  76. package/scalars.mjs +23 -8
  77. package/templates.mjs +566 -617
  78. package/test-command.mjs +1671 -521
  79. package/learn/vendor/fantomas/LawSpec.Learn.Formatter.u1ne3a6xd2.wasm +0 -0
package/CHANGELOG.md CHANGED
@@ -6,6 +6,91 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.31.3] - 2026-11-03
10
+
11
+ ### Added
12
+
13
+ - Prelude-first authoring skill and twelve checked worked cases cover library
14
+ selection, generated-model ownership, migration and explicit native bindings.
15
+ All three skills include portable compiler references and shared examples.
16
+ - Git-backed marketplaces install the same LawSpec plugin in Codex and Claude
17
+ Code. The README includes installation, release pinning and update commands.
18
+ - Read-only `prelude`, `inspect` and `advise` commands expose library discovery,
19
+ generated interfaces and bounded authoring findings through the CLI, SDK and
20
+ MCP. Native analysis includes bundled offline parsers for all 18 program
21
+ targets; strict advice rejects unresolved findings and incomplete checks.
22
+
23
+ ### Changed
24
+
25
+ - Ordinary checks and generation show nonblocking authoring advice, with
26
+ `--no-advice` to disable it. Advice remains separate from semantic diagnostics
27
+ and law evidence and never rewrites application files.
28
+ - The learning course explains reuse and generated-model migration without
29
+ changing saved progress identities or its pending teaching-review status.
30
+
31
+ ### Fixed
32
+
33
+ - Read-only inspection and advice do not repair dependency caches, unpack Git
34
+ dependencies or create lock files.
35
+ - Defer effectful compile-time evaluation through called procedures, including
36
+ caught failures, and render evaluator source locations without raw AST dumps.
37
+ - Resolve imported Go native failure types and handler factories consistently;
38
+ report why a handler lacks typed embedding entry points.
39
+ - Admit refined fields in indexed constructors without placeholder-type errors,
40
+ and carry structural induction through record and Pair payloads.
41
+ - Analyze bounded refined law sets without a solver and surface expired
42
+ exemptions even when completeness remains undecided.
43
+ - Restrict HCL representation checks to reachable configuration types while
44
+ preserving mandatory validation of every definition.
45
+ - Preserve measurement evidence for budget checks, with native-check durations
46
+ explicitly distinguished from operation timings.
47
+ - Include model and history laws in MCP listings and explanations, advertise
48
+ read-only tools and use the package version in MCP/LSP handshakes. Editor type
49
+ displays retain source signatures instead of raw JSON or erased ABI types.
50
+ - Repair missing declared target scaffolds, explain missing output roots and
51
+ mark copied starter specifications as user-owned. Refresh manifest examples
52
+ and document the boundaries of compact Go output.
53
+
54
+ ## [0.31.2] - 2026-11-01
55
+
56
+ ### Added
57
+
58
+ - Project helpers (`project init`, `adopt`, `status` and `validate`) coordinate
59
+ Canon decisions, mandatory definition checks and configured evidence without
60
+ rewriting application code. The local MCP server exposes read-only compiler
61
+ checks, listings and explanations.
62
+ - Linear-model command arguments can use the current reference state's indices
63
+ and refinements. Generation and shrinking recheck the affected sequence;
64
+ finite model checking enumerates finite dependent domains. Empty domains and
65
+ incomplete generation remain distinct.
66
+ - The portable plugin includes the project-workflow skill alongside the tutor.
67
+
68
+ ### Changed
69
+
70
+ - Repository formatters and generated code follow the owner's Allman preference
71
+ where supported, with established language formatters and pinned browser
72
+ formatting tools. Public bindings and evidence meanings are preserved.
73
+ - Learn comments retain pending human-review verdicts under the same pre-1.0
74
+ deferral as compiler/runtime comments. Teaching review remains open.
75
+
76
+ ### Fixed
77
+
78
+ - Python's 80-column output and Rust's Allman output remain stable for long
79
+ calls, enum variants, bound handlers, match guards and grouped imports.
80
+ Recorded adapter stubs reflect the same interfaces in the selected style.
81
+ - Rust native bindings import only emitted conversion helpers: opaque handles
82
+ convert inline, and mixed handle/data bindings retain their helper indices.
83
+ - C# crypto-vector fixtures and shared Erlang model support follow their pinned
84
+ formatter layouts.
85
+ - Quantified record headers retain the same layout after record braces expand;
86
+ repeated formatting remains stable.
87
+ - Browser formatter assets are published into an empty staging directory, so
88
+ obsolete content-hashed assemblies cannot accumulate in the package. Formatter
89
+ assembly metadata is independent of unrelated Git commits, and bundle paths
90
+ are anchored to the repository root regardless of the invocation directory.
91
+ - Release instructions, package versions and hosted Learn references identify
92
+ the same release while preserving the course's `preview-4` progress identity.
93
+
9
94
  ## [0.31.1] - 2026-10-29
10
95
 
11
96
  ### Added
@@ -2375,8 +2460,10 @@ A maintenance release. The language, generated code and API are unchanged from
2375
2460
  machine-sized bindings reject an architecture mismatch. Rust adapters take
2376
2461
  owned values.
2377
2462
 
2378
- [Unreleased]: https://github.com/brain-fuel/lawspec/compare/v0.31.1...HEAD
2379
- [0.31.1]: https://github.com/brain-fuel/lawspec/compare/v0.31.0...v0.31.1
2463
+ [Unreleased]: https://github.com/brain-fuel/lawspec/compare/v0.31.3...HEAD
2464
+ [0.31.3]: https://github.com/brain-fuel/lawspec/compare/v0.31.2...v0.31.3
2465
+ [0.31.2]: https://github.com/brain-fuel/lawspec/compare/v0.31.0...v0.31.2
2466
+ [0.31.1]: https://www.npmjs.com/package/lawspec/v/0.31.1
2380
2467
  [0.31.0]: https://github.com/brain-fuel/lawspec/compare/v0.30.0...v0.31.0
2381
2468
  [0.30.0]: https://github.com/brain-fuel/lawspec/compare/v0.29.2...v0.30.0
2382
2469
  [0.29.2]: https://github.com/brain-fuel/lawspec/compare/v0.29.1...v0.29.2
package/README.md CHANGED
@@ -9,7 +9,8 @@ Haskell, Kotlin, Rust, C#, F#, Swift, Erlang, Elixir, Gleam, Clojure, Groovy and
9
9
  Scala. The compiler is written in Haskell and distributed on npm as prebuilt
10
10
  WebAssembly, with a Node CLI and a typed JavaScript API.
11
11
 
12
- The npm package includes the compiler and learning track; no Haskell installation is needed.
12
+ The examples below use the current canonical authoring profile. The npm package
13
+ includes the compiler and learning track; no Haskell installation is needed.
13
14
 
14
15
  ## Features
15
16
 
@@ -33,6 +34,17 @@ The npm package includes the compiler and learning track; no Haskell installatio
33
34
  Node 22+ and the selected target's build tools are required. No Haskell
34
35
  toolchain is needed. The reference platforms are macOS and Linux.
35
36
 
37
+ To open the learning track locally:
38
+
39
+ ```sh
40
+ npm install --global lawspec@0.31.3
41
+ lawspec learn
42
+ ```
43
+
44
+ Open the printed loopback URL, or use [Learn on GoForge](https://goforge.dev/lawspec/learn/).
45
+ Six lessons pair worked examples with practice in F#, TypeScript or JavaScript.
46
+ The course is a teaching preview; later lessons and capstones remain deferred.
47
+
36
48
  The checkout includes the development WASM package. To try it in a **new, empty
37
49
  directory**, initialize before installing, so that LawSpec can create
38
50
  `package.json` and its test script:
@@ -64,6 +76,74 @@ In an existing project, install the checkout's `npm` directory first, then run
64
76
  apply the printed setup instructions before generating. See
65
77
  [Install LawSpec and create a project](docs/how-to/install-and-init.md).
66
78
 
79
+ ## Codex and Claude Code plugin
80
+
81
+ The Git-backed `brain-fuel` marketplace includes the LawSpec plugin with three
82
+ skills: `lawspec-author` for specifications and adapters, `lawspec-project` for
83
+ project discovery and changes, and `lawspec-learn` for tutoring. Each includes
84
+ its references, so installation does not require a compiler repository checkout.
85
+ Install the LawSpec CLI separately with Node 22+:
86
+
87
+ ```sh
88
+ npm install --global lawspec@0.31.3
89
+ ```
90
+
91
+ For **Codex**, run these commands in your terminal:
92
+
93
+ ```sh
94
+ codex plugin marketplace add brain-fuel/lawspec \
95
+ --sparse .agents/plugins --sparse plugins/lawspec
96
+ codex plugin add lawspec@brain-fuel
97
+ ```
98
+
99
+ For **Claude Code**, run:
100
+
101
+ ```sh
102
+ claude plugin marketplace add brain-fuel/lawspec \
103
+ --sparse .claude-plugin plugins/lawspec
104
+ claude plugin install lawspec@brain-fuel
105
+ ```
106
+
107
+ Alternatively, inside Claude Code use `/plugin marketplace add brain-fuel/lawspec`
108
+ and `/plugin install lawspec@brain-fuel`. Start a new session after installation.
109
+ Ask Codex to use `lawspec-author`, or invoke `/lawspec:lawspec-author` in Claude
110
+ Code; the project and tutor skills follow the same naming pattern.
111
+
112
+ The terminal commands use sparse checkouts for the marketplace and plugin
113
+ directories. For a local checkout, omit `--sparse` and its paths and replace
114
+ `brain-fuel/lawspec` with the checkout's absolute path. To pin a release in Codex, append
115
+ `--ref v0.31.3` to its marketplace-add command. In Claude Code, use
116
+ `https://github.com/brain-fuel/lawspec.git#v0.31.3` as the marketplace source.
117
+ Private repository installations require your existing GitHub access.
118
+
119
+ To refresh the Git source, run `codex plugin marketplace upgrade brain-fuel` or
120
+ `claude plugin marketplace update brain-fuel`; in Claude Code then run
121
+ `claude plugin update lawspec@brain-fuel`. In Codex, reinstall with
122
+ `codex plugin add lawspec@brain-fuel` to select the refreshed package. Restart
123
+ the host to load updated skills.
124
+
125
+ This is a repository marketplace, not a listing in either host's curated public
126
+ directory. The plugin has its own version in `learn/plugin.json`; the course
127
+ remains a teaching preview. Maintainers regenerate both host manifests from that
128
+ file with `make generate`. See the official
129
+ [Codex marketplace documentation](https://developers.openai.com/plugins/build/plugins)
130
+ and [Claude Code marketplace documentation](https://code.claude.com/docs/en/plugin-marketplaces).
131
+
132
+ ## MCP server
133
+
134
+ LawSpec can expose a project's compiler through a local MCP server. From the
135
+ project directory, run `npx lawspec mcp`; a host can also launch that command
136
+ as a child process. To inspect it interactively, run:
137
+
138
+ ```sh
139
+ npx @modelcontextprotocol/inspector npx lawspec mcp
140
+ ```
141
+
142
+ The server provides `lawspec_check`, `lawspec_list_laws`, and
143
+ `lawspec_explain`. It reads the project's `lawspec.edn`, validates definitions,
144
+ and reports the configured law verification and its evidence statuses. See the
145
+ [MCP server guide](docs/how-to/use-mcp.md) for host setup and details.
146
+
67
147
  ## Example
68
148
 
69
149
  ```lawspec
@@ -140,11 +220,7 @@ Syntax highlighting is available as a [VS Code extension](editors/vscode/README.
140
220
 
141
221
  MIT. See [LICENSE](LICENSE).
142
222
 
143
- ## Learn LawSpec
144
-
145
- ```sh
146
- npm install --global lawspec@0.31.1
147
- lawspec learn
148
- ```
149
-
150
- Open the printed loopback URL, or use [Learn on GoForge](https://goforge.dev/lawspec/learn/). Six lessons pair worked examples with practice in F#, TypeScript or JavaScript. The course is a teaching preview; later lessons, capstones and the complete API collection remain deferred. See [Learn LawSpec](docs/how-to/learn.md).
223
+ Start or adopt a project without choosing a language with `lawspec project init`
224
+ or `lawspec project adopt`. `lawspec project status` separates Canon decisions
225
+ from LawSpec evidence; `lawspec project validate` checks definitions and the
226
+ configured verification layers. [Project workflow](docs/how-to/manage-projects.md).
package/api.mjs CHANGED
@@ -1,16 +1,21 @@
1
1
  // Generated by lawspec-dev generate. Do not edit.
2
2
  import {loadCore} from './launcher.mjs';
3
3
 
4
- export async function createCompiler() {
4
+ export async function createCompiler()
5
+ {
5
6
  const call = await loadCore();
6
7
  return {
7
- format: (input) => call({schemaVersion: 5, ...input, method: 'format'}),
8
- check: (input) => call({schemaVersion: 5, ...input, method: 'check'}),
9
- expand: (input) => call({schemaVersion: 5, ...input, method: 'expand'}),
10
- explain: (input) => call({schemaVersion: 5, ...input, method: 'explain'}),
11
- proofTasks: (input) =>
12
- call({schemaVersion: 5, ...input, method: 'proofTasks'}),
13
- planGeneration: (input) =>
14
- call({schemaVersion: 5, ...input, method: 'planGeneration'}),
8
+ prelude: input => call({schemaVersion: 5, ...input, method: 'prelude'}),
9
+ inspect: input => call({schemaVersion: 5, ...input, method: 'inspect'}),
10
+ advise: async input =>
11
+ (await import('./authoring.mjs')).advise(call, input),
12
+ format: input => call({schemaVersion: 5, ...input, method: 'format'}),
13
+ check: input => call({schemaVersion: 5, ...input, method: 'check'}),
14
+ expand: input => call({schemaVersion: 5, ...input, method: 'expand'}),
15
+ explain: input => call({schemaVersion: 5, ...input, method: 'explain'}),
16
+ proofTasks: input =>
17
+ call({schemaVersion: 5, ...input, method: 'proofTasks'}),
18
+ planGeneration: input =>
19
+ call({schemaVersion: 5, ...input, method: 'planGeneration'}),
15
20
  };
16
21
  }