@interf/compiler 0.18.0 → 0.21.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 (129) hide show
  1. package/README.md +87 -73
  2. package/dist/cli/commands/mcp.d.ts +0 -34
  3. package/dist/cli/commands/mcp.js +246 -45
  4. package/dist/cli/commands/method.js +261 -15
  5. package/dist/cli/commands/prep.js +61 -16
  6. package/dist/cli/commands/runs.js +103 -9
  7. package/dist/cli/commands/status.js +4 -2
  8. package/dist/cli/commands/test.d.ts +10 -0
  9. package/dist/cli/commands/{verify.js → test.js} +16 -18
  10. package/dist/cli/commands/web.js +82 -8
  11. package/dist/cli/commands/wizard.js +36 -37
  12. package/dist/cli/index.d.ts +2 -2
  13. package/dist/cli/index.js +3 -3
  14. package/dist/compiler-ui/404.html +1 -1
  15. package/dist/compiler-ui/__next.__PAGE__.txt +5 -5
  16. package/dist/compiler-ui/__next._full.txt +13 -12
  17. package/dist/compiler-ui/__next._head.txt +3 -3
  18. package/dist/compiler-ui/__next._index.txt +5 -4
  19. package/dist/compiler-ui/__next._tree.txt +4 -3
  20. package/dist/compiler-ui/_next/static/chunks/01646j7yi.w5a.css +1 -0
  21. package/dist/compiler-ui/_next/static/chunks/{0n51hrfoufc7g.js → 02f_.8.ebn556.js} +1 -1
  22. package/dist/compiler-ui/_next/static/chunks/02r7siaw-_p5w.js +1 -0
  23. package/dist/compiler-ui/_next/static/chunks/{08m7vf5asqlsm.js → 04d0ly-7xb~-j.js} +10 -10
  24. package/dist/compiler-ui/_next/static/chunks/0fhs9psnxqd8s.js +1 -0
  25. package/dist/compiler-ui/_next/static/chunks/0mssmhpbifj15.css +2 -0
  26. package/dist/compiler-ui/_next/static/chunks/0nypu~ddwxari.js +116 -0
  27. package/dist/compiler-ui/_next/static/chunks/0p3s8iyhgcww2.js +31 -0
  28. package/dist/compiler-ui/_next/static/chunks/0tjf-vu_rz8s0.css +1 -0
  29. package/dist/compiler-ui/_next/static/chunks/0u6p3fpbbfgtl.js +1 -0
  30. package/dist/compiler-ui/_next/static/chunks/0wpx5..8dnh0w.js +1 -0
  31. package/dist/compiler-ui/_next/static/chunks/0y0uj160p0ts~.js +1 -0
  32. package/dist/compiler-ui/_next/static/chunks/10t8l~_oenf.c.js +1 -0
  33. package/dist/compiler-ui/_next/static/chunks/13gz9e7z~imx1.js +5 -0
  34. package/dist/compiler-ui/_next/static/chunks/156xed-b6czaw.js +1 -0
  35. package/dist/compiler-ui/_next/static/chunks/{turbopack-0.uq1k8c0j4s..js → turbopack-02-3e_c-yz~5g.js} +1 -1
  36. package/dist/compiler-ui/_next/static/chunks/{turbopack-10e~t1yzi4svj.js → turbopack-0apv8vb-nczuy.js} +1 -1
  37. package/dist/compiler-ui/_not-found/__next._full.txt +10 -9
  38. package/dist/compiler-ui/_not-found/__next._head.txt +3 -3
  39. package/dist/compiler-ui/_not-found/__next._index.txt +5 -4
  40. package/dist/compiler-ui/_not-found/__next._not-found.__PAGE__.txt +2 -2
  41. package/dist/compiler-ui/_not-found/__next._not-found.txt +3 -3
  42. package/dist/compiler-ui/_not-found/__next._tree.txt +3 -2
  43. package/dist/compiler-ui/_not-found.html +1 -1
  44. package/dist/compiler-ui/_not-found.txt +10 -9
  45. package/dist/compiler-ui/index.html +1 -1
  46. package/dist/compiler-ui/index.txt +13 -12
  47. package/dist/packages/contracts/lib/schema.d.ts +4 -0
  48. package/dist/packages/contracts/lib/schema.js +2 -1
  49. package/dist/packages/engine/action-definitions.d.ts +174 -13
  50. package/dist/packages/engine/action-definitions.js +125 -122
  51. package/dist/packages/engine/action-planner.js +4 -11
  52. package/dist/packages/engine/agents/lib/shells.d.ts +3 -1
  53. package/dist/packages/engine/agents/lib/shells.js +8 -4
  54. package/dist/packages/engine/agents/role-executors.js +1 -1
  55. package/dist/packages/engine/compile/compiled-paths.js +6 -6
  56. package/dist/packages/engine/connection-config.js +1 -1
  57. package/dist/packages/engine/execution/lib/schema.d.ts +10 -0
  58. package/dist/packages/engine/instance-paths.d.ts +15 -9
  59. package/dist/packages/engine/instance-paths.js +15 -9
  60. package/dist/packages/engine/lib/schema.d.ts +686 -30
  61. package/dist/packages/engine/lib/schema.js +48 -21
  62. package/dist/packages/engine/native-run-handlers.js +10 -8
  63. package/dist/packages/engine/preparation-store.d.ts +9 -13
  64. package/dist/packages/engine/preparation-store.js +12 -0
  65. package/dist/packages/engine/requested-artifacts.d.ts +5 -0
  66. package/dist/packages/engine/requested-artifacts.js +36 -0
  67. package/dist/packages/engine/routes.d.ts +1 -1
  68. package/dist/packages/engine/routes.js +1 -1
  69. package/dist/packages/engine/run-observability.js +3 -2
  70. package/dist/packages/engine/runtime-proposal-helpers.d.ts +2 -2
  71. package/dist/packages/engine/runtime-proposal-helpers.js +5 -7
  72. package/dist/packages/engine/runtime-resource-builders.d.ts +5 -0
  73. package/dist/packages/engine/runtime-resource-builders.js +13 -2
  74. package/dist/packages/engine/runtime.d.ts +3 -1
  75. package/dist/packages/engine/runtime.js +146 -21
  76. package/dist/packages/engine/server.js +104 -52
  77. package/dist/packages/engine/verify/verify-execution.js +1 -1
  78. package/dist/packages/engine/wire-schemas.d.ts +5 -1
  79. package/dist/packages/engine/wire-schemas.js +1 -1
  80. package/dist/packages/methods/authoring/method-authoring.d.ts +3 -1
  81. package/dist/packages/methods/authoring/method-authoring.js +5 -36
  82. package/dist/packages/methods/package/builtin-compiled-method.js +1 -1
  83. package/dist/packages/methods/package/local-methods.d.ts +1 -0
  84. package/dist/packages/methods/package/local-methods.js +19 -4
  85. package/dist/packages/methods/package/method-definitions.js +1 -1
  86. package/dist/packages/project/interf-detect.js +6 -6
  87. package/dist/packages/project/lib/schema.d.ts +193 -0
  88. package/dist/packages/project/lib/schema.js +46 -1
  89. package/dist/packages/project/source-config.js +4 -0
  90. package/dist/packages/project/source-folders.js +1 -1
  91. package/package.json +7 -8
  92. package/public-repo/CONTRIBUTING.md +47 -0
  93. package/public-repo/LICENSE.md +1 -0
  94. package/public-repo/README.md +325 -0
  95. package/public-repo/SECURITY.md +67 -0
  96. package/public-repo/TRADEMARKS.md +8 -0
  97. package/{builtin-methods → public-repo/methods}/interf-default/README.md +4 -0
  98. package/{builtin-methods → public-repo/methods}/interf-default/compile/stages/shape/SKILL.md +4 -8
  99. package/{builtin-methods → public-repo/methods}/interf-default/method.json +1 -1
  100. package/public-repo/methods/interf-default/use/query/SKILL.md +23 -0
  101. package/public-repo/plugins/README.md +9 -0
  102. package/public-repo/plugins/interf/.claude-plugin/plugin.json +21 -0
  103. package/public-repo/plugins/interf/.mcp.json +12 -0
  104. package/public-repo/plugins/interf/README.md +29 -0
  105. package/public-repo/plugins/interf/skills/interf/SKILL.md +477 -0
  106. package/public-repo/skills/interf/SKILL.md +477 -0
  107. package/agent-skills/interf-actions/SKILL.md +0 -185
  108. package/agent-skills/interf-actions/references/cli.md +0 -243
  109. package/builtin-methods/interf-default/use/query/SKILL.md +0 -28
  110. package/dist/cli/commands/verify.d.ts +0 -10
  111. package/dist/compiler-ui/_next/static/chunks/06yhdspx~ca5-.js +0 -5
  112. package/dist/compiler-ui/_next/static/chunks/06z~l3kwb891e.js +0 -1
  113. package/dist/compiler-ui/_next/static/chunks/08g7lvje.te.u.js +0 -1
  114. package/dist/compiler-ui/_next/static/chunks/0_c_tvh-cukjz.css +0 -3
  115. package/dist/compiler-ui/_next/static/chunks/0_i-3_5l9t2qe.js +0 -1
  116. package/dist/compiler-ui/_next/static/chunks/0b-ywny_j0g~0.js +0 -1
  117. package/dist/compiler-ui/_next/static/chunks/0b52v41o1gixx.js +0 -1
  118. package/dist/compiler-ui/_next/static/chunks/0f_geuwdesg_c.js +0 -114
  119. package/dist/compiler-ui/_next/static/chunks/0gpzgsv0w.q~m.js +0 -31
  120. package/dist/compiler-ui/_next/static/chunks/0ilwfezfvu6~-.js +0 -1
  121. package/dist/compiler-ui/_next/static/chunks/0xxmf45eskdt~.css +0 -1
  122. package/dist/compiler-ui/_next/static/chunks/14wtz~vq25~qq.js +0 -1
  123. /package/dist/compiler-ui/_next/static/{6qyE1u9m_oBUkvAhhoCmO → tYHMLL9oKds1yDoNYgkPV}/_buildManifest.js +0 -0
  124. /package/dist/compiler-ui/_next/static/{6qyE1u9m_oBUkvAhhoCmO → tYHMLL9oKds1yDoNYgkPV}/_clientMiddlewareManifest.js +0 -0
  125. /package/dist/compiler-ui/_next/static/{6qyE1u9m_oBUkvAhhoCmO → tYHMLL9oKds1yDoNYgkPV}/_ssgManifest.js +0 -0
  126. /package/{builtin-methods → public-repo/methods}/interf-default/compile/stages/structure/SKILL.md +0 -0
  127. /package/{builtin-methods → public-repo/methods}/interf-default/compile/stages/summarize/SKILL.md +0 -0
  128. /package/{builtin-methods → public-repo/methods}/interf-default/improve/SKILL.md +0 -0
  129. /package/{builtin-methods → public-repo/methods}/interf-default/method.schema.json +0 -0
