@inventarch/cli 1.1.1 → 2.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 (116) hide show
  1. package/LANGUAGE.md +2 -2
  2. package/README.md +17 -4
  3. package/SPEC.md +51 -7
  4. package/assets/base/0305ca741b1dfec97ff35fbeb36d4a66a0c9c0614b730fe14fcdac0f1565e28a.ia.tgz +0 -0
  5. package/assets/base.json +3 -3
  6. package/assets/host/3d2c8530db8d14755410b17be8228a230d88de96f9dc78f953979d3ca7c6ea62.tgz +0 -0
  7. package/assets/host.json +4 -4
  8. package/assets/vocabulary.json +436 -4
  9. package/dist/bundled-base.d.ts +18 -0
  10. package/dist/bundled-base.d.ts.map +1 -0
  11. package/dist/bundled-base.js +44 -0
  12. package/dist/bundled-base.js.map +1 -0
  13. package/dist/capture.d.ts +108 -0
  14. package/dist/capture.d.ts.map +1 -0
  15. package/dist/capture.js +346 -0
  16. package/dist/capture.js.map +1 -0
  17. package/dist/claude-cli.js +1 -1
  18. package/dist/claude-cli.js.map +1 -1
  19. package/dist/commands.d.ts +23 -1
  20. package/dist/commands.d.ts.map +1 -1
  21. package/dist/commands.js +201 -10
  22. package/dist/commands.js.map +1 -1
  23. package/dist/compile.d.ts +5 -0
  24. package/dist/compile.d.ts.map +1 -1
  25. package/dist/compile.js +40 -51
  26. package/dist/compile.js.map +1 -1
  27. package/dist/consumer.d.ts +48 -7
  28. package/dist/consumer.d.ts.map +1 -1
  29. package/dist/consumer.js +142 -29
  30. package/dist/consumer.js.map +1 -1
  31. package/dist/decline.d.ts.map +1 -1
  32. package/dist/decline.js +15 -7
  33. package/dist/decline.js.map +1 -1
  34. package/dist/distribute.d.ts +68 -16
  35. package/dist/distribute.d.ts.map +1 -1
  36. package/dist/distribute.js +243 -110
  37. package/dist/distribute.js.map +1 -1
  38. package/dist/doctor.d.ts.map +1 -1
  39. package/dist/doctor.js +113 -60
  40. package/dist/doctor.js.map +1 -1
  41. package/dist/format.d.ts +2 -2
  42. package/dist/format.d.ts.map +1 -1
  43. package/dist/format.js +19 -11
  44. package/dist/format.js.map +1 -1
  45. package/dist/home-remedy.d.ts +8 -4
  46. package/dist/home-remedy.d.ts.map +1 -1
  47. package/dist/home-remedy.js +8 -4
  48. package/dist/home-remedy.js.map +1 -1
  49. package/dist/host-projection.d.ts +73 -6
  50. package/dist/host-projection.d.ts.map +1 -1
  51. package/dist/host-projection.js +296 -38
  52. package/dist/host-projection.js.map +1 -1
  53. package/dist/host.d.ts +106 -30
  54. package/dist/host.d.ts.map +1 -1
  55. package/dist/host.js +270 -139
  56. package/dist/host.js.map +1 -1
  57. package/dist/init.d.ts +285 -37
  58. package/dist/init.d.ts.map +1 -1
  59. package/dist/init.js +1270 -205
  60. package/dist/init.js.map +1 -1
  61. package/dist/inspect.d.ts +26 -2
  62. package/dist/inspect.d.ts.map +1 -1
  63. package/dist/inspect.js +117 -52
  64. package/dist/inspect.js.map +1 -1
  65. package/dist/main.d.ts.map +1 -1
  66. package/dist/main.js +3 -1
  67. package/dist/main.js.map +1 -1
  68. package/dist/migration-journal.d.ts +35 -0
  69. package/dist/migration-journal.d.ts.map +1 -0
  70. package/dist/migration-journal.js +205 -0
  71. package/dist/migration-journal.js.map +1 -0
  72. package/dist/next.d.ts +21 -0
  73. package/dist/next.d.ts.map +1 -0
  74. package/dist/next.js +210 -0
  75. package/dist/next.js.map +1 -0
  76. package/dist/operation-help.d.ts.map +1 -1
  77. package/dist/operation-help.js +14 -3
  78. package/dist/operation-help.js.map +1 -1
  79. package/dist/pack.d.ts +3 -1
  80. package/dist/pack.d.ts.map +1 -1
  81. package/dist/pack.js +56 -11
  82. package/dist/pack.js.map +1 -1
  83. package/dist/position.d.ts +22 -0
  84. package/dist/position.d.ts.map +1 -0
  85. package/dist/position.js +242 -0
  86. package/dist/position.js.map +1 -0
  87. package/dist/project.d.ts +42 -0
  88. package/dist/project.d.ts.map +1 -0
  89. package/dist/project.js +232 -0
  90. package/dist/project.js.map +1 -0
  91. package/dist/read.d.ts +31 -0
  92. package/dist/read.d.ts.map +1 -0
  93. package/dist/read.js +152 -0
  94. package/dist/read.js.map +1 -0
  95. package/dist/render.d.ts +19 -0
  96. package/dist/render.d.ts.map +1 -1
  97. package/dist/render.js +44 -1
  98. package/dist/render.js.map +1 -1
  99. package/dist/session.d.ts +12 -1
  100. package/dist/session.d.ts.map +1 -1
  101. package/dist/session.js +68 -6
  102. package/dist/session.js.map +1 -1
  103. package/dist/user-host.d.ts.map +1 -1
  104. package/dist/user-host.js +7 -5
  105. package/dist/user-host.js.map +1 -1
  106. package/dist/validate.d.ts +1 -2
  107. package/dist/validate.d.ts.map +1 -1
  108. package/dist/validate.js +6 -27
  109. package/dist/validate.js.map +1 -1
  110. package/dist/vocabulary.d.ts +4 -0
  111. package/dist/vocabulary.d.ts.map +1 -1
  112. package/dist/vocabulary.js +12 -7
  113. package/dist/vocabulary.js.map +1 -1
  114. package/package.json +6 -6
  115. package/assets/base/78bff5eb3188b628c06d2f1cf1477fb1bfcea874ec3863ae112b4972b8e81517.ia.tgz +0 -0
  116. package/assets/host/b97e367bbf15db09f552d6bd6dd3701210efe77931d34b57ccb85240957aba61.tgz +0 -0
