@inventarch/cli 0.0.0-stage → 1.1.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 (115) hide show
  1. package/LANGUAGE.md +56 -0
  2. package/LICENSE +202 -0
  3. package/NOTICE +4 -0
  4. package/README.md +21 -2
  5. package/SPEC.md +32 -0
  6. package/assets/base/78bff5eb3188b628c06d2f1cf1477fb1bfcea874ec3863ae112b4972b8e81517.ia.tgz +0 -0
  7. package/assets/base.json +6 -0
  8. package/assets/host/ba7fbad5c6b0dfb697a3408894b499f0970afb92f1677f2db126dac06f23b0b9.tgz +0 -0
  9. package/assets/host.json +6 -0
  10. package/assets/vocabulary.json +3364 -0
  11. package/dist/args.d.ts +62 -0
  12. package/dist/args.d.ts.map +1 -0
  13. package/dist/args.js +117 -0
  14. package/dist/args.js.map +1 -0
  15. package/dist/briefing.d.ts +76 -0
  16. package/dist/briefing.d.ts.map +1 -0
  17. package/dist/briefing.js +105 -0
  18. package/dist/briefing.js.map +1 -0
  19. package/dist/channel.d.ts +22 -0
  20. package/dist/channel.d.ts.map +1 -0
  21. package/dist/channel.js +82 -0
  22. package/dist/channel.js.map +1 -0
  23. package/dist/claude-cli.d.ts +38 -0
  24. package/dist/claude-cli.d.ts.map +1 -0
  25. package/dist/claude-cli.js +121 -0
  26. package/dist/claude-cli.js.map +1 -0
  27. package/dist/commands.d.ts +39 -0
  28. package/dist/commands.d.ts.map +1 -0
  29. package/dist/commands.js +436 -0
  30. package/dist/commands.js.map +1 -0
  31. package/dist/compile.d.ts +39 -0
  32. package/dist/compile.d.ts.map +1 -0
  33. package/dist/compile.js +136 -0
  34. package/dist/compile.js.map +1 -0
  35. package/dist/consumer.d.ts +137 -0
  36. package/dist/consumer.d.ts.map +1 -0
  37. package/dist/consumer.js +366 -0
  38. package/dist/consumer.js.map +1 -0
  39. package/dist/decline.d.ts +7 -0
  40. package/dist/decline.d.ts.map +1 -0
  41. package/dist/decline.js +78 -0
  42. package/dist/decline.js.map +1 -0
  43. package/dist/distribute.d.ts +163 -0
  44. package/dist/distribute.d.ts.map +1 -0
  45. package/dist/distribute.js +664 -0
  46. package/dist/distribute.js.map +1 -0
  47. package/dist/doctor-user.d.ts +45 -0
  48. package/dist/doctor-user.d.ts.map +1 -0
  49. package/dist/doctor-user.js +193 -0
  50. package/dist/doctor-user.js.map +1 -0
  51. package/dist/doctor.d.ts +60 -0
  52. package/dist/doctor.d.ts.map +1 -0
  53. package/dist/doctor.js +754 -0
  54. package/dist/doctor.js.map +1 -0
  55. package/dist/format.d.ts +25 -0
  56. package/dist/format.d.ts.map +1 -0
  57. package/dist/format.js +168 -0
  58. package/dist/format.js.map +1 -0
  59. package/dist/home-remedy.d.ts +10 -0
  60. package/dist/home-remedy.d.ts.map +1 -0
  61. package/dist/home-remedy.js +26 -0
  62. package/dist/home-remedy.js.map +1 -0
  63. package/dist/host-projection.d.ts +11 -0
  64. package/dist/host-projection.d.ts.map +1 -0
  65. package/dist/host-projection.js +73 -0
  66. package/dist/host-projection.js.map +1 -0
  67. package/dist/host.d.ts +162 -0
  68. package/dist/host.d.ts.map +1 -0
  69. package/dist/host.js +599 -0
  70. package/dist/host.js.map +1 -0
  71. package/dist/init.d.ts +219 -0
  72. package/dist/init.d.ts.map +1 -0
  73. package/dist/init.js +846 -0
  74. package/dist/init.js.map +1 -0
  75. package/dist/inspect.d.ts +32 -0
  76. package/dist/inspect.d.ts.map +1 -0
  77. package/dist/inspect.js +226 -0
  78. package/dist/inspect.js.map +1 -0
  79. package/dist/main.d.ts +24 -0
  80. package/dist/main.d.ts.map +1 -0
  81. package/dist/main.js +215 -0
  82. package/dist/main.js.map +1 -0
  83. package/dist/operation-help.d.ts +14 -0
  84. package/dist/operation-help.d.ts.map +1 -0
  85. package/dist/operation-help.js +75 -0
  86. package/dist/operation-help.js.map +1 -0
  87. package/dist/pack.d.ts +17 -0
  88. package/dist/pack.d.ts.map +1 -0
  89. package/dist/pack.js +121 -0
  90. package/dist/pack.js.map +1 -0
  91. package/dist/program.d.ts +64 -0
  92. package/dist/program.d.ts.map +1 -0
  93. package/dist/program.js +125 -0
  94. package/dist/program.js.map +1 -0
  95. package/dist/render.d.ts +165 -0
  96. package/dist/render.d.ts.map +1 -0
  97. package/dist/render.js +277 -0
  98. package/dist/render.js.map +1 -0
  99. package/dist/session.d.ts +13 -0
  100. package/dist/session.d.ts.map +1 -0
  101. package/dist/session.js +25 -0
  102. package/dist/session.js.map +1 -0
  103. package/dist/user-host.d.ts +63 -0
  104. package/dist/user-host.d.ts.map +1 -0
  105. package/dist/user-host.js +236 -0
  106. package/dist/user-host.js.map +1 -0
  107. package/dist/validate.d.ts +53 -0
  108. package/dist/validate.d.ts.map +1 -0
  109. package/dist/validate.js +220 -0
  110. package/dist/validate.js.map +1 -0
  111. package/dist/vocabulary.d.ts +55 -0
  112. package/dist/vocabulary.d.ts.map +1 -0
  113. package/dist/vocabulary.js +179 -0
  114. package/dist/vocabulary.js.map +1 -0
  115. package/package.json +158 -3
