@inventarch/cli 3.1.0 → 3.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +221 -23
- package/SPEC.md +20 -20
- package/assets/base/df626d1dc4949649ba7203842b29b4f064e0552e8db8c2c41ff74b6462b81b75.ia.tgz +0 -0
- package/assets/base.json +3 -3
- package/assets/host/f91ffe4c2071b196e925e93507bd661b3e09f5dc75392f7d6453fdbec5e28d62.tgz +0 -0
- package/assets/host.json +3 -3
- package/assets/vocabulary.json +1 -1
- package/dist/author.d.ts.map +1 -1
- package/dist/author.js +6 -7
- package/dist/author.js.map +1 -1
- package/dist/briefing.d.ts +2 -2
- package/dist/briefing.d.ts.map +1 -1
- package/dist/capture.d.ts +2 -2
- package/dist/capture.js +7 -7
- package/dist/commands.d.ts +7 -7
- package/dist/commands.d.ts.map +1 -1
- package/dist/commands.js +26 -28
- package/dist/commands.js.map +1 -1
- package/dist/consumer.d.ts +24 -24
- package/dist/consumer.js +33 -33
- package/dist/consumer.js.map +1 -1
- package/dist/decline.js +1 -1
- package/dist/distribute.d.ts +13 -14
- package/dist/distribute.d.ts.map +1 -1
- package/dist/distribute.js +17 -17
- package/dist/distribute.js.map +1 -1
- package/dist/doctor-user.d.ts +1 -1
- package/dist/doctor-user.d.ts.map +1 -1
- package/dist/doctor-user.js +2 -2
- package/dist/doctor-user.js.map +1 -1
- package/dist/doctor.d.ts +1 -1
- package/dist/doctor.d.ts.map +1 -1
- package/dist/doctor.js +53 -54
- package/dist/doctor.js.map +1 -1
- package/dist/format.js +3 -3
- package/dist/format.js.map +1 -1
- package/dist/home-remedy.d.ts +1 -1
- package/dist/home-remedy.js +1 -1
- package/dist/host-projection.d.ts +38 -38
- package/dist/host-projection.d.ts.map +1 -1
- package/dist/host-projection.js +69 -70
- package/dist/host-projection.js.map +1 -1
- package/dist/host.d.ts +37 -38
- package/dist/host.d.ts.map +1 -1
- package/dist/host.js +54 -57
- package/dist/host.js.map +1 -1
- package/dist/init.d.ts +60 -56
- package/dist/init.d.ts.map +1 -1
- package/dist/init.js +98 -99
- package/dist/init.js.map +1 -1
- package/dist/main.js +4 -4
- package/dist/main.js.map +1 -1
- package/dist/next.js +15 -15
- package/dist/next.js.map +1 -1
- package/dist/operation-help.d.ts +3 -3
- package/dist/operation-help.d.ts.map +1 -1
- package/dist/operation-help.js +9 -9
- package/dist/operation-help.js.map +1 -1
- package/dist/pack.js +6 -6
- package/dist/position.d.ts.map +1 -1
- package/dist/position.js +10 -11
- package/dist/position.js.map +1 -1
- package/dist/preview.d.ts +4 -4
- package/dist/preview.d.ts.map +1 -1
- package/dist/preview.js +27 -28
- package/dist/preview.js.map +1 -1
- package/dist/profile.d.ts +23 -23
- package/dist/profile.d.ts.map +1 -1
- package/dist/profile.js +50 -51
- package/dist/profile.js.map +1 -1
- package/dist/project.d.ts +7 -8
- package/dist/project.d.ts.map +1 -1
- package/dist/project.js +24 -27
- package/dist/project.js.map +1 -1
- package/dist/read.d.ts +1 -1
- package/dist/read.d.ts.map +1 -1
- package/dist/read.js +4 -4
- package/dist/read.js.map +1 -1
- package/dist/render.d.ts +3 -3
- package/dist/render.js +3 -3
- package/dist/session.d.ts +9 -9
- package/dist/session.d.ts.map +1 -1
- package/dist/session.js +10 -10
- package/dist/session.js.map +1 -1
- package/dist/validate.d.ts +8 -8
- package/dist/validate.d.ts.map +1 -1
- package/dist/validate.js +34 -37
- package/dist/validate.js.map +1 -1
- package/dist/vocabulary.js +2 -2
- package/dist/vocabulary.js.map +1 -1
- package/package.json +6 -6
- package/assets/base/7db20e0dbbc2b88701ea24991886b4a8e08d419dda469cce5caff66911f81e4c.ia.tgz +0 -0
- package/assets/host/7e80bd7098018c1c13e3fae4cd363acfeffedccd5b6ec06c4952b62f449a4246.tgz +0 -0
package/dist/host.d.ts
CHANGED
|
@@ -5,7 +5,7 @@ import type { Context, Result } from './consumer.js';
|
|
|
5
5
|
import { Refusal } from './consumer.js';
|
|
6
6
|
import type { HookCache, HostName } from './host-projection.js';
|
|
7
7
|
import type { Capabilities } from './render.js';
|
|
8
|
-
/** §5.1's elements. `ia host` registers no steward guard
|
|
8
|
+
/** §5.1's elements. `ia host` registers no steward guard any more, so none is `hooks`. */
|
|
9
9
|
export type ElementId = 'mcp' | 'context' | 'projection';
|
|
10
10
|
/**
|
|
11
11
|
* §5.4's four capabilities, plus `absent` for a removal row whose element this workspace does not own: claiming
|
|
@@ -32,13 +32,13 @@ export interface Element {
|
|
|
32
32
|
readonly capability: Capability;
|
|
33
33
|
readonly conflict: Conflict | null;
|
|
34
34
|
/**
|
|
35
|
-
* The projection's per-file actions
|
|
35
|
+
* The projection's per-file actions. `remove` includes each 1.x steward file the state owns; `foreign` is a
|
|
36
36
|
* `.claude/agents/*.md` file it does not own, marked or not: listed and never touched, so it is not a conflict.
|
|
37
37
|
*/
|
|
38
38
|
readonly files?: readonly ProjectionAction[];
|
|
39
|
-
/** The projection's
|
|
39
|
+
/** The projection's guard retirement: `retire` when the apply first removes a steward-guard registration it owns. */
|
|
40
40
|
readonly guard?: 'retire' | 'none';
|
|
41
|
-
/** The projection's hook groups (claude): what the apply does to each authored `@hook`'s group
|
|
41
|
+
/** The projection's hook groups (claude): what the apply does to each authored `@hook`'s group. */
|
|
42
42
|
readonly hooks?: readonly HookAction[];
|
|
43
43
|
/** The authored records the host does not take, each with the reason (an unregistered hook included). */
|
|
44
44
|
readonly unsupported?: readonly UnsupportedRow[];
|
|
@@ -64,7 +64,7 @@ export interface HostView {
|
|
|
64
64
|
readonly userPlugin: UserPlugin | null;
|
|
65
65
|
/**
|
|
66
66
|
* The projection rendering this plan made, on the session an apply's mandate gate judged; null for a removal. The apply
|
|
67
|
-
* writes exactly it, so the profile and the files written read one snapshot
|
|
67
|
+
* writes exactly it, so the profile and the files written read one snapshot.
|
|
68
68
|
*/
|
|
69
69
|
readonly rendered: HostOutput | null;
|
|
70
70
|
}
|
|
@@ -80,8 +80,8 @@ export declare const MACHINE_LOCAL: Readonly<Record<HostName, string>>;
|
|
|
80
80
|
/** §5.4: the MCP element's one fixed addition, from §2.3's host facts. */
|
|
81
81
|
export declare const MCP_APPROVAL = "Claude Code asks for approval before starting a project MCP server.";
|
|
82
82
|
/**
|
|
83
|
-
*
|
|
84
|
-
*
|
|
83
|
+
* From 2026-10-08 this says where the guard used to be registered, as from 2026-09-23 it said what the guard refused:
|
|
84
|
+
* the guard is retired, so nothing it refused is refused now.
|
|
85
85
|
*/
|
|
86
86
|
export declare const GUARD_SCOPE = "ia host registers one guard group per authored @hook, which refuses an edit its paths and tools select unless the acting agent holds a governing @mandate granting Synthesis there; it registers no per-system steward guard, and applying the projection retires one an earlier release registered.";
|
|
87
87
|
/** §5.1's files, exported once so `ia doctor` names the same ones. */
|
|
@@ -90,8 +90,8 @@ export declare const SETTINGS = ".claude/settings.local.json";
|
|
|
90
90
|
export declare const HOSTS_AREA = ".ia/distributions/hosts";
|
|
91
91
|
/**
|
|
92
92
|
* §5.1's state files. Their presence says whether this workspace owns an element; their content is the mechanisms'.
|
|
93
|
-
* `hooks` is a steward-guard registration an earlier release made, which the projection apply retires
|
|
94
|
-
*
|
|
93
|
+
* `hooks` is a steward-guard registration an earlier release made, which the projection apply retires, and `receipt`
|
|
94
|
+
* the receipt it writes beside the projection state.
|
|
95
95
|
*/
|
|
96
96
|
export declare const STATE: {
|
|
97
97
|
readonly mcp: (host: HostName) => string;
|
|
@@ -117,9 +117,9 @@ export declare const JOURNALS: readonly (readonly [string, string])[];
|
|
|
117
117
|
/** §8: the lock every host sub-transaction holds while it writes (`acquireHostRegistrationLock`). */
|
|
118
118
|
export declare const HOST_LOCK = ".ia/distributions/hosts/lock.json";
|
|
119
119
|
/**
|
|
120
|
-
* The close of a remedy whose follow-up is the refused command itself, run again as typed, so the recovery before it
|
|
121
|
-
*
|
|
122
|
-
*
|
|
120
|
+
* The close of a remedy whose follow-up is the refused command itself, run again as typed, so the recovery before it is
|
|
121
|
+
* the one command named. `ia init --host` cannot simply be run again once it has initialized, so it names `ia host`
|
|
122
|
+
* instead of such a remedy.
|
|
123
123
|
*/
|
|
124
124
|
export declare const THEN_RERUN = ", then rerun.";
|
|
125
125
|
/** An installed CLI recovery, delegating the named distribution mechanism with an explicit root. */
|
|
@@ -157,7 +157,7 @@ export declare function pinnedRelease(packageRoot: string): Pinned;
|
|
|
157
157
|
export declare function requireInitialized(root: string, named?: string): void;
|
|
158
158
|
/** The journal a failed transaction left behind, if any, with the command that recovers it. */
|
|
159
159
|
export declare const pendingJournal: (root: string) => readonly [string, string] | undefined;
|
|
160
|
-
/**
|
|
160
|
+
/** The recovery is the one command named; the refused command is simply run again after it. */
|
|
161
161
|
export declare const recoverNext: (root: string, command: string) => string;
|
|
162
162
|
/**
|
|
163
163
|
* A next action of this verb made runnable from any cwd: every quoted `ia host <host>` or `ia project <host>` command
|
|
@@ -173,15 +173,14 @@ export declare const hostNext: (text: string, host: HostName, root: string, root
|
|
|
173
173
|
export declare const refusedPath: (error: unknown) => string | null;
|
|
174
174
|
/**
|
|
175
175
|
* §6.3: the repair for a projection refusal with `code` located at `path`. The ownership state has its own repair; a
|
|
176
|
-
* guard group the retirement
|
|
177
|
-
*
|
|
178
|
-
*
|
|
176
|
+
* guard group the retirement refuses as changed is deleted by hand, after which the retirement removes the ownership
|
|
177
|
+
* state alone, and settings it cannot read are fixed; any other file is never replaced or adopted, so it is moved or
|
|
178
|
+
* deleted first. `ia host`, `ia doctor` and the install refresh all name it this way.
|
|
179
179
|
*/
|
|
180
180
|
export declare const projectionRepair: (host: HostName, path: string, rerun: string, code?: string) => string;
|
|
181
181
|
/**
|
|
182
|
-
* What a hook-registration refusal carries so it can name its own recovery
|
|
183
|
-
*
|
|
184
|
-
* needs and cannot use.
|
|
182
|
+
* What a hook-registration refusal carries so it can name its own recovery: an owned group deleted (`missing`), or
|
|
183
|
+
* changed or duplicated (`modified`), by hand, or a recorded host payload a change of hooks needs and cannot use.
|
|
185
184
|
*/
|
|
186
185
|
export type HookRefusal = {
|
|
187
186
|
readonly drift: 'missing' | 'modified';
|
|
@@ -193,7 +192,7 @@ export type HookRefusal = {
|
|
|
193
192
|
} | {
|
|
194
193
|
readonly payload: string;
|
|
195
194
|
};
|
|
196
|
-
/** The populated skill folder a projection refusal names (distribution's `skillFolder
|
|
195
|
+
/** The populated skill folder a projection refusal names (distribution's `skillFolder`), if any. */
|
|
197
196
|
export declare const skillFolderOf: (error: unknown) => string | undefined;
|
|
198
197
|
/** The repair for a generated skill refused at a folder that holds the user's files: those files go, or the name changes. */
|
|
199
198
|
export declare const folderRepair: (folder: string, rerun: string) => string;
|
|
@@ -214,24 +213,24 @@ export declare function projectionFailure(error: unknown, root: string, host: Ho
|
|
|
214
213
|
*/
|
|
215
214
|
export declare const projectedHosts: (root: string) => readonly HostName[];
|
|
216
215
|
/**
|
|
217
|
-
* The apply that repairs `host`'s projection, which `ia doctor` and the install refresh both name
|
|
218
|
-
*
|
|
219
|
-
*
|
|
216
|
+
* The apply that repairs `host`'s projection, which `ia doctor` and the install refresh both name:
|
|
217
|
+
* `ia host <host> --apply` for a registered host, and `ia project <host> --apply` for a projection `ia project` wrote
|
|
218
|
+
* without a registration, which `ia host` would also register an MCP server for.
|
|
220
219
|
*/
|
|
221
220
|
export declare const projectionRerun: (root: string, host: HostName) => string;
|
|
222
221
|
/** §8: a pending journal refuses the whole verb and names the recovery that clears it. `ia project` shares it. */
|
|
223
222
|
export declare function requireIdle(root: string, supplied: string): void;
|
|
224
223
|
/**
|
|
225
|
-
* §5.1 `projection`, planned by the real planners:
|
|
226
|
-
*
|
|
227
|
-
*
|
|
228
|
-
*
|
|
229
|
-
*
|
|
224
|
+
* §5.1 `projection`, planned by the real planners: the retirement of an owned guard registration, then the file plan.
|
|
225
|
+
* Both read only the workspace, so the plan is exactly apply's. A retirement is a change, and so is a missing receipt,
|
|
226
|
+
* which every apply writes, so a projection whose files are unchanged is then an update; a removal that finds only a
|
|
227
|
+
* guard registration or a receipt removes them. `ia project` plans with it, and both verbs' applies re-plan with it
|
|
228
|
+
* (`replanProjection`), so no two of them can plan the projection differently.
|
|
230
229
|
*/
|
|
231
230
|
export declare function projectionElement(root: string, host: HostName, rendered: HostOutput | null, cache?: HookCache): Element;
|
|
232
231
|
/** §4's plan. It reads the workspace and the package's pin and writes nothing, the payload included. */
|
|
233
232
|
export declare function collectHost(context: Context): HostView;
|
|
234
|
-
/** One applied element; the projection's also says whether it retired a steward-guard registration first
|
|
233
|
+
/** One applied element; the projection's also says whether it retired a steward-guard registration first. */
|
|
235
234
|
export interface AppliedElement {
|
|
236
235
|
readonly id: ElementId;
|
|
237
236
|
readonly status: string;
|
|
@@ -242,7 +241,7 @@ export interface HostApplied {
|
|
|
242
241
|
readonly elements: readonly AppliedElement[];
|
|
243
242
|
readonly observed: false;
|
|
244
243
|
}
|
|
245
|
-
/** What an apply that retired the steward guard
|
|
244
|
+
/** What an apply that retired the steward guard says it did. */
|
|
246
245
|
export declare const GUARD_RETIRED = "Retired the steward guard an earlier release registered: its group in .claude/settings.local.json and its ownership state are removed.";
|
|
247
246
|
/**
|
|
248
247
|
* Apply's re-plan of the projection, shared by `ia host --apply` and `ia project --apply`: the projection element
|
|
@@ -253,34 +252,34 @@ export declare const GUARD_RETIRED = "Retired the steward guard an earlier relea
|
|
|
253
252
|
export declare function replanProjection(root: string, host: HostName, rendered: HostOutput | null, refuse: (conflict: Conflict) => Refusal, cache?: HookCache): void;
|
|
254
253
|
/**
|
|
255
254
|
* §8: mcp, projection in order; removal in reverse. The payload is materialized, then every sub-transaction is
|
|
256
|
-
* re-planned with the verifying planners before any is applied — the projection's guard retirement
|
|
255
|
+
* re-planned with the verifying planners before any is applied — the projection's guard retirement and file plan
|
|
257
256
|
* included — so a refusal any planner can find is raised before the workspace changes; each apply then re-plans under
|
|
258
257
|
* the host lock and refuses a plan that went stale. The projection is applied through `applyHostProjection`, the one
|
|
259
|
-
* writer of projection files, which retires an owned steward guard before any projection file changes and reports it
|
|
260
|
-
*
|
|
258
|
+
* writer of projection files, which retires an owned steward guard before any projection file changes and reports it as
|
|
259
|
+
* the element's `guard`. Cancellation is observed between sub-transactions. A failure after an element was written
|
|
261
260
|
* names the rerun that finishes the set, or the recovery a pending journal needs. `checkpoint` runs after each element
|
|
262
261
|
* completes, which is where an interruption test cuts.
|
|
263
262
|
*/
|
|
264
263
|
export declare function applyHostSet(view: HostView, packageRoot: string, signal?: AbortSignal, checkpoint?: (id: ElementId) => void): HostApplied;
|
|
265
264
|
/**
|
|
266
|
-
* A conflict as the `--json` envelopes print it
|
|
267
|
-
*
|
|
265
|
+
* A conflict as the `--json` envelopes print it: its code, path and reason. The descriptors a refusal carries to word
|
|
266
|
+
* its own repair (`hook`, `folder`) stay internal; the repair is the refusal's `next`.
|
|
268
267
|
*/
|
|
269
268
|
export declare const printedConflict: (conflict: Conflict | null) => Conflict | null;
|
|
270
|
-
/** A projection plan's
|
|
269
|
+
/** A projection plan's guard retirement as its plan says it, in `ia host` and `ia project` alike. */
|
|
271
270
|
export declare const GUARD_RETIRE = "first retires the steward guard registered in .claude/settings.local.json";
|
|
272
271
|
/**
|
|
273
272
|
* Each projected file with its action, at `column`; a foreign steward file says why it is left alone. `ia host` nests
|
|
274
273
|
* the rows under its projection element and `ia project` lists them as its file plan, so both word them alike.
|
|
275
274
|
*/
|
|
276
275
|
export declare const projectionFileRows: (files: readonly ProjectionAction[], column: number, caps: Capabilities) => readonly string[];
|
|
277
|
-
/** Each authored `@hook`'s group with its action
|
|
276
|
+
/** Each authored `@hook`'s group with its action, worded alike by `ia host` and `ia project`. */
|
|
278
277
|
export declare const projectionHookRows: (hooks: readonly HookAction[], column: number, caps: Capabilities) => readonly string[];
|
|
279
278
|
/** Each authored record the host does not take, with the reason, worded alike by `ia host` and `ia project`. */
|
|
280
279
|
export declare const unsupportedRows: (rows: readonly UnsupportedRow[], column: number, caps: Capabilities) => readonly string[];
|
|
281
280
|
/**
|
|
282
281
|
* §5.3's machine-local sentence and, for a Claude registration, §5.4's approval note and the guard's retirement (only
|
|
283
|
-
* Claude ever registered the guard
|
|
282
|
+
* Claude ever registered the guard). `ia init --host` prints the same blocks after its host step, so the two verbs
|
|
284
283
|
* cannot word them differently.
|
|
285
284
|
*/
|
|
286
285
|
export declare const hostNotes: (host: HostName, caps: Capabilities, remove?: boolean) => readonly (readonly string[])[];
|
package/dist/host.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"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"}
|
package/dist/host.js
CHANGED
|
@@ -4,27 +4,24 @@
|
|
|
4
4
|
* One verb owns the managed host set of §5.1: the MCP entry and the workspace projection, plus the context element
|
|
5
5
|
* §5.2's gate keeps unselected. It plans by default and never writes while planning — the payload's location is
|
|
6
6
|
* computed, not created. `--apply` materializes the embedded payload once per user (§3.3), re-plans every
|
|
7
|
-
* sub-transaction against the verified payload, then applies them in order — mcp, projection — and removal runs them
|
|
8
|
-
*
|
|
9
|
-
* recovery. Nothing here reports that a server answered or a hook ran; `applied.observed` is always false
|
|
10
|
-
* M5 exit).
|
|
7
|
+
* sub-transaction against the verified payload, then applies them in order — mcp, projection — and removal runs them in
|
|
8
|
+
* reverse (§8). No cross-file atomicity is claimed: a rerun converges, and a pending journal refuses naming its
|
|
9
|
+
* recovery. Nothing here reports that a server answered or a hook ran; `applied.observed` is always false.
|
|
11
10
|
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
* ia-project-verb: `ia project` (project.ts) plans and applies that element alone, through the same planner
|
|
11
|
+
* The projection is the position packet's consumer rendering, and `ia host` registers no steward guard. The projection
|
|
12
|
+
* element lists instead the retirement of a guard an earlier release registered, which `applyHostProjection`
|
|
13
|
+
* (host-projection.ts) performs before any projection file changes, the owned 1.x steward files it deletes and the
|
|
14
|
+
* foreign files it leaves. `ia project` (project.ts) plans and applies that element alone, through the same planner
|
|
17
15
|
* (`projectionElement`), re-plan (`replanProjection`) and writer, and its file rows (`projectionFileRows`).
|
|
18
16
|
*
|
|
19
17
|
* The plan asks the mechanisms themselves. `planHostFor` plans against the payload apply will materialize, described
|
|
20
18
|
* from the pin without reading it (`expectedHostCache`), so a conflict in the preview is the service's own refusal —
|
|
21
19
|
* its code and message unchanged (contract §4.1) — and is the refusal apply would raise.
|
|
22
20
|
*
|
|
23
|
-
*
|
|
24
|
-
*
|
|
25
|
-
*
|
|
26
|
-
*
|
|
27
|
-
* the join.
|
|
21
|
+
* The apply reads the join receipts before it writes anything, refusing ones it cannot read, and once every element is
|
|
22
|
+
* applied it records the host's join from the committed registration (`joinHost`): the installed-implementation catalog
|
|
23
|
+
* of the payload it names, at the workspace's authored revision. A removal drops it (`leaveHost`). The plan and the
|
|
24
|
+
* envelope do not change; `ia doctor` reports the join.
|
|
28
25
|
*/
|
|
29
26
|
import { createHash } from 'node:crypto';
|
|
30
27
|
import { existsSync, realpathSync, statSync } from 'node:fs';
|
|
@@ -60,8 +57,8 @@ export const MACHINE_LOCAL = {
|
|
|
60
57
|
/** §5.4: the MCP element's one fixed addition, from §2.3's host facts. */
|
|
61
58
|
export const MCP_APPROVAL = 'Claude Code asks for approval before starting a project MCP server.';
|
|
62
59
|
/**
|
|
63
|
-
*
|
|
64
|
-
*
|
|
60
|
+
* From 2026-10-08 this says where the guard used to be registered, as from 2026-09-23 it said what the guard refused:
|
|
61
|
+
* the guard is retired, so nothing it refused is refused now.
|
|
65
62
|
*/
|
|
66
63
|
export const GUARD_SCOPE = 'ia host registers one guard group per authored @hook, which refuses an edit its paths and tools select unless the acting agent holds a governing @mandate granting Synthesis there; it registers no per-system steward guard, and applying the projection retires one an earlier release registered.';
|
|
67
64
|
/** §5.1's files, exported once so `ia doctor` names the same ones. */
|
|
@@ -70,8 +67,8 @@ export const SETTINGS = '.claude/settings.local.json';
|
|
|
70
67
|
export const HOSTS_AREA = '.ia/distributions/hosts';
|
|
71
68
|
/**
|
|
72
69
|
* §5.1's state files. Their presence says whether this workspace owns an element; their content is the mechanisms'.
|
|
73
|
-
* `hooks` is a steward-guard registration an earlier release made, which the projection apply retires
|
|
74
|
-
*
|
|
70
|
+
* `hooks` is a steward-guard registration an earlier release made, which the projection apply retires, and `receipt`
|
|
71
|
+
* the receipt it writes beside the projection state.
|
|
75
72
|
*/
|
|
76
73
|
export const STATE = {
|
|
77
74
|
mcp: (host) => `${HOSTS_AREA}/${host}-${HOST_REGISTRATION}.json`,
|
|
@@ -104,7 +101,7 @@ export function stateRepair(host, path, rerun) {
|
|
|
104
101
|
return `Delete ${path} and ${OWNED_MCP[host]}, then run "${rerun}".`;
|
|
105
102
|
if (host === 'claude' && path === STATE.hooks)
|
|
106
103
|
return `Delete ${path} and ${OWNED_GUARD}, then run "${rerun}".`;
|
|
107
|
-
//
|
|
104
|
+
// The hook ownership state names the groups it owns, so both go before the rerun.
|
|
108
105
|
if (host === 'claude' && path === STATE.hookGroups)
|
|
109
106
|
return `Delete ${path} and ${OWNED_HOOKS}, then run "${rerun}".`;
|
|
110
107
|
if (path === STATE.projection(host) || path === STATE.receipt(host))
|
|
@@ -128,9 +125,9 @@ export const JOURNALS = [
|
|
|
128
125
|
/** §8: the lock every host sub-transaction holds while it writes (`acquireHostRegistrationLock`). */
|
|
129
126
|
export const HOST_LOCK = `${HOSTS_AREA}/lock.json`;
|
|
130
127
|
/**
|
|
131
|
-
* The close of a remedy whose follow-up is the refused command itself, run again as typed, so the recovery before it
|
|
132
|
-
*
|
|
133
|
-
*
|
|
128
|
+
* The close of a remedy whose follow-up is the refused command itself, run again as typed, so the recovery before it is
|
|
129
|
+
* the one command named. `ia init --host` cannot simply be run again once it has initialized, so it names `ia host`
|
|
130
|
+
* instead of such a remedy.
|
|
134
131
|
*/
|
|
135
132
|
export const THEN_RERUN = ', then rerun.';
|
|
136
133
|
/** An installed CLI recovery, delegating the named distribution mechanism with an explicit root. */
|
|
@@ -205,7 +202,7 @@ export function requireInitialized(root, named = root) {
|
|
|
205
202
|
}
|
|
206
203
|
/** The journal a failed transaction left behind, if any, with the command that recovers it. */
|
|
207
204
|
export const pendingJournal = (root) => JOURNALS.find(([path]) => existsSync(resolve(root, path)));
|
|
208
|
-
/**
|
|
205
|
+
/** The recovery is the one command named; the refused command is simply run again after it. */
|
|
209
206
|
export const recoverNext = (root, command) => `Run "${recoverCommand(command, root)}"${THEN_RERUN}`;
|
|
210
207
|
/**
|
|
211
208
|
* A next action of this verb made runnable from any cwd: every quoted `ia host <host>` or `ia project <host>` command
|
|
@@ -227,9 +224,9 @@ export const refusedPath = (error) => /^IA-/.test(codeOf(error, '')) &&
|
|
|
227
224
|
: null;
|
|
228
225
|
/**
|
|
229
226
|
* §6.3: the repair for a projection refusal with `code` located at `path`. The ownership state has its own repair; a
|
|
230
|
-
* guard group the retirement
|
|
231
|
-
*
|
|
232
|
-
*
|
|
227
|
+
* guard group the retirement refuses as changed is deleted by hand, after which the retirement removes the ownership
|
|
228
|
+
* state alone, and settings it cannot read are fixed; any other file is never replaced or adopted, so it is moved or
|
|
229
|
+
* deleted first. `ia host`, `ia doctor` and the install refresh all name it this way.
|
|
233
230
|
*/
|
|
234
231
|
export const projectionRepair = (host, path, rerun, code) => code === 'IA-CLI-FAILED'
|
|
235
232
|
? `Make ${path} writable and release any file lock, then run "${rerun}".`
|
|
@@ -239,7 +236,7 @@ export const projectionRepair = (host, path, rerun, code) => code === 'IA-CLI-FA
|
|
|
239
236
|
: code === undefined || code === 'IA-DIST-LOCAL-MODIFICATION'
|
|
240
237
|
? `Delete only the IA guard group in ${path}, then run "${rerun}".`
|
|
241
238
|
: `Fix ${path}, then run "${rerun}".`));
|
|
242
|
-
/** The populated skill folder a projection refusal names (distribution's `skillFolder
|
|
239
|
+
/** The populated skill folder a projection refusal names (distribution's `skillFolder`), if any. */
|
|
243
240
|
export const skillFolderOf = (error) => error !== null && typeof error === 'object' && 'skillFolder' in error && typeof error.skillFolder === 'string'
|
|
244
241
|
? error.skillFolder
|
|
245
242
|
: undefined;
|
|
@@ -292,9 +289,9 @@ export function projectionFailure(error, root, host, rerun) {
|
|
|
292
289
|
*/
|
|
293
290
|
export const projectedHosts = (root) => WORKSPACE_HOSTS.filter((host) => existsSync(resolve(root, STATE.projection(host))));
|
|
294
291
|
/**
|
|
295
|
-
* The apply that repairs `host`'s projection, which `ia doctor` and the install refresh both name
|
|
296
|
-
*
|
|
297
|
-
*
|
|
292
|
+
* The apply that repairs `host`'s projection, which `ia doctor` and the install refresh both name:
|
|
293
|
+
* `ia host <host> --apply` for a registered host, and `ia project <host> --apply` for a projection `ia project` wrote
|
|
294
|
+
* without a registration, which `ia host` would also register an MCP server for.
|
|
298
295
|
*/
|
|
299
296
|
export const projectionRerun = (root, host) => existsSync(resolve(root, STATE.mcp(host))) ? `ia host ${host} --apply` : `ia project ${host} --apply`;
|
|
300
297
|
/** §8: a pending journal refuses the whole verb and names the recovery that clears it. `ia project` shares it. */
|
|
@@ -356,11 +353,11 @@ const contextElement = (host) => ({
|
|
|
356
353
|
conflict: null,
|
|
357
354
|
});
|
|
358
355
|
/**
|
|
359
|
-
* §5.1 `projection`, planned by the real planners:
|
|
360
|
-
*
|
|
361
|
-
*
|
|
362
|
-
*
|
|
363
|
-
*
|
|
356
|
+
* §5.1 `projection`, planned by the real planners: the retirement of an owned guard registration, then the file plan.
|
|
357
|
+
* Both read only the workspace, so the plan is exactly apply's. A retirement is a change, and so is a missing receipt,
|
|
358
|
+
* which every apply writes, so a projection whose files are unchanged is then an update; a removal that finds only a
|
|
359
|
+
* guard registration or a receipt removes them. `ia project` plans with it, and both verbs' applies re-plan with it
|
|
360
|
+
* (`replanProjection`), so no two of them can plan the projection differently.
|
|
364
361
|
*/
|
|
365
362
|
export function projectionElement(root, host, rendered, cache = null) {
|
|
366
363
|
const refused = (conflict) => ({
|
|
@@ -452,12 +449,12 @@ export function collectHost(context) {
|
|
|
452
449
|
located(null, homeSrcRemedy(home, plan), () => assertIaHomeUsable(home));
|
|
453
450
|
const { pin: bundled } = bundledPin(host.packageRoot);
|
|
454
451
|
requireIdle(root, supplied);
|
|
455
|
-
// §4: zero error findings before anything is rendered or registered. A removal renders nothing and reads no record,
|
|
456
|
-
// it needs neither an admitting workspace nor records that open
|
|
457
|
-
//
|
|
458
|
-
//
|
|
459
|
-
//
|
|
460
|
-
//
|
|
452
|
+
// §4: zero error findings before anything is rendered or registered. A removal renders nothing and reads no record,
|
|
453
|
+
// so it needs neither an admitting workspace nor records that open: it is what restores editing when a broken record
|
|
454
|
+
// or an unreadable workspace leaves a hook group refusing the repair.
|
|
455
|
+
// A workspace apply writes the projection `ia project --apply` writes, so it is the effect mode (Execution) under the
|
|
456
|
+
// participant's mandate profile, judged on the rendering session before the confirmation; its plan writes nothing,
|
|
457
|
+
// `--remove` restores editing, and `--user` reads no workspace, so none of them is gated.
|
|
461
458
|
const rendered = remove
|
|
462
459
|
? null
|
|
463
460
|
: renderProjectionFor(root, name, args.flag('apply') ? sessionGate(context, 'effect') : undefined);
|
|
@@ -483,7 +480,7 @@ export function collectHost(context) {
|
|
|
483
480
|
rendered,
|
|
484
481
|
};
|
|
485
482
|
}
|
|
486
|
-
/** What an apply that retired the steward guard
|
|
483
|
+
/** What an apply that retired the steward guard says it did. */
|
|
487
484
|
export const GUARD_RETIRED = 'Retired the steward guard an earlier release registered: its group in .claude/settings.local.json and its ownership state are removed.';
|
|
488
485
|
/** A next action of this verb as printed: with `--root` given, each `ia host` command in it carries the root. */
|
|
489
486
|
const say = (view, text) => hostNext(text, view.host, view.root, view.rooted);
|
|
@@ -555,11 +552,11 @@ function materialize(view, packageRoot) {
|
|
|
555
552
|
}
|
|
556
553
|
/**
|
|
557
554
|
* §8: mcp, projection in order; removal in reverse. The payload is materialized, then every sub-transaction is
|
|
558
|
-
* re-planned with the verifying planners before any is applied — the projection's guard retirement
|
|
555
|
+
* re-planned with the verifying planners before any is applied — the projection's guard retirement and file plan
|
|
559
556
|
* included — so a refusal any planner can find is raised before the workspace changes; each apply then re-plans under
|
|
560
557
|
* the host lock and refuses a plan that went stale. The projection is applied through `applyHostProjection`, the one
|
|
561
|
-
* writer of projection files, which retires an owned steward guard before any projection file changes and reports it
|
|
562
|
-
*
|
|
558
|
+
* writer of projection files, which retires an owned steward guard before any projection file changes and reports it as
|
|
559
|
+
* the element's `guard`. Cancellation is observed between sub-transactions. A failure after an element was written
|
|
563
560
|
* names the rerun that finishes the set, or the recovery a pending journal needs. `checkpoint` runs after each element
|
|
564
561
|
* completes, which is where an interruption test cuts.
|
|
565
562
|
*/
|
|
@@ -602,9 +599,9 @@ export function applyHostSet(view, packageRoot, signal, checkpoint = () => { })
|
|
|
602
599
|
checkpoint(id);
|
|
603
600
|
};
|
|
604
601
|
/**
|
|
605
|
-
*
|
|
606
|
-
*
|
|
607
|
-
*
|
|
602
|
+
* The host's join receipts. Receipts that cannot be read are never replaced, and a rerun alone would refuse again, so
|
|
603
|
+
* their refusal names deleting them first: they are derived, and the rerun records them again. Any other failure is
|
|
604
|
+
* `failure`'s.
|
|
608
605
|
*/
|
|
609
606
|
const joinFailure = (error) => {
|
|
610
607
|
if (refusedPath(error) !== JOINS || pendingJournal(root) !== undefined)
|
|
@@ -625,8 +622,8 @@ export function applyHostSet(view, packageRoot, signal, checkpoint = () => { })
|
|
|
625
622
|
throw joinFailure(error);
|
|
626
623
|
}
|
|
627
624
|
};
|
|
628
|
-
//
|
|
629
|
-
//
|
|
625
|
+
// Receipts that cannot be read refuse before anything is written, the payload included, rather than after the MCP
|
|
626
|
+
// registration (`joinHost` and `leaveHost` read them again under the host lock).
|
|
630
627
|
try {
|
|
631
628
|
readJoins(root);
|
|
632
629
|
}
|
|
@@ -640,12 +637,12 @@ export function applyHostSet(view, packageRoot, signal, checkpoint = () => { })
|
|
|
640
637
|
if (!view.remove) {
|
|
641
638
|
const cache = materialize(view, packageRoot);
|
|
642
639
|
const mcp = replan(view, 'mcp', MCP_PATH[host], () => planHost(root, host, cache));
|
|
643
|
-
//
|
|
640
|
+
// The rendering the plan's gated session made, re-planned against the files as they are now.
|
|
644
641
|
const { rendered } = view;
|
|
645
642
|
// Only a removal's view carries no rendering (collectHost); an apply always has the one its gated plan made.
|
|
646
643
|
if (rendered === null)
|
|
647
644
|
throw new Error('A host apply view carries no rendering');
|
|
648
|
-
// The hook groups run the guard in the payload just materialized and verified
|
|
645
|
+
// The hook groups run the guard in the payload just materialized and verified.
|
|
649
646
|
replanProjection(root, host, rendered, (conflict) => refusalFor(view, 'projection', conflict), {
|
|
650
647
|
verified: cache,
|
|
651
648
|
});
|
|
@@ -668,8 +665,8 @@ export function applyHostSet(view, packageRoot, signal, checkpoint = () => { })
|
|
|
668
665
|
return { status: 'host-removed', elements: done, observed: false };
|
|
669
666
|
}
|
|
670
667
|
/**
|
|
671
|
-
* A conflict as the `--json` envelopes print it
|
|
672
|
-
*
|
|
668
|
+
* A conflict as the `--json` envelopes print it: its code, path and reason. The descriptors a refusal carries to word
|
|
669
|
+
* its own repair (`hook`, `folder`) stay internal; the repair is the refusal's `next`.
|
|
673
670
|
*/
|
|
674
671
|
export const printedConflict = (conflict) => conflict === null ? null : { code: conflict.code, path: conflict.path, reason: conflict.reason };
|
|
675
672
|
/** §4 `--json`: the plan always, and `applied` only after an apply. */
|
|
@@ -717,7 +714,7 @@ function elementFields(view) {
|
|
|
717
714
|
};
|
|
718
715
|
});
|
|
719
716
|
}
|
|
720
|
-
/** A projection plan's
|
|
717
|
+
/** A projection plan's guard retirement as its plan says it, in `ia host` and `ia project` alike. */
|
|
721
718
|
export const GUARD_RETIRE = `first retires the steward guard registered in ${SETTINGS}`;
|
|
722
719
|
/**
|
|
723
720
|
* Each projected file with its action, at `column`; a foreign steward file says why it is left alone. `ia host` nests
|
|
@@ -737,7 +734,7 @@ const HOOK_SYMBOL = {
|
|
|
737
734
|
unchanged: 'info',
|
|
738
735
|
remove: 'removed',
|
|
739
736
|
};
|
|
740
|
-
/** Each authored `@hook`'s group with its action
|
|
737
|
+
/** Each authored `@hook`'s group with its action, worded alike by `ia host` and `ia project`. */
|
|
741
738
|
export const projectionHookRows = (hooks, column, caps) => hooks.flatMap((hook) => entry([[atom(hook.hook, 'cyan', 0), ...words(`hook group ${hook.action}`, null, 2)]], { column, symbol: HOOK_SYMBOL[hook.action] }, caps));
|
|
742
739
|
/** Each authored record the host does not take, with the reason, worded alike by `ia host` and `ia project`. */
|
|
743
740
|
export const unsupportedRows = (rows, column, caps) => rows.flatMap((row) => entry([[atom(row.identity, 'cyan', 0), ...words(`${row.word} not taken: ${row.reason}`, null, 2)]], { column, symbol: 'warning' }, caps));
|
|
@@ -765,7 +762,7 @@ const elementsBlock = (view, caps) => [
|
|
|
765
762
|
];
|
|
766
763
|
/**
|
|
767
764
|
* §5.3's machine-local sentence and, for a Claude registration, §5.4's approval note and the guard's retirement (only
|
|
768
|
-
* Claude ever registered the guard
|
|
765
|
+
* Claude ever registered the guard). `ia init --host` prints the same blocks after its host step, so the two verbs
|
|
769
766
|
* cannot word them differently.
|
|
770
767
|
*/
|
|
771
768
|
export const hostNotes = (host, caps, remove = false) => [
|