@@ -1,243 +0,0 @@
1
- # Interf CLI Reference Snapshot
2
-
3
- <!-- Generated from the built CLI help by scripts/docs/sync-agent-skill-cli-reference.mjs. Do not edit by hand. -->
4
-
5
- This snapshot is bundled with the `interf-actions` skill. The installed `interf` command remains the source of truth when available.
6
-
7
- ## interf
8
-
9
- ```text
10
- interf
11
-
12
- Open the interactive wizard (default when no subcommand is given)
13
-
14
- Commands:
15
- interf Open the interactive wizard (default when no subcommand is given) [default]
16
- interf init Open the interactive wizard
17
- interf compile <prep-id> Start a compile run for a preparation
18
- interf verify <prep-id> Verify a preparation's claim-checks against its portable context
19
- interf agents <subcommand> Manage connected agents and role mapping
20
- interf doctor Check local executor configuration before a real local run
21
- interf method <subcommand> Manage methods on the connected instance
22
- interf mcp Run the Interf Model Context Protocol server (stdio by default).
23
- interf runs <subcommand> Inspect runs on the connected instance
24
- interf status Show connection + preparation summary
25
- interf web [subcommand] Start / stop / inspect the Interf engine
26
- interf reset <prep-id> Reset a preparation's compile output
27
- interf prep <subcommand> Manage preparations on the connected instance
28
- interf login Set the active Interf instance connection (URL + optional bearer token)
29
- interf logout Clear the active Interf instance connection
30
-
31
- Options:
32
- --help Show help [boolean]
33
- --version Show version number [boolean]
34
- --url Override the active connection URL [string]
35
- --token Override the active bearer token [string]
36
- ```
37
-
38
- ## interf web
39
-
40
- ```text
41
- interf web [subcommand]
42
-
43
- Start / stop / inspect the Interf engine
44
-
45
- Commands:
46
- interf web stop Stop the connected engine
47
- interf web status Show engine status via the connected URL
48
- interf web Start the engine in the foreground (default) [default]
49
-
50
- Options:
51
- --help Show help [boolean]
52
- --version Show version number [boolean]
53
- --host Host to bind [string] [default: "127.0.0.1"]
54
- --port Port to bind [number] [default: 4873]
55
- ```
56
-
57
- ## interf prep
58
-
59
- ```text
60
- interf prep <subcommand>
61
-
62
- Manage preparations on the connected instance
63
-
64
- Commands:
65
- interf prep ls List preparations
66
- interf prep create <prep-id> Create a preparation (method binding optional — set later if you don't have one yet)
67
- interf prep set-method <prep-id> <method-id> Bind a method to a preparation (or change which method it uses)
68
- interf prep show <prep-id> Show a preparation's full record
69
- interf prep rm <prep-id> Delete a preparation
70
-
71
- Options:
72
- --help Show help [boolean]
73
- --version Show version number [boolean]
74
- --url Override the active connection URL [string]
75
- --token Override the active bearer token [string]
76
- ```
77
-
78
- ## interf compile
79
-
80
- ```text
81
- interf compile <prep-id>
82
-
83
- Start a compile run for a preparation
84
-
85
- Positionals:
86
- prep-id Preparation id [string] [required]
87
-
88
- Options:
89
- --help Show help [boolean]
90
- --version Show version number [boolean]
91
- --watch Stream run events [boolean] [default: false]
92
- --quiet Print only the portable-context locator on success [boolean] [default: false]
93
- --idempotency-key Client-supplied dedupe key [string]
94
- --url Override the active connection URL [string]
95
- --token Override the active bearer token [string]
96
- ```
97
-
98
- ## interf verify
99
-
100
- ```text
101
- interf verify <prep-id>
102
-
103
- Verify a preparation's claim-checks against its portable context
104
-
105
- Positionals:
106
- prep-id Preparation id [string] [required]
107
-
108
- Options:
109
- --help Show help [boolean]
110
- --version Show version number [boolean]
111
- --url Override the active connection URL [string]
112
- --token Override the active bearer token [string]
113
- ```
114
-
115
- ## interf method
116
-
117
- ```text
118
- interf method <subcommand>
119
-
120
- Manage methods on the connected instance
121
-
122
- Commands:
123
- interf method ls List methods on the instance
124
- interf method install <path> Install a method package from a local folder
125
- interf method draft <prep-id> Start a method-authoring run for a preparation
126
- interf method improve <prep-id> Start a method-improvement run for a preparation
127
-
128
- Options:
129
- --help Show help [boolean]
130
- --version Show version number [boolean]
131
- --url Override the active connection URL [string]
132
- --token Override the active bearer token [string]
133
- ```
134
-
135
- ## interf runs
136
-
137
- ```text
138
- interf runs <subcommand>
139
-
140
- Inspect runs on the connected instance
141
-
142
- Commands:
143
- interf runs ls List runs (optionally filtered by preparation)
144
- interf runs status <run-id> Show full record for a run
145
- interf runs cancel <run-id> Cancel a running run
146
- interf runs fetch <run-id> Download a run's portable context
147
-
148
- Options:
149
- --help Show help [boolean]
150
- --version Show version number [boolean]
151
- --url Override the active connection URL [string]
152
- --token Override the active bearer token [string]
153
- ```
154
-
155
- ## interf runs fetch
156
-
157
- ```text
158
- interf runs fetch <run-id>
159
-
160
- Download a run's portable context
161
-
162
- Positionals:
163
- run-id Run id [string] [required]
164
-
165
- Options:
166
- --help Show help [boolean]
167
- --version Show version number [boolean]
168
- --url Override the active connection URL [string]
169
- --token Override the active bearer token [string]
170
- --to Target path [string] [required]
171
- ```
172
-
173
- ## interf status
174
-
175
- ```text
176
- interf status
177
-
178
- Show connection + preparation summary
179
-
180
- Options:
181
- --help Show help [boolean]
182
- --version Show version number [boolean]
183
- --url Override the active connection URL [string]
184
- --token Override the active bearer token [string]
185
- ```
186
-
187
- ## interf login
188
-
189
- ```text
190
- interf login
191
-
192
- Set the active Interf instance connection (URL + optional bearer token)
193
-
194
- Options:
195
- --help Show help [boolean]
196
- --version Show version number [boolean]
197
- --url Engine URL, e.g. https://api.interf.cloud or http://127.0.0.1:4873 [string] [required]
198
- --token Bearer token for non-loopback connections [string]
199
- ```
200
-
201
- ## interf logout
202
-
203
- ```text
204
- interf logout
205
-
206
- Clear the active Interf instance connection
207
-
208
- Options:
209
- --help Show help [boolean]
210
- --version Show version number [boolean]
211
- ```
212
-
213
- ## interf reset
214
-
215
- ```text
216
- interf reset <prep-id>
217
-
218
- Reset a preparation's compile output
219
-
220
- Positionals:
221
- prep-id Preparation id [string] [required]
222
-
223
- Options:
224
- --help Show help [boolean]
225
- --version Show version number [boolean]
226
- --mode Scope of the reset [string] [choices: "compile", "all"] [default: "compile"]
227
- --url Override the active connection URL [string]
228
- --token Override the active bearer token [string]
229
- ```
230
-
231
- ## interf doctor
232
-
233
- ```text
234
- interf doctor
235
-
236
- Check local executor configuration before a real local run
237
-
238
- Options:
239
- --help Show help [boolean]
240
- --version Show version number [boolean]
241
- --live Run a real executor preflight against the configured local agent [boolean] [default: false]
242
- --json Print machine-readable doctor output [boolean] [default: false]
243
- ```
@@ -1,28 +0,0 @@
1
- # Manual Query Loop
2
-
3
- This file is the editable authoring source for the generated native local `interf-query` skill.
4
-
5
- Default loop:
6
- 1. Read `home.md` first.
7
- 2. Browse `knowledge/` before source re-checks.
8
- 3. Use `summaries/` for source-grounded evidence.
9
- 4. Use `.interf/runtime/source-snapshot.json` for direct quotes, verification, exact table lookups, and chart-derived values.
10
-
11
- Answering rule:
12
- - do not modify source files while answering
13
- - when a number is chart-derived, say that explicitly
14
- - if the compiled layer already contains a bounded chart-derived read for the exact metric and year the user asked about, answer from that compiled read first
15
- - use source references to confirm the source page, metric family, or provenance, not to replace a good compiled bounded read with a mismatched range
16
- - when the compiled layer preserves a bounded chart-derived range, keep that bounded range in the answer instead of collapsing it to a midpoint or pseudo-exact single value
17
- - match the granularity of the visible axis labels or bands and do not invent finer precision than the chart supports
18
- - when reading charts, verify you are on the correct metric family and year before answering
19
- - keep historical annual charts separate from current-quarter snapshots, sector splits, or nearby lookalike panels
20
- - when a chart-derived value is approximate, use a bounded range instead of a pseudo-exact number.
21
- - keep the answer inside the visible tick band unless the chart supports a tighter bound.
22
- - use an upper-half or lower-half band only when the mark clearly sits there.
23
- - if a mark touches or nearly touches a labeled gridline, anchor the answer at that gridline or the immediately adjacent half-band.
24
- - do not widen a chart-derived range across multiple visible bands unless the chart genuinely supports that uncertainty.
25
- - if multiple compiled notes mention the same chart read, keep the answer consistent with the most focused compiled note rather than synthesizing a new midpoint or shifted band
26
- - when the compiled layer is insufficient, verify against source references and then answer
27
-
28
- You can edit this file to bias manual question-answering behavior for this portable context.
@@ -1,10 +0,0 @@
1
- import type { CommandModule } from "yargs";
2
- type VerifyTarget = "compiled" | "source-files";
3
- interface VerifyArgs {
4
- prepId: string;
5
- target?: VerifyTarget;
6
- url?: string;
7
- token?: string;
8
- }
9
- export declare const verifyCommand: CommandModule<unknown, VerifyArgs>;
10
- export {};