package/dist/next.js ADDED
@@ -0,0 +1,210 @@
1
+ /**
2
+ * `ia next`: position-and-projection §9 step 2 and design rows 21 and 22, the delivery view.
3
+ *
4
+ * The runtime's `deliveryView` reads one plan: its milestones and tasks in one prerequisites-first order, each task with
5
+ * a basis line per requirement, one verdict, its self-declared status and the five state lines of design §10, then the
6
+ * review items and the next task. This verb prints that view, or with `--json` the view the Door's `next` operation
7
+ * returns. A task's own `work.status` is printed and is never its verdict's basis.
8
+ *
9
+ * The view is computed per read and never stored: the workspace opens as every read verb opens it, without the db
10
+ * cache, and the view is read through the whole-workspace scope, the one that may also name the work records admission
11
+ * refused (db PT5). Nothing is written.
12
+ */
13
+ import { deliveryView } from '@inventarch/runtime';
14
+ import { Refusal, requireRoot, respell } from './consumer.js';
15
+ import { atom, blockSymbolWidth, document, entry, headerLine, quote, remedyWords, sectionLabel, terminalText, truncateDigest, words, } from './render.js';
16
+ import { nearestNext, openSession } from './session.js';
17
+ export function nextEnvelope(view) {
18
+ return { version: 1, ok: true, view };
19
+ }
20
+ const VERDICT_SYMBOL = {
21
+ evidenced: 'success',
22
+ unblocked: 'info',
23
+ blocked: 'warning',
24
+ };
25
+ /**
26
+ * The plan and its summary; its milestones, satisfied or not and why; each task in the view's order with its verdict
27
+ * line, its self-declared status, a basis line per requirement and its five state lines; the review items; and, when a
28
+ * task has no declared blocker, the command the view names for it, with the root this invocation gave.
29
+ */
30
+ export function renderNext(view, caps, rooted = '') {
31
+ const symbols = [...Object.values(VERDICT_SYMBOL)];
32
+ const symbolWidth = blockSymbolWidth(symbols, caps.ascii);
33
+ const milestones = view.milestones.flatMap((milestone) => entry([
34
+ [atom(terminalText(milestone.identity), 'cyan', 0)],
35
+ words(`${milestone.satisfied ? 'satisfied' : 'not satisfied'}: ${terminalText(milestone.basis)}`),
36
+ words(terminalText(milestone.status), 'dim'),
37
+ ], { depth: 1, symbol: milestone.satisfied ? 'success' : 'warning', symbolWidth }, caps));
38
+ // One block per task, so each one's lines stand apart from the next task's.
39
+ const tasks = view.tasks.map((task, index) => [
40
+ ...(index === 0 ? [sectionLabel('Tasks', caps)] : []),
41
+ ...entry([
42
+ [atom(terminalText(task.identity), 'cyan', 0)],
43
+ words(terminalText(task.line)),
44
+ words(terminalText(task.status), 'dim'),
45
+ ...task.prerequisites.map((prerequisite) => words(terminalText(`requires ${prerequisite.basis}`))),
46
+ ...task.states.map((state) => words(terminalText(`${state.dimension} ${state.value}: ${state.basis}`), 'dim')),
47
+ ], { depth: 1, symbol: VERDICT_SYMBOL[task.verdict], symbolWidth }, caps),
48
+ ]);
49
+ const review = view.review.length === 0
50
+ ? entry([words('No review item.', 'dim')], { depth: 1 }, caps)
51
+ : view.review.flatMap((item) => entry([
52
+ [atom(item.kind, null, 0), ...words(terminalText(item.message), null, 2)],
53
+ ...(item.owner === undefined
54
+ ? []
55
+ : [[atom('owner', 'dim', 0), atom(terminalText(item.owner), 'cyan', 2)]]),
56
+ ], { depth: 1, symbol: 'warning' }, caps));
57
+ const first = view.tasks.find((task) => task.verdict === 'unblocked');
58
+ const next = view.next === null || first === undefined
59
+ ? null
60
+ : remedyWords(terminalText(`Run "${view.next}${rooted}" for the position of ${first.identity}, the next task with no declared blocker.`));
61
+ return document([
62
+ headerLine('Plan', terminalText(view.plan), [{ text: `revision ${terminalText(truncateDigest(view.revision, caps.ascii))}`, column: 50 }], caps),
63
+ entry([words(terminalText(view.summary))], { depth: 1, symbol: 'info' }, caps),
64
+ milestones.length === 0 ? [] : [sectionLabel('Milestones', caps), ...milestones],
65
+ ...tasks,
66
+ [sectionLabel('Review', caps), ...review],
67
+ next === null ? [] : entry([next], { depth: 0, symbol: 'step' }, caps),
68
+ ], { leadingBlank: true });
69
+ }
70
+ /** The `@<word> <name>` references `identity`'s `work.<key>` states, each item of a list included. */
71
+ function stated(reader, identity, key) {
72
+ const field = reader
73
+ .get(identity)
74
+ ?.sections.find((section) => section.name === 'work')
75
+ ?.fields.find((child) => 'key' in child && child.key === key);
76
+ const value = field === undefined || !('value' in field) ? undefined : field.value;
77
+ return (value === undefined ? [] : value.kind === 'list' ? value.items : [value]).flatMap((item) => item.kind === 'ref' ? [item] : []);
78
+ }
79
+ /** The records admission refused whose identity no other occurrence wins, so none of them is admitted. */
80
+ const refusedOnly = (reader) => reader.refused.filter((record) => reader.get(record.identity) === undefined);
81
+ const validateNext = (rooted, identity) => `Run "ia validate${rooted}" to see why admission refused ${identity}.`;
82
+ /**
83
+ * The record admission refused where a seat's way to its plan breaks, so IA-RUNTIME-NEXT-NO-PLAN names the validation
84
+ * that says why rather than records a source already holds: the @milestone a @task seat's `work.milestone` names, or
85
+ * the @plan that `work.plan` names on its admitted milestone or on a @milestone seat. No reference resolves to a
86
+ * refused record, so one is matched by its word and name.
87
+ */
88
+ function refusedOnTheWay(reader, seat) {
89
+ const refused = refusedOnly(reader);
90
+ const named = (identity, key) => stated(reader, identity, key).flatMap((reference) => refused.flatMap((record) => {
91
+ const [, , word, name] = record.identity.split('/');
92
+ return word === reference.discriminator && name?.toLowerCase() === reference.name.toLowerCase()
93
+ ? [record.identity]
94
+ : [];
95
+ }))[0];
96
+ if (reader.get(seat)?.discriminator !== 'task')
97
+ return named(seat, 'plan');
98
+ const milestone = reader
99
+ .directedView(seat)
100
+ .find((row) => row.kind === 'field-ref' &&
101
+ row.field === 'work.milestone' &&
102
+ row.direction === 'out' &&
103
+ reader.get(row.counterpart)?.discriminator === 'milestone')?.counterpart;
104
+ return milestone === undefined ? named(seat, 'milestone') : named(milestone, 'plan');
105
+ }
106
+ /**
107
+ * The command that reads a plan without a seat, chosen by the @plan records at band 100 the workspace admits, which
108
+ * `deliveryView` counts the same way: the view of the only one; the first of several, which the view refuses to choose
109
+ * between; with none, the validation that says why admission refused a @plan a source holds, else the records to
110
+ * author, then the view.
111
+ */
112
+ function unseated(reader, rooted) {
113
+ const plans = reader
114
+ .records()
115
+ .filter((node) => node.discriminator === 'plan' && node.band === 100)
116
+ .map((node) => node.identity)
117
+ .sort();
118
+ if (plans.length === 1)
119
+ return `Run "ia next${rooted}" to read ${plans[0]}, the only plan the workspace authors.`;
120
+ if (plans.length > 1)
121
+ return `Run "ia next --seat ${quote(plans[0])}${rooted}" to read the first of the ${plans.length} plans the workspace authors; seat any other the same way.`;
122
+ const refused = refusedOnly(reader).find((record) => record.identity.split('/')[2] === 'plan');
123
+ return refused !== undefined
124
+ ? validateNext(rooted, refused.identity)
125
+ : `Author a @plan, @milestone records whose work.plan names it and @task records whose work.milestone names one of them, then run "ia next${rooted}".`;
126
+ }
127
+ /**
128
+ * The record IA-RUNTIME-NEXT-CYCLE's own `next` seats at (runtime SPEC R18), read from the rows the refusal lists: the
129
+ * cycle's first task in the view's order, by milestone then task, else the first milestone a row requires. Every task
130
+ * in the cycle is named by one of its rows and every milestone a row requires closes it, so this is the runtime's seat.
131
+ * The runtime's `next` is not forwarded: a next action this CLI names is built here, where design row 27 is checked.
132
+ */
133
+ function cycleSeat(rows, reader) {
134
+ const milestoneOf = (task) => reader
135
+ .directedView(task)
136
+ .find((row) => row.kind === 'field-ref' &&
137
+ row.field === 'work.milestone' &&
138
+ row.direction === 'out' &&
139
+ reader.get(row.counterpart)?.discriminator === 'milestone')?.counterpart ?? '';
140
+ const byte = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
141
+ const tasks = [...new Set(rows.flatMap((row) => [row.from, row.to]))]
142
+ .filter((identity) => identity.split('/')[2] === 'task')
143
+ .map((task) => ({ task, milestone: milestoneOf(task) }))
144
+ .sort((a, b) => byte(a.milestone, b.milestone) || byte(a.task, b.task));
145
+ return tasks[0]?.task ?? rows.map((row) => row.to).sort(byte)[0];
146
+ }
147
+ /**
148
+ * Design row 27: the one command after each delivery refusal, carrying the root the invocation gave, which the runtime's
149
+ * own `next` does not. A seat the workspace does not admit names what `ia inspect` and `ia read` name for an identity
150
+ * they do not admit (`nearestNext`): the validation for a record admission refused, else the nearest @plan,
151
+ * @milestone or @task as the seat, else the view without a seat (`unseated`). A record of another word names its
152
+ * position, as the runtime does. A missing plan names what the view without a seat names, or with a seat the
153
+ * validation for a record admission refused on its way to its plan, else the records to author, then the same view
154
+ * again. Several plans name the view of the first, which the message lists with the others, and a cycle the sequence
155
+ * position of the record the runtime's own `next` seats at (`cycleSeat`), whose require rows the message lists.
156
+ */
157
+ function nextAfter(refusal, context, rooted, reader) {
158
+ const seat = context.args.value('seat');
159
+ switch (refusal.code) {
160
+ case 'IA-RUNTIME-NEXT-SEAT':
161
+ if (seat !== undefined && reader.get(seat) !== undefined)
162
+ return `Run "ia position --seat ${quote(seat)}${rooted}" for where that record sits; the delivery view is read from a @plan, @milestone or @task.`;
163
+ // deliveryView refuses a seat it does not admit only when it was given one.
164
+ return nearestNext(reader, seat ?? '', 'next', rooted) ?? unseated(reader, rooted);
165
+ case 'IA-RUNTIME-NEXT-NO-PLAN': {
166
+ if (seat === undefined)
167
+ return unseated(reader, rooted);
168
+ const refused = refusedOnTheWay(reader, seat);
169
+ return refused !== undefined
170
+ ? validateNext(rooted, refused)
171
+ : `Author the @plan ${seat} belongs to through work.plan (and work.milestone for a @task), then run "${respell(context)}".`;
172
+ }
173
+ case 'IA-RUNTIME-NEXT-AMBIGUOUS':
174
+ return `Run "ia next --seat ${quote(refusal.plans[0])}${rooted}" to read the first plan the message lists; seat any other the same way.`;
175
+ case 'IA-RUNTIME-NEXT-CYCLE':
176
+ return `Run "ia position --seat ${cycleSeat(refusal.cycle, reader)} --shape sequence${rooted}" for the require rows around the cycle the message names; one of them must go before the plan has an order.`;
177
+ }
178
+ }
179
+ /**
180
+ * §4.1: the runtime's delivery refusal with its code and message unchanged, at exit 1, as `ia inspect` refuses an
181
+ * identity it does not admit: each concerns the workspace's records. A cycle is located at its first declared row.
182
+ */
183
+ export function nextRefusal(refusal, context, root,
184
+ /** The workspace, still open, so the command named follows from what it admits and what admission refused. */
185
+ reader) {
186
+ const seat = context.args.value('seat'), supplied = context.args.value('root'), rooted = supplied === undefined ? '' : ` --root ${quote(supplied)}`, first = refusal.cycle?.[0];
187
+ return new Refusal(refusal.code, refusal.message, 1, first === undefined
188
+ ? { path: root, ...(seat === undefined ? {} : { identity: seat }) }
189
+ : { path: first.path, line: first.line, identity: first.declaredOn }, nextAfter(refusal, context, rooted, reader));
190
+ }
191
+ export function runNext(context) {
192
+ const { args, caps, json } = context;
193
+ const supplied = args.value('root'), rooted = supplied === undefined ? '' : ` --root ${quote(supplied)}`;
194
+ const root = requireRoot(context);
195
+ const session = openSession(root);
196
+ let got;
197
+ try {
198
+ got = deliveryView(session.reader, session.reader.resolveScope().token, args.value('seat'));
199
+ // Refused while the workspace is open, so the seat is told apart by what it admits and refuses.
200
+ if (!got.ok)
201
+ throw nextRefusal(got, context, root, session.reader);
202
+ }
203
+ finally {
204
+ session.close();
205
+ }
206
+ return json
207
+ ? { exitCode: 0, stdout: JSON.stringify(nextEnvelope(got.view)) + '\n', stderr: '' }
208
+ : { exitCode: 0, stdout: renderNext(got.view, caps, rooted), stderr: '' };
209
+ }
210
+ //# sourceMappingURL=next.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"next.js","sourceRoot":"","sources":["../src/next.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"operation-help.d.ts","sourceRoot":"","sources":["../src/operation-help.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAK7D,+FAA+F;AAC/F,eAAO,MAAM,YAAY,aAAa,CAAC;AACvC,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,iBAAiB,GAAG,SACK,CAAC;AAC3E,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB,GAAI,WAAW,iBAAiB,KAAG,MACO,CAAC;AAC7E,KAAK,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAChD,yHAAyH;AACzH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAe/C;AACD,qGAAqG;AACrG,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAAyD,CAAC;AACrG,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAwDxE"}
1
+ {"version":3,"file":"operation-help.d.ts","sourceRoot":"","sources":["../src/operation-help.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAgB7D,+FAA+F;AAC/F,eAAO,MAAM,YAAY,aAAa,CAAC;AACvC,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,iBAAiB,GAAG,SACsC,CAAC;AAC5G,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB,GAAI,WAAW,iBAAiB,KAAG,MACG,CAAC;AACzE,KAAK,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAChD,yHAAyH;AACzH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAe/C;AACD,qGAAqG;AACrG,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAAyD,CAAC;AACrG,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAwDxE"}
@@ -6,11 +6,22 @@
6
6
  import { MACHINE_PROTOCOL } from '@inventarch/runtime';
7
7
  import { atom, document, entry, fieldRows, MAX_WIDTH, sectionLabel, words } from './render.js';
8
8
  const PLAIN = { color: false, ascii: true, width: MAX_WIDTH };
9
+ /**
10
+ * Plan amendment A2: the machine routes are the version 1 operations, described at version 1 as 1.1.0 described them.
11
+ * An operation a later version adds (`since`) is the Door's and the MCP door's, and a consumer verb here, so it has no
12
+ * route, help or schema on this one.
13
+ */
14
+ const ROUTE_VERSION = 1;
15
+ /**
16
+ * The protocol version that describes `operation`: version 1 for a route, and for a row a later version adds, which the
17
+ * published renderers below may also be handed, that row's own `since`.
18
+ */
19
+ const versionOf = (operation) => operation.since ?? ROUTE_VERSION;
9
20
  /** spec-0012 CLI-05: asks for the operation's description as JSON rather than as help text. */
10
21
  export const SCHEMA_TOKEN = '--schema';
11
- export const describeOperation = (name) => MACHINE_PROTOCOL.operations.find((operation) => operation.name === name);
22
+ export const describeOperation = (name) => MACHINE_PROTOCOL.operations.find((operation) => operation.since === undefined && operation.name === name);
12
23
  /** CLI-05: one JSON line, the same object the MCP door's input schema is derived from. */
13
- export const renderOperationSchema = (operation) => JSON.stringify({ version: MACHINE_PROTOCOL.version, ...operation }) + '\n';
24
+ export const renderOperationSchema = (operation) => JSON.stringify({ version: versionOf(operation), ...operation }) + '\n';
14
25
  /** A JSON Schema fragment spelled for a reader: `string`, `array of string`, `integer 0-8`, `one of a | b`, `{a, b}`. */
15
26
  export function typeText(schema) {
16
27
  if (Array.isArray(schema['enum']))
@@ -68,7 +79,7 @@ export function renderOperationHelp(operation) {
68
79
  ...entry([[atom(`ia ${operation.name} --root <workspace> --params '${JSON.stringify(operation.example)}'`, null, 0)]], { depth: 1 }, PLAIN),
69
80
  ],
70
81
  entry([
71
- words(`Machine protocol v${MACHINE_PROTOCOL.version}: JSON in, one JSON line out, no color. ${operation.mcp === null ? 'The MCP door does not serve it.' : `MCP tool: ${operation.mcp}.`}`),
82
+ words(`Machine protocol v${versionOf(operation)}: JSON in, one JSON line out, no color. ${operation.mcp === null ? 'The MCP door does not serve it.' : `MCP tool: ${operation.mcp}.`}`),
72
83
  ], { depth: 0 }, PLAIN),
73
84
  ]);