@@ -0,0 +1,236 @@
1
+ /**
2
+ * `ia host <host> --user`: docs/specs/host-plugin-distribution/README.md §6.3 (amended, item 5) and §7.1.
3
+ *
4
+ * Needs no workspace. Plans by default and writes nothing while planning; `--apply` renders the plugin, swaps it into
5
+ * the IA home's marketplace directory, then runs Claude's own `claude plugin …` commands. Without `claude` it
6
+ * materializes and prints the commands. It never reads or edits Claude's settings files. A service refusal keeps its
7
+ * code and message (contract §4.1) and gains the next action the CLI can supply, as `ia host` does.
8
+ */
9
+ import { createHash } from 'node:crypto';
10
+ import { existsSync } from 'node:fs';
11
+ import { join, resolve } from 'node:path';
12
+ import { renderClaudePlugin } from '@inventarch/compliance';
13
+ import { nodeCommand } from '@inventarch/distribution/host';
14
+ import { hostRow } from '@inventarch/distribution/hosts';
15
+ import { assertIaHomeUsable } from '@inventarch/distribution/ia-home';
16
+ import { MARKETPLACE_DIR, materializeMarketplace, readMaterializedPlugin, removeMarketplace, } from '@inventarch/distribution/plugin-home';
17
+ import { UsageError } from './args.js';
18
+ import { detectChannel, updateInstruction } from './channel.js';
19
+ import { claudeRunner, observeClaude, registrationCommands, removalCommands } from './claude-cli.js';
20
+ import { confirm, Refusal, refusalOf } from './consumer.js';
21
+ import { homeSrcRemedy, hostHome, located } from './home-remedy.js';
22
+ import { blockSymbolWidth, commandFacts, document, entry, headerLine, indentOf, quote, words } from './render.js';
23
+ /**
24
+ * §6.2 (amended): the digest is of the files rendered with a placeholder version, so it changes whenever the renderer's
25
+ * output does, including when the recorded Node changes. `node` is the Node that runs the hook.
26
+ */
27
+ export function buildClaudePlugin(input) {
28
+ const base = {
29
+ cliVersion: input.cliVersion,
30
+ channel: input.channel.kind,
31
+ entry: input.entry,
32
+ install: updateInstruction(input.channel),
33
+ node: input.node,
34
+ };
35
+ const draft = renderClaudePlugin({ ...base, version: '0.0.0' });
36
+ const digest = createHash('sha256')
37
+ .update(draft.map((file) => `${file.path}\0${file.text}`).join('\0'))
38
+ .digest('hex');
39
+ const version = `${input.cliVersion}+${digest.slice(0, 12)}`;
40
+ return { version, files: renderClaudePlugin({ ...base, version }) };
41
+ }
42
+ /** The rerun a next action names; the only user-level host is Claude. */
43
+ const rerunOf = (remove) => `ia host claude --user${remove ? ' --remove' : ''} --apply`;
44
+ /** A Claude command as a reader can paste it back. */
45
+ export const claudeCommand = (command) => ['claude', ...command].map(quote).join(' ');
46
+ /**
47
+ * §7.1's plan. It reads the IA home and asks `claude` what it lists; it writes nothing. `claude` is first run (the
48
+ * availability probe) only after every usage check and refusal has passed, so a class-2 invocation does no work
49
+ * (contract §3). The runner is returned so apply reuses it instead of probing again.
50
+ */
51
+ export function collectUserHost(context, runnerFor = claudeRunner) {
52
+ const { args, host } = context;
53
+ const name = args.positionals[0] ?? '';
54
+ // §4: the adapter table decides. Unknown is usage, and so is --root (§7.1); both precede every read.
55
+ const row = hostRow(name);
56
+ if (row === undefined)
57
+ throw new UsageError(`ia host takes claude, codex or cursor; got ${name}`);
58
+ if (args.value('root') !== undefined)
59
+ throw new UsageError('--root does not apply with --user; the user-level entry point belongs to no workspace');
60
+ // §4: a row without a user-level entry point — Codex (partial) and Cursor (planned) — refuses naming the host.
61
+ if (row.user === 'none')
62
+ throw new Refusal('IA-DIST-HOST-UNSUPPORTED', `${row.label} has no user-level entry point in this release; nothing was written`, 3, null, 'Run "ia host claude --user".');
63
+ const home = hostHome(host.env);
64
+ // Host plugin distribution spec §3: refuse a home that looks like a workspace now, before apply attempts a write.
65
+ located(null, homeSrcRemedy(home), () => assertIaHomeUsable(home));
66
+ const channel = detectChannel(host.packageRoot);
67
+ // On macOS and Linux the hook runs under the Node running this command, recorded by its own absolute path (a
68
+ // Homebrew keg's stable opt link), not a version manager's shim; the Windows rendering keeps `node` by name.
69
+ const plugin = buildClaudePlugin({
70
+ cliVersion: host.version,
71
+ channel,
72
+ entry: resolve(host.packageRoot, 'dist/main.js'),
73
+ node: nodeCommand(),
74
+ });
75
+ const marketplace = resolve(home, MARKETPLACE_DIR);
76
+ const remove = args.flag('remove');
77
+ const installed = readMaterializedPlugin(home);
78
+ const runner = runnerFor(host.env);
79
+ const view = {
80
+ host: 'claude',
81
+ remove,
82
+ home,
83
+ marketplace,
84
+ plugin: { version: plugin.version, cli: host.version, channel: channel.kind },
85
+ installed: installed === null ? null : { version: installed.version },
86
+ claude: runner.available,
87
+ // §2.3: registration is idempotent and needs no observation; removal asks claude what exists.
88
+ commands: remove ? removalCommands(observeClaude(runner)) : registrationCommands(marketplace),
89
+ files: plugin.files,
90
+ };
91
+ return { view, runner };
92
+ }
93
+ /**
94
+ * A marketplace refusal from `@inventarch/distribution/plugin-home`, its code and message kept, located at the IA home's
95
+ * `claude` directory (which holds the marketplace and its lock) and given a next action. Anything without an IA-DIST
96
+ * code is not the service's refusal and passes through unchanged.
97
+ */
98
+ function marketplaceRefusal(error, view) {
99
+ const refusal = refusalOf(error);
100
+ if (!refusal.code.startsWith('IA-DIST-'))
101
+ return error;
102
+ const directory = join(view.home, 'claude'), rerun = rerunOf(view.remove);
103
+ const next = refusal.code === 'IA-DIST-INSTALL-BUSY'
104
+ ? // Two causes share the code: files held open during a rename, and another run holding the lock.
105
+ `Wait for any other "ia host --user" run to finish and close Claude Code sessions, editors or terminals using ${directory}; if no run is active, delete ${join(directory, '.lock')}; then rerun "${rerun}".`
106
+ : refusal.code === 'IA-DIST-RECOVERY-REQUIRED'
107
+ ? `Rerun "${rerun}".`
108
+ : refusal.code === 'IA-DIST-PATH-UNSAFE' && existsSync(join(view.home, 'src'))
109
+ ? homeSrcRemedy(view.home)
110
+ : refusal.code === 'IA-DIST-INPUT-INVALID'
111
+ ? `Check the permissions of ${directory}, then rerun "${rerun}".`
112
+ : refusal.next;
113
+ return new Refusal(refusal.code, refusal.message, 3, refusal.where ?? { path: directory }, next);
114
+ }
115
+ function marketplaceStep(view, run) {
116
+ try {
117
+ return run();
118
+ }
119
+ catch (error) {
120
+ throw marketplaceRefusal(error, view);
121
+ }
122
+ }
123
+ /**
124
+ * §6.3: materialize, then register through `claude`; removal runs `claude` first and deletes the directory last, so a
125
+ * failed uninstall leaves the marketplace Claude still points at. A failing command refuses naming itself and the
126
+ * rerun, and the commands before it have run. A rerun converges: registration repeats two idempotent commands, and
127
+ * removal asks claude again what is left (§2.3).
128
+ */
129
+ export function applyUserHost(view, runner) {
130
+ if (!view.remove)
131
+ marketplaceStep(view, () => materializeMarketplace(view.home, view.files));
132
+ const ran = [];
133
+ if (view.claude)
134
+ for (const command of view.commands) {
135
+ const result = runner.run(command);
136
+ if (result.status !== 0)
137
+ throw new Refusal('IA-CLI-HOST-COMMAND-FAILED', `${claudeCommand(command)} exited ${result.status ?? 'without a status'}: ${result.output || 'no output'}`, 3, null, `Run "${claudeCommand(command)}" yourself to see why, then rerun "${rerunOf(view.remove)}".`);
138
+ ran.push([...command]);
139
+ }
140
+ if (view.remove)
141
+ marketplaceStep(view, () => removeMarketplace(view.home));
142
+ const status = view.remove
143
+ ? view.claude
144
+ ? 'plugin-removed'
145
+ : 'plugin-directory-removed'
146
+ : view.claude
147
+ ? 'plugin-registered'
148
+ : 'plugin-materialized';
149
+ return { status, ran };
150
+ }
151
+ /** §7.1 `--json`: the plan always, and `applied` only after an apply. The rendered files are not part of it. */
152
+ const envelope = (view, applied) => ({
153
+ version: 1,
154
+ command: 'host',
155
+ user: true,
156
+ host: view.host,
157
+ apply: applied !== null,
158
+ plan: {
159
+ remove: view.remove,
160
+ home: view.home,
161
+ marketplace: view.marketplace,
162
+ plugin: view.plugin,
163
+ installed: view.installed,
164
+ claude: view.claude,
165
+ commands: view.commands,
166
+ },
167
+ ...(applied === null ? {} : { applied }),
168
+ });
169
+ const DONE = {
170
+ 'plugin-registered': 'Registered: the plugin is written and each claude command exited 0. Claude Code loads it at its next session start.',
171
+ 'plugin-materialized': 'Written; not registered with Claude.',
172
+ 'plugin-removed': 'Removed: each claude command exited 0 and the plugin directory is deleted.',
173
+ 'plugin-directory-removed': 'Deleted the plugin directory; not removed from Claude.',
174
+ };
175
+ const unavailable = (view, applied) => applied
176
+ ? 'claude could not be run: run the claude commands above by hand.'
177
+ : `claude could not be run: apply ${view.remove ? 'deletes the directory' : 'writes the plugin'}, and the claude commands above must then be run by hand.`;
178
+ /** The content column of a depth-1 step (§6.4 rule 2), so a wrapped command breaks within the width. */
179
+ const STEP_COLUMN = (caps) => indentOf(1) + blockSymbolWidth(['step'], caps.ascii) + 2;
180
+ const summary = (view, context, applied = false) => {
181
+ const { caps } = context;
182
+ return [
183
+ [
184
+ ...headerLine('Plan', `host claude --user${view.remove ? ' --remove' : ''}`, [], caps),
185
+ ...headerLine('Home', view.home, [], caps),
186
+ ],
187
+ [
188
+ ...(view.remove
189
+ ? []
190
+ : entry([words(`Write the plugin ${view.plugin.version} to ${view.marketplace}`)], { depth: 1, symbol: 'step' }, caps)),
191
+ ...view.commands.flatMap((command) => entry(commandFacts('', claudeCommand(command), '', STEP_COLUMN(caps), caps), { depth: 1, symbol: 'step' }, caps)),
192
+ ...(view.remove ? entry([words(`Delete ${view.marketplace}`)], { depth: 1, symbol: 'step' }, caps) : []),
193
+ ],
194
+ ...(view.claude ? [] : [entry([words(unavailable(view, applied))], { depth: 1, symbol: 'warning' }, caps)]),
195
+ ];
196
+ };
197
+ function render(view, applied, context) {
198
+ const { caps } = context;
199
+ const [header, ...rest] = summary(view, context, applied !== null);
200
+ return document([
201
+ header,
202
+ applied === null
203
+ ? entry([words('This is a preview. Nothing has been written.')], { depth: 1 }, caps)
204
+ : entry([words(DONE[applied.status])], { depth: 1, symbol: 'success' }, caps),
205
+ ...rest,
206
+ ...(applied === null
207
+ ? [
208
+ entry(commandFacts('Apply with "', `${rerunOf(view.remove)} --yes`, '".', 3, caps), { depth: 0, symbol: 'step' }, caps),
209
+ ]
210
+ : []),
211
+ ], { leadingBlank: true });
212
+ }
213
+ const CONFIRMATION = 'Install the InventArch plugin? [y/N] ';
214
+ const REMOVAL_CONFIRMATION = 'Remove the InventArch plugin? [y/N] ';
215
+ export async function runUserHost(context) {
216
+ const { args, caps, host, json } = context;
217
+ const { view, runner } = collectUserHost(context);
218
+ const done = (applied) => json
219
+ ? { exitCode: 0, stdout: JSON.stringify(envelope(view, applied)) + '\n', stderr: '' }
220
+ : { exitCode: 0, stdout: render(view, applied, context), stderr: '' };
221
+ if (!args.flag('apply'))
222
+ return done(null);
223
+ // §2.8 rule 3. Parsing has already refused every --apply whose question cannot be asked or answered.
224
+ if (!args.flag('yes') &&
225
+ !(await confirm(host.interaction, document(summary(view, context), { leadingBlank: true }), view.remove ? REMOVAL_CONFIRMATION : CONFIRMATION)))
226
+ return {
227
+ exitCode: 0,
228
+ stdout: document([entry([words('Nothing was applied.')], { depth: 0, symbol: 'info' }, caps)], {
229
+ leadingBlank: true,
230
+ }),
231
+ stderr: '',
232
+ };
233
+ host.signal?.throwIfAborted();
234
+ return done(applyUserHost(view, runner));
235
+ }
236
+ //# sourceMappingURL=user-host.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"user-host.js","sourceRoot":"","sources":["../src/user-host.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * `ia validate`: docs/specs/consumer-cli-contract/README.md §2.5, rendered per §6.5 and §7.4/§7.5.
3
+ *
4
+ * Admission is whole-workspace by construction, so positionals restrict reporting and never admission: the
5
+ * summary always states the true total and the exit class is computed from the unfiltered finding set.
6
+ *
7
+ * Acquisition and presentation are separated so that §7's reference blocks can be produced by this verb's own
8
+ * renderer over this verb's own captured data — tools/docs/cli-examples.ts calls `collectValidation` and
9
+ * `renderValidation` rather than recomposing the report from renderer primitives. The only value that tool
10
+ * supplies of its own is the display root, which §2.5 already defines as a CLI-resolved value and which is the
11
+ * one part of this output that differs between machines.
12
+ */
13
+ import { openWorkspaceSession } from '@inventarch/distribution/services';
14
+ import type { Context, Result } from './consumer.js';
15
+ import type { Capabilities } from './render.js';
16
+ type Session = ReturnType<typeof openWorkspaceSession>;
17
+ type Admission = ReturnType<Session['admission']>;
18
+ type Finding = Admission['findings'][number];
19
+ export type Severity = 'error' | 'warning';
20
+ /** §2.5: `fail` on any error, else `not-evaluated` on an unresolved or unevaluated check, else `pass`. */
21
+ export type ReportOutcome = 'pass' | 'fail' | 'not-evaluated';
22
+ export declare const NOT_EVALUATED: ReadonlySet<string>;
23
+ export declare const locationOf: (finding: Finding) => string | null;
24
+ /** §6.5 element 1: a finding with no location of its own is rendered beside the check that produced it. */
25
+ export declare const checkNames: (verdicts: readonly {
26
+ readonly check: string;
27
+ readonly findings: readonly Finding[];
28
+ }[]) => ReadonlyMap<string, string>;
29
+ export interface ValidationView {
30
+ /** The path the CLI resolved, never the runtime's own `result.root`, which is always empty (§2.5). */
31
+ readonly root: string;
32
+ readonly revision: string;
33
+ readonly status: 'admitted' | 'refused';
34
+ readonly outcome: ReportOutcome;
35
+ readonly records: number;
36
+ /** Every finding, unfiltered: the counts and the exit class are computed from this. */
37
+ readonly findings: readonly Finding[];
38
+ readonly checks: ReadonlyMap<string, string>;
39
+ }
40
+ export interface ValidationOptions {
41
+ readonly filters: readonly string[];
42
+ readonly severity: Severity;
43
+ readonly limit: number;
44
+ }
45
+ export declare const DEFAULT_OPTIONS: ValidationOptions;
46
+ export declare const validationExit: (view: ValidationView) => 0 | 1;
47
+ /** Opens the workspace, reads its admission and closes it. The only part of this verb that touches a workspace. */
48
+ export declare function collectValidation(root: string): ValidationView;
49
+ export declare function validationEnvelope(view: ValidationView, options: ValidationOptions): unknown;
50
+ export declare function renderValidation(view: ValidationView, options: ValidationOptions, caps: Capabilities): string;
51
+ export declare function runValidate(context: Context): Result;
52
+ export {};
53
+ //# sourceMappingURL=validate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAwB,MAAM,aAAa,CAAC;AAetE,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AAClD,KAAK,OAAO,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C,0GAA0G;AAC1G,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;AAC9D,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,CAAiE,CAAC;AAmBhH,eAAO,MAAM,UAAU,GAAI,SAAS,OAAO,KAAG,MAAM,GAAG,IACS,CAAC;AASjE,2GAA2G;AAC3G,eAAO,MAAM,UAAU,GACrB,UAAU,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,EAAE,KACrF,WAAW,CAAC,MAAM,EAAE,MAAM,CAM5B,CAAC;AAYF,MAAM,WAAW,cAAc;IAC7B,sGAAsG;IACtG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AACD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AACD,eAAO,MAAM,eAAe,EAAE,iBAAmE,CAAC;AAClG,eAAO,MAAM,cAAc,GAAI,MAAM,cAAc,KAAG,CAAC,GAAG,CAAmD,CAAC;AAE9G,mHAAmH;AACnH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAiC9D;AAmBD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAY5F;AAuED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAoE7G;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAYpD"}
@@ -0,0 +1,220 @@
1
+ /**
2
+ * `ia validate`: docs/specs/consumer-cli-contract/README.md §2.5, rendered per §6.5 and §7.4/§7.5.
3
+ *
4
+ * Admission is whole-workspace by construction, so positionals restrict reporting and never admission: the
5
+ * summary always states the true total and the exit class is computed from the unfiltered finding set.
6
+ *
7
+ * Acquisition and presentation are separated so that §7's reference blocks can be produced by this verb's own
8
+ * renderer over this verb's own captured data — tools/docs/cli-examples.ts calls `collectValidation` and
9
+ * `renderValidation` rather than recomposing the report from renderer primitives. The only value that tool
10
+ * supplies of its own is the display root, which §2.5 already defines as a CLI-resolved value and which is the
11
+ * one part of this output that differs between machines.
12
+ */
13
+ import { openWorkspaceSession } from '@inventarch/distribution/services';
14
+ import { Refusal, requireRoot } from './consumer.js';
15
+ import { atom, blockSymbolWidth, contentColumn, document, entry, errorBlock, headerLine, sectionLabel, statusSymbol, truncateDigest, words, } from './render.js';
16
+ export const NOT_EVALUATED = new Set(['IA-COMP-EDGE-UNRESOLVED', 'IA-COMP-NOT-EVALUATED']);
17
+ /**
18
+ * §6.5's next action "names a command, a file, or a specific thing to change". These are the codes for which one
19
+ * sentence is true of every instance; a code that has no such sentence gets none rather than a filler. Nothing
20
+ * here infers a cause across findings — §7.5's "both errors come from one edit" is an authoring-history claim the
21
+ * finding shape cannot support, so it is not reproduced.
22
+ */
23
+ const ACTIONS = {
24
+ 'IA-COMP-NOT-EVALUATED': 'Supply the evaluator each check above names, then run "ia validate" again.',
25
+ 'IA-COMP-EDGE-UNRESOLVED': 'Resolve or remove the named relationship target, then run "ia validate" again.',
26
+ 'IA-COMP-FRAGMENT-MISSING': 'Declare the named fragment on the target contract, or correct the reference that names it.',
27
+ 'IA-COMP-COVERAGE-MISSING': 'Add an unconditional implementing case for the named requirement, or withdraw the requirement.',
28
+ 'IA-COMP-DISCRIMINATOR-FOREIGN': 'Declare the owning system as a direct requirement, or move the record to a system that already requires it.',
29
+ };
30
+ export const locationOf = (finding) => finding.path === '' ? null : `${finding.path}:${finding.line}`;
31
+ const countsOf = (findings) => ({
32
+ errors: findings.filter((finding) => finding.severity === 'error').length,
33
+ warnings: findings.filter((finding) => finding.severity === 'warning').length,
34
+ notEvaluated: findings.filter((finding) => NOT_EVALUATED.has(finding.code)).length,
35
+ });
36
+ const findingKey = (finding) => JSON.stringify([finding.code, finding.path, finding.line, finding.message]);
37
+ /** §6.5 element 1: a finding with no location of its own is rendered beside the check that produced it. */
38
+ export const checkNames = (verdicts) => {
39
+ const byFinding = new Map();
40
+ for (const verdict of verdicts)
41
+ for (const finding of verdict.findings)
42
+ if (!byFinding.has(findingKey(finding)))
43
+ byFinding.set(findingKey(finding), verdict.check);
44
+ return byFinding;
45
+ };
46
+ /** §2.5: a positional selects for reporting by exact file or by directory prefix, relative to the root. */
47
+ const selects = (finding, filters) => {
48
+ if (filters.length === 0)
49
+ return true;
50
+ const path = finding.path.replaceAll('\\', '/');
51
+ return filters.some((raw) => {
52
+ const filter = raw.replaceAll('\\', '/').replace(/\/+$/, '');
53
+ return path === filter || path.startsWith(filter + '/');
54
+ });
55
+ };
56
+ export const DEFAULT_OPTIONS = { filters: [], severity: 'warning', limit: 50 };
57
+ export const validationExit = (view) => (countsOf(view.findings).errors === 0 ? 0 : 1);
58
+ /** Opens the workspace, reads its admission and closes it. The only part of this verb that touches a workspace. */
59
+ export function collectValidation(root) {
60
+ let session;
61
+ try {
62
+ session = openWorkspaceSession({ root });
63
+ }
64
+ catch (error) {
65
+ const code = error !== null && typeof error === 'object' && 'code' in error && typeof error.code === 'string'
66
+ ? error.code
67
+ : 'IA-DB-ROOT-INVALID';
68
+ throw new Refusal(code, error instanceof Error ? error.message : String(error), 3, { path: root }, code === 'IA-DB-SOURCE-UNAVAILABLE'
69
+ ? `An interrupted installation blocks the read. Run "ia-distribution recover --root ${root}".`
70
+ : 'Pass --root <path> with an existing workspace, or run "ia init" to see what a new one would contain.');
71
+ }
72
+ try {
73
+ const admission = session.admission();
74
+ return {
75
+ root,
76
+ revision: admission.revision,
77
+ status: admission.status,
78
+ outcome: session.reader.report.outcome,
79
+ records: admission.records,
80
+ findings: admission.findings,
81
+ checks: checkNames(session.reader.report.verdicts),
82
+ };
83
+ }
84
+ finally {
85
+ session.close();
86
+ }
87
+ }
88
+ const select = (view, options) => {
89
+ const bySeverity = view.findings.filter((finding) => options.severity === 'warning' || finding.severity === 'error');
90
+ const reported = bySeverity.filter((finding) => selects(finding, options.filters));
91
+ return {
92
+ reported,
93
+ shown: reported.slice(0, options.limit),
94
+ hiddenBySeverity: view.findings.length - bySeverity.length,
95
+ hiddenByPath: bySeverity.length - reported.length,
96
+ };
97
+ };
98
+ export function validationEnvelope(view, options) {
99
+ const { reported, shown } = select(view, options);
100
+ return {
101
+ version: 1,
102
+ root: view.root,
103
+ revision: view.revision,
104
+ status: view.status,
105
+ reportOutcome: view.outcome,
106
+ counts: countsOf(view.findings),
107
+ findings: shown,
108
+ truncated: shown.length < reported.length,
109
+ };
110
+ }
111
+ const element = (view, finding, width) => {
112
+ const location = locationOf(finding);
113
+ const check = view.checks.get(findingKey(finding));
114
+ // The whole-workspace checks embed their own name in the message; elements 1 and 3 already carry it.
115
+ const message = check !== undefined && finding.message.startsWith(check + ': ')
116
+ ? finding.message.slice(check.length + 2)
117
+ : finding.message;
118
+ return {
119
+ location,
120
+ ...(location === null && check !== undefined ? { check } : {}),
121
+ ...(finding.identity === undefined ? {} : { identity: finding.identity }),
122
+ code: finding.code,
123
+ message,
124
+ severity: finding.severity,
125
+ symbolWidth: width,
126
+ };
127
+ };
128
+ /** §7.4's collapse: findings differing only in the fragment their message names are one row plus a dim tail. */
129
+ const FRAGMENT = /#[A-Za-z0-9][A-Za-z0-9-]*/;
130
+ const recordKey = (finding) => JSON.stringify([finding.code, finding.path, finding.line, finding.identity ?? null]);
131
+ const collapseByRecord = (findings) => {
132
+ const rows = [];
133
+ for (const finding of findings) {
134
+ const previous = rows.at(-1);
135
+ // Only an adjacent run collapses, so the document order the compliance layer sorted into is preserved.
136
+ if (previous !== undefined && recordKey(previous.head) === recordKey(finding) && finding.path !== '')
137
+ previous.rest.push(finding);
138
+ else
139
+ rows.push({ head: finding, rest: [] });
140
+ }
141
+ return rows;
142
+ };
143
+ const collapseTail = (rest) => {
144
+ const fragments = rest.map((finding) => FRAGMENT.exec(finding.message)?.[0]);
145
+ const named = fragments.every((fragment) => fragment !== undefined) ? fragments.join(', ') : '';
146
+ return `${rest.length} more on this record${named === '' ? '.' : `: ${named}`}`;
147
+ };
148
+ /**
149
+ * §6.5's grouping rule: "When several findings share a next action, the action is printed once under the group
150
+ * rather than repeated per finding." A next action is keyed by finding code, so an adjacent run of one code is
151
+ * one group and its action is attached to the group's last rendered entry, where errorBlock places it.
152
+ */
153
+ const severitySection = (view, rows, caps) => {
154
+ const width = blockSymbolWidth(rows.map((finding) => finding.severity), caps.ascii);
155
+ const collapsed = collapseByRecord(rows);
156
+ const lines = [];
157
+ for (const [index, group] of collapsed.entries()) {
158
+ const column = contentColumn(2, statusSymbol(group.head.severity, caps.ascii), width);
159
+ lines.push(...errorBlock(element(view, group.head, width), { depth: 1 }, caps));
160
+ if (group.rest.length > 0)
161
+ lines.push(...entry([[atom(collapseTail(group.rest), 'dim', 0)]], { column, symbol: 'info' }, caps));
162
+ const action = ACTIONS[group.head.code];
163
+ // The action closes the run, so a code that appears several times in a row carries one action, not one each.
164
+ if (action !== undefined && collapsed[index + 1]?.head.code !== group.head.code)
165
+ lines.push(...entry([words(action)], { column, symbol: 'step' }, caps));
166
+ }
167
+ return lines;
168
+ };
169
+ export function renderValidation(view, options, caps) {
170
+ const total = countsOf(view.findings);
171
+ const { reported, shown, hiddenBySeverity, hiddenByPath } = select(view, options);
172
+ const summary = [
173
+ words(`${view.status === 'admitted' ? 'Admitted' : 'Refused'}. ${view.records} records, ${total.errors} errors, ${total.warnings} warnings.`),
174
+ ];
175
+ if (hiddenBySeverity > 0)
176
+ summary.push(words(`${hiddenBySeverity} warnings hidden by --severity ${options.severity}.`));
177
+ if (hiddenByPath > 0)
178
+ summary.push(words(`${hiddenByPath} ${hiddenByPath === 1 ? 'finding' : 'findings'} elsewhere in the workspace hidden by the path filter; admission is whole-workspace and the counts above are unfiltered.`));
179
+ if (view.outcome === 'not-evaluated')
180
+ summary.push(words(`Admission outcome: not-evaluated. No evaluator was supplied for ${total.notEvaluated} checks, so this run is not a pass.`));
181
+ const blocks = [
182
+ headerLine('Workspace', view.root, [{ text: `revision ${truncateDigest(view.revision, caps.ascii)}`, column: 50 }], caps),
183
+ entry(summary, { depth: 1, symbol: total.errors === 0 ? 'success' : 'error' }, caps),
184
+ ];
185
+ for (const group of [
186
+ { label: 'Errors', severity: 'error' },
187
+ { label: 'Warnings', severity: 'warning' },
188
+ ]) {
189
+ const rows = shown.filter((finding) => finding.severity === group.severity);
190
+ if (rows.length === 0)
191
+ continue;
192
+ blocks.push([sectionLabel(group.label, caps), ...severitySection(view, rows, caps)]);
193
+ }
194
+ if (shown.length < reported.length)
195
+ blocks.push(entry([
196
+ words(`${caps.ascii ? '...' : '…'} and ${reported.length - shown.length} more; raise --max-findings to see them.`, 'dim'),
197
+ ], { depth: 0 }, caps));
198
+ blocks.push(entry([
199
+ words(total.errors > 0
200
+ ? 'Fix the errors above and run "ia validate" again.'
201
+ : view.outcome === 'not-evaluated'
202
+ ? 'A not-evaluated result is not a pass. Supply the named evaluator to obtain one.'
203
+ : 'Every declared structural obligation is satisfied at this revision.'),
204
+ ], { depth: 0, symbol: 'step' }, caps));
205
+ return document(blocks, { leadingBlank: true });
206
+ }
207
+ export function runValidate(context) {
208
+ const { args, caps, json } = context;
209
+ const view = collectValidation(requireRoot(context));
210
+ const options = {
211
+ filters: args.positionals,
212
+ severity: (args.value('severity') ?? 'warning'),
213
+ limit: args.integer('max-findings', 50),
214
+ };
215
+ const exitCode = validationExit(view);
216
+ return json
217
+ ? { exitCode, stdout: JSON.stringify(validationEnvelope(view, options)) + '\n', stderr: '' }
218
+ : { exitCode, stdout: renderValidation(view, options, caps), stderr: '' };
219
+ }
220
+ //# sourceMappingURL=validate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,55 @@
1
+ import type { Context, Result } from './consumer.js';
2
+ interface SchemaSection {
3
+ readonly name: string;
4
+ readonly required: boolean;
5
+ }
6
+ interface SchemaField {
7
+ readonly path: string;
8
+ readonly type: unknown;
9
+ readonly required: boolean;
10
+ readonly description?: string;
11
+ /** W0 narrowings the catalogue carries beside the type: `id in [...]`, `ref to <word>`, `text form <form>`. */
12
+ readonly values?: readonly string[];
13
+ readonly target?: string;
14
+ readonly form?: string;
15
+ }
16
+ interface SchemaEdge {
17
+ readonly predicate: string;
18
+ readonly target: string;
19
+ readonly cardinality: string;
20
+ readonly required: boolean;
21
+ }
22
+ interface WordSchema {
23
+ readonly name: string;
24
+ readonly path: string;
25
+ readonly closed: boolean;
26
+ readonly sections: readonly SchemaSection[];
27
+ readonly fields: readonly SchemaField[];
28
+ readonly edges: readonly SchemaEdge[];
29
+ }
30
+ export interface Word {
31
+ readonly word: string;
32
+ readonly owner: string;
33
+ readonly kind: string;
34
+ readonly category: string;
35
+ readonly facets: readonly string[];
36
+ readonly identity: string;
37
+ readonly description: string;
38
+ readonly schema: WordSchema;
39
+ readonly kernelMembers: readonly string[];
40
+ readonly consumer: string;
41
+ /** Absent from every word the generator emits today; §2.2 and §8 both record that. */
42
+ readonly example?: string;
43
+ }
44
+ export interface Catalogue {
45
+ readonly version: number;
46
+ readonly language: string;
47
+ readonly status: string;
48
+ readonly sourceDigest: string;
49
+ readonly words: readonly Word[];
50
+ }
51
+ export declare const CATALOGUE_PATH = "assets/vocabulary.json";
52
+ export declare function readCatalogue(packageRoot: string): Catalogue;
53
+ export declare function runVocabulary(context: Context): Result;
54
+ export {};
55
+ //# sourceMappingURL=vocabulary.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../src/vocabulary.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAMrD,UAAU,aAAa;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AACD,UAAU,WAAW;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,+GAA+G;IAC/G,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AACD,UAAU,UAAU;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AACD,UAAU,UAAU;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CACvC;AACD,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sFAAsF;IACtF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AACD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;CACjC;AAED,eAAO,MAAM,cAAc,2BAA2B,CAAC;AACvD,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAa5D;AA2HD,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CA0GtD"}