74
85
  }
@@ -1 +1 @@
1
- {"version":3,"file":"operation-help.js","sourceRoot":"","sources":["../src/operation-help.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"operation-help.js","sourceRoot":"","sources":["../src/operation-help.ts"],"names":[],"mappings":"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"}
package/dist/pack.d.ts CHANGED
@@ -12,6 +12,8 @@ export interface PackView {
12
12
  export declare const expandedBytes: (packed: PackedArchive) => number;
13
13
  export declare function packEnvelope(view: PackView): unknown;
14
14
  export declare function renderPack(view: PackView, caps: Capabilities): string;
15
- export declare function collectPack(root: string, cwd: string, descriptorPath: string, out: string | undefined, force: boolean): PackView;
15
+ export declare function collectPack(root: string, cwd: string, descriptorPath: string, out: string | undefined, force: boolean,
16
+ /** The command that overwrites, named by the existing-archive refusal; by default this pack in this root again. */
17
+ overwrite?: string): PackView;
16
18
  export declare function runPack(context: Context): Result;
17
19
  //# sourceMappingURL=pack.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../src/pack.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,eAAO,MAAM,WAAW,kBAAkB,CAAC;AAC3C,uGAAuG;AACvG,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED,eAAO,MAAM,aAAa,GAAI,QAAQ,aAAa,KAAG,MACgB,CAAC;AAEvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEpD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CA4DrE;AAYD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,KAAK,EAAE,OAAO,GACb,QAAQ,CA0BV;AAkBD,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAQhD"}
1
+ {"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../src/pack.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,eAAO,MAAM,WAAW,kBAAkB,CAAC;AAC3C,uGAAuG;AACvG,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED,eAAO,MAAM,aAAa,GAAI,QAAQ,aAAa,KAAG,MACgB,CAAC;AAEvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEpD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CA4DrE;AAYD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,KAAK,EAAE,OAAO;AACd,mHAAmH;AACnH,SAAS,GAAE,MAA0C,GACpD,QAAQ,CA0BV;AAmDD,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAgChD"}
package/dist/pack.js CHANGED
@@ -8,14 +8,18 @@
8
8
  * The digests are the integrity output: they are what a consumer checks an acquired artifact against. The archive
9
9
  * name is its own digest, so re-packing unchanged sources on the same zlib build targets a path that already exists — refused by
10
10
  * default with a next action naming --force, exactly as §2.4 refuses a compiled artifact.
11
+ *
12
+ * A release descriptor may name no `@distribution` (plan amendment B7): a default `ia init` authors none, because an
13
+ * application repository releases nothing. Such a descriptor has nothing to pack, so it is refused before the packer
14
+ * reads anything else, naming the word's schema.
11
15
  */
12
16
  import { mkdirSync, mkdtempSync, rmSync } from 'node:fs';
13
17
  import { isAbsolute, resolve } from 'node:path';
14
- import { DISTRIBUTION_LIMITS } from '@inventarch/db/distribution';
15
- import { packToDirectory, readWorkspaceFile, replace } from '@inventarch/distribution/services';
16
- import { Refusal, requireRoot } from './consumer.js';
18
+ import { decodeReleaseDescriptor, DISTRIBUTION_LIMITS } from '@inventarch/db/distribution';
19
+ import { packToDirectory, readWorkspaceFile, readWorkspaceJson, replace } from '@inventarch/distribution/services';
20
+ import { Refusal, requireRoot, respell } from './consumer.js';
17
21
  import { codeOf } from './session.js';
18
- import { atom, document, entry, fieldRows, headerLine, sectionLabel, truncateDigest, words } from './render.js';
22
+ import { atom, document, entry, fieldRows, headerLine, quote, sectionLabel, truncateDigest, words } from './render.js';
19
23
  export const DEFAULT_OUT = '.ia/work/dist';
20
24
  /** §2.7: the rendered form lists the first 20 members and names the rest rather than printing them. */
21
25
  export const LISTED_MEMBERS = 20;
@@ -69,7 +73,9 @@ const destination = (root, cwd, supplied) => {
69
73
  }
70
74
  return isAbsolute(supplied) ? resolve(supplied) : resolve(cwd, supplied);
71
75
  };
72
- export function collectPack(root, cwd, descriptorPath, out, force) {
76
+ export function collectPack(root, cwd, descriptorPath, out, force,
77
+ /** The command that overwrites, named by the existing-archive refusal; by default this pack in this root again. */
78
+ overwrite = forced(descriptorPath, out, root)) {
73
79
  // outputRoot is a thunk: a pack that refuses never selects or creates a destination for an archive that does
74
80
  // not exist. With --force the archive lands in a private directory first, because the packer's own publish
75
81
  // step refuses an existing entry and carries no bytes back for a second attempt.
@@ -79,7 +85,7 @@ export function collectPack(root, cwd, descriptorPath, out, force) {
79
85
  return selected;
80
86
  };
81
87
  if (!force) {
82
- const packed = attempt(() => packToDirectory({ sourceRoot: root, descriptorPath, outputRoot: select }));
88
+ const packed = attempt(() => packToDirectory({ sourceRoot: root, descriptorPath, outputRoot: select }), overwrite);
83
89
  return { root, out: select(), packed };
84
90
  }
85
91
  let staging;
@@ -88,7 +94,7 @@ export function collectPack(root, cwd, descriptorPath, out, force) {
88
94
  return staging;
89
95
  };
90
96
  try {
91
- const packed = attempt(() => packToDirectory({ sourceRoot: root, descriptorPath, outputRoot: stage }));
97
+ const packed = attempt(() => packToDirectory({ sourceRoot: root, descriptorPath, outputRoot: stage }), overwrite);
92
98
  const content = readWorkspaceFile({ root: staging, path: packed.path, limit: DISTRIBUTION_LIMITS.compressed });
93
99
  replace(select(), packed.path, content);
94
100
  return { root, out: select(), packed };
@@ -98,21 +104,60 @@ export function collectPack(root, cwd, descriptorPath, out, force) {
98
104
  rmSync(staging, { recursive: true, force: true });
99
105
  }
100
106
  }
107
+ /**
108
+ * Plan amendment B7: a release descriptor, as db decodes it, that names no `distribution` has nothing to release. A file
109
+ * that cannot be read or is no release descriptor is left to the packer, whose own refusal names it, so only this one
110
+ * case is the CLI's to classify. Decoding is pure, so the refusal still comes before the packer reads anything else.
111
+ */
112
+ function requireDistribution(root, descriptor) {
113
+ let decoded;
114
+ try {
115
+ decoded = decodeReleaseDescriptor(readWorkspaceJson({ root, path: descriptor }));
116
+ }
117
+ catch {
118
+ return;
119
+ }
120
+ if (decoded.distribution !== undefined)
121
+ return;
122
+ throw new Refusal('IA-CLI-CONFLICT', `The release descriptor ${descriptor} names no distribution, so this workspace has nothing to pack`, 3, { path: descriptor }, 'Run "ia vocabulary distribution" for the record a release needs: a @distribution in a system folder whose identity the descriptor names as distribution.');
123
+ }
101
124
  /** The existing-archive refusal is the service's own code; only the next action naming --force is the CLI's. */
102
- function attempt(run) {
125
+ function attempt(run, overwrite) {
103
126
  try {
104
127
  return run();
105
128
  }
106
129
  catch (error) {
107
130
  if (codeOf(error, '') !== 'IA-DIST-LOCAL-MODIFICATION')
108
131
  throw error;
109
- throw new Refusal('IA-DIST-LOCAL-MODIFICATION', 'An archive with this content digest is already in the output directory', 3, null, 'Pass --force to overwrite it, or pack into another --out directory.');
132
+ throw new Refusal('IA-DIST-LOCAL-MODIFICATION', 'An archive with this content digest is already in the output directory', 3, null, `Run "${overwrite}" to overwrite it.`);
110
133
  }
111
134
  }
135
+ /** The refused pack again with `--force`, so the one flag the remedy needs is named in a runnable command. */
136
+ function forced(descriptor, out, root) {
137
+ return [
138
+ 'ia pack --descriptor',
139
+ quote(descriptor),
140
+ ...(out === undefined ? [] : ['--out', quote(out)]),
141
+ '--force',
142
+ ...(root === undefined ? [] : ['--root', quote(root)]),
143
+ ].join(' ');
144
+ }
112
145
  export function runPack(context) {
113
146
  const { args, caps, json } = context;
114
- const root = requireRoot(context);
115
- const view = collectPack(root, context.host.cwd, args.value('descriptor'), args.value('out'), args.flag('force'));
147
+ const root = requireRoot(context), descriptor = args.value('descriptor');
148
+ requireDistribution(root, descriptor);
149
+ let view;
150
+ try {
151
+ view = collectPack(root, context.host.cwd, descriptor, args.value('out'), args.flag('force'), forced(descriptor, args.value('out'), args.value('root')));
152
+ }
153
+ catch (error) {
154
+ // A descriptor that is not there names the pack with the one value to correct; the code and message are the
155
+ // service's (§4.1), and `ia doctor`, which reads no descriptor, would be no remedy.
156
+ const message = error instanceof Error ? error.message : String(error);
157
+ if (codeOf(error, '') !== 'IA-DIST-INPUT-INVALID' || !message.endsWith(`Missing input ${descriptor}`))
158
+ throw error;
159
+ throw new Refusal('IA-DIST-INPUT-INVALID', message, 3, null, `Run "${respell(context, { options: { descriptor: ['<file>'] } })}" naming an existing descriptor.`);
160
+ }
116
161
  // §2.7: packing has no "ran correctly, bad result" state, so this verb never returns 1.
117
162
  return json
118
163
  ? { exitCode: 0, stdout: JSON.stringify(packEnvelope(view)) + '\n', stderr: '' }
package/dist/pack.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"pack.js","sourceRoot":"","sources":["../src/pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAGhG,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEhH,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;AAC3C,uGAAuG;AACvG,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAQjC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAqB,EAAU,EAAE,CAC7D,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AAEvE,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAc,EAAE,IAAkB;IAC3D,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EACrB,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,QAAQ,CACb;QACE,UAAU,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC;QAC9G,KAAK,CACH;YACE,KAAK,CACH,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,aAAa,CAAC,MAAM,CAAC,kBAAkB,CACzG;SACF,EACD,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAC/B,IAAI,CACL;QACD;YACE,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC;YAC/B,GAAG,SAAS,CACV;gBACE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,UAAU,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;gBACpG;oBACE,KAAK,EAAE,UAAU;oBACjB,KAAK,EAAE,CAAC,IAAI,CAAC,UAAU,cAAc,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;iBACtF;gBACD;oBACE,KAAK,EAAE,QAAQ;oBACf,KAAK,EAAE,CAAC,IAAI,CAAC,UAAU,cAAc,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;iBACzF;gBACD,sGAAsG;gBACtG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;aACzD,EACD,EAAE,KAAK,EAAE,CAAC,EAAE,EACZ,IAAI,CACL;SACF;QACD;YACE,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC;YAC7B,GAAG,OAAO;iBACP,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC;iBACxB,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;YAC1F,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,cAAc;gBACjC,CAAC,CAAC,KAAK,CACH,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,OAAO,CAAC,MAAM,GAAG,cAAc,OAAO,EAAE,KAAK,CAAC,CAAC,EACzF,EAAE,KAAK,EAAE,CAAC,EAAE,EACZ,IAAI,CACL;gBACH,CAAC,CAAC,EAAE,CAAC;SACR;QACD,KAAK,CACH;YACE,KAAK,CACH,8GAA8G,CAC/G;SACF,EACD,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAC5B,IAAI,CACL;KACF,EACD,EAAE,YAAY,EAAE,IAAI,EAAE,CACvB,CAAC;AACJ,CAAC;AAED,0GAA0G;AAC1G,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,GAAW,EAAE,QAA4B,EAAU,EAAE;IACtF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACxC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC3E,CAAC,CAAC;AAEF,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,GAAW,EACX,cAAsB,EACtB,GAAuB,EACvB,KAAc;IAEd,6GAA6G;IAC7G,2GAA2G;IAC3G,iFAAiF;IACjF,IAAI,QAA4B,CAAC;IACjC,MAAM,MAAM,GAAG,GAAW,EAAE;QAC1B,QAAQ,KAAK,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACzC,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IACF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACxG,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC;IACD,IAAI,OAA2B,CAAC;IAChC,MAAM,KAAK,GAAG,GAAW,EAAE;QACzB,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACvG,MAAM,OAAO,GAAG,iBAAiB,CAAC,EAAE,IAAI,EAAE,OAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,mBAAmB,CAAC,UAAU,EAAE,CAAC,CAAC;QAChH,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC;IACzC,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED,gHAAgH;AAChH,SAAS,OAAO,CAAC,GAAwB;IACvC,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,4BAA4B;YAAE,MAAM,KAAK,CAAC;QACpE,MAAM,IAAI,OAAO,CACf,4BAA4B,EAC5B,wEAAwE,EACxE,CAAC,EACD,IAAI,EACJ,qEAAqE,CACtE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAgB;IACtC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACrC,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAE,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACnH,wFAAwF;IACxF,OAAO,IAAI;QACT,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QAChF,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAClE,CAAC"}
1
+ {"version":3,"file":"pack.js","sourceRoot":"","sources":["../src/pack.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import type { PositionOutput } from '@inventarch/runtime';
2
+ import type { Context, Result } from './consumer.js';
3
+ import type { Capabilities } from './render.js';
4
+ export declare function positionEnvelope(output: PositionOutput): unknown;
5
+ /**
6
+ * The key used and the capture's freshness; the loaded records, the pointers and their tallies; the rules and playbooks
7
+ * that apply by word, with their tallies, and the playbook cells; the rules reserved outside the budget; the mandates;
8
+ * the frontier; the unknowns; then the two widening keys as `ia position` commands, with the root this invocation gave:
9
+ * one hop deeper (absent at depth 2), and the re-seat at any pointer or applies-by-word entry. Every string of the
10
+ * output, what a source authored (cell text, a finding's message, identities and paths) included, is escaped by
11
+ * `terminalSafe` before it is laid out, so no terminal control reaches the terminal; `--json` prints the output as is.
12
+ */
13
+ export declare function renderPosition(output: PositionOutput, caps: Capabilities, rooted?: string): string;
14
+ /**
15
+ * §4.1: the runtime's refusal with its code and message unchanged. The key's form (its closed sets and caps) is
16
+ * checked before the workspace is read, so its refusal reads nothing and is usage, exit 2; a word or seat the workspace
17
+ * does not answer is exit 1, as `ia inspect` refuses an identity it does not admit, located at the workspace with a
18
+ * seat identity as its identity.
19
+ */
20
+ export declare function positionRefusal(error: unknown, context: Pick<Context, 'command' | 'args'>, root: string | undefined): unknown;
21
+ export declare function runPosition(context: Context): Result;
22
+ //# sourceMappingURL=position.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../src/position.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAGV,cAAc,EAIf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAS,MAAM,aAAa,CAAC;AAevD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAEhE;AAyHD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,SAAK,GAAG,MAAM,CAmF9F;AA4BD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAAC,EAC1C,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAaT;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAuBpD"}