@hozu/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 olevatorr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @hozu/cli
+
+The hozu command: validate, inspect, graph, explain, impact, plan, build and skill (all with --json).
+
+Part of [Hozu](https://github.com/olevatorr/Hozu#readme), an AI-first web framework. Most apps start from
+`npm create hozu@latest`, which installs the right packages and sets up Claude Code or `AGENTS.md` agents.
+
+```sh
+npm install @hozu/cli
+```
+
+Requires Node 22.18 or newer. Documentation: the [README](https://github.com/olevatorr/Hozu#readme) and the
+agent skill that `create-hozu` writes into each app.
+
+MIT © olevatorr

package/bin/hozu.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from '../dist/main.js'
+
+process.exitCode = await main(process.argv.slice(2))

package/dist/commands/build.d.ts

@@ -0,0 +1,4 @@
+import type { BuildOutput } from '../contract.ts';
+import type { Loaded } from '../load.ts';
+export declare function runBuild(loaded: Loaded, out: string | undefined, cwd: string): Promise<BuildOutput>;
+//# sourceMappingURL=build.d.ts.map

package/dist/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAsBxC,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAqEzG"}

package/dist/commands/build.js

@@ -0,0 +1,81 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { copyFile, mkdir, writeFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { dirname, join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { hashJson } from '@hozu/core/ir';
+import { HozuCliError } from '../errors.js';
+export async function runBuild(loaded, out, cwd) {
+    const build = loaded.build(false);
+    const errors = build.diagnostics.filter((d) => d.severity === 'error');
+    if (errors.length)
+        throw new HozuCliError('build', `The project has ${errors.length} build errors`, ['Run hozu validate']);
+    const require = createRequire(loaded.path);
+    const optional = async (id) => {
+        try {
+            return (await import(__rewriteRelativeImportExtension(pathToFileURL(require.resolve(id)).href)));
+        }
+        catch {
+            return null;
+        }
+    };
+    const from = async (id) => {
+        try {
+            return (await import(__rewriteRelativeImportExtension(pathToFileURL(require.resolve(id)).href)));
+        }
+        catch {
+            throw new HozuCliError('build', `hozu build needs ${id} installed in the project`, [`pnpm add ${id}`]);
+        }
+    };
+    const base = dirname(loaded.path);
+    const styles = build.bindings.styles.entry
+        ? await (await from('@hozu/css')).compileStyles(build, { base })
+        : null;
+    const widgets = Object.keys(build.bindings.widgets).length
+        ? await (await from('@hozu/bundle')).bundleWidgets(build)
+        : null;
+    const images = await optional('@hozu/image').then((m) => (m ? m.optimizeImages(build) : null));
+    const server = await from('@hozu/runtime-server');
+    const dir = resolve(cwd, out ?? 'dist');
+    const files = [];
+    for (const f of server.staticFiles(build, { styles, widgets, client: true })) {
+        const file = join(dir, 'public', f.path.replace(/^\//, ''));
+        await mkdir(dirname(file), { recursive: true });
+        if (f.file)
+            await copyFile(f.file, file);
+        else
+            await writeFile(file, f.text ?? '');
+        files.push(file);
+    }
+    for (const [href, bytes] of Object.entries(images?.files ?? {})) {
+        const file = join(dir, 'public', href.replace(/^\//, ''));
+        await mkdir(dirname(file), { recursive: true });
+        await writeFile(file, bytes);
+        files.push(file);
+    }
+    const manifest = {
+        irHash: hashJson(build.ir),
+        images: images && Object.keys(images.variants).length ? images.variants : null,
+        assets: build.bindings.assetOrder,
+        widgets: Object.fromEntries(Object.entries(widgets?.urls ?? {}).map(([ref, url]) => {
+            const [feature, symbol] = ref.split('.');
+            return [ref, { hash: build.ir.features[feature]?.widgets[symbol]?.sourceHash ?? '', url }];
+        })),
+        styles: styles ? { href: styles.href, preload: styles.preload } : null,
+    };
+    const renderFile = join(dir, 'server', 'render.js');
+    await mkdir(dirname(renderFile), { recursive: true });
+    await writeFile(renderFile, server.generateRender(build, manifest.images));
+    files.push(renderFile);
+    const manifestFile = join(dir, 'manifest.json');
+    await writeFile(manifestFile, `${JSON.stringify(manifest, null, 2)}\n`);
+    return { out: dir, manifest: manifestFile, files };
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"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"}

package/dist/commands/explain.d.ts

@@ -0,0 +1,5 @@
+import type { ExplainOutput } from '../contract.ts';
+import { type Loaded } from '../load.ts';
+export declare function runExplain(loaded: Loaded, target: string | undefined): ExplainOutput;
+export declare function describeExplain(out: ExplainOutput): string;
+//# sourceMappingURL=explain.d.ts.map

package/dist/commands/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAkC,MAAM,gBAAgB,CAAA;AAEnF,OAAO,EAAE,KAAK,MAAM,EAAkB,MAAM,YAAY,CAAA;AAqExD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAuCpF;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAwB1D"}

package/dist/commands/explain.js

@@ -0,0 +1,135 @@
+import { closest, verify } from '@hozu/validator';
+import { HozuCliError } from '../errors.js';
+import { requireFeature } from '../load.js';
+import { renderAssign, renderGuard, renderValue } from '../render.js';
+const local = (ref) => ref.slice(ref.indexOf('.') + 1);
+function transitionsOf(feature, coveredBy) {
+    const out = [];
+    const add = (from, id, trigger, t) => out.push({
+        id,
+        from,
+        to: t.target,
+        trigger,
+        guard: t.guard ? renderGuard(t.guard) : null,
+        assign: t.assign.map(renderAssign),
+        navigate: t.navigate && 'link' in t.navigate ? t.navigate.link : null,
+        coveredBy: coveredBy(id),
+    });
+    for (const [name, s] of Object.entries(feature.machine?.states ?? {})) {
+        for (const [event, list] of Object.entries(s.on))
+            list.forEach((t, i) => add(name, `${name}/on/${event}/${i}`, `on ${local(event)}`, t));
+        s.invoke?.done.forEach((t, i) => add(name, `${name}/invoke/done/${i}`, 'done', t));
+        for (const [error, list] of Object.entries(s.invoke?.failed ?? {}))
+            list.forEach((t, i) => add(name, `${name}/invoke/failed/${error}/${i}`, `failed.${error}`, t));
+        s.after.forEach((a, i) => add(name, `${name}/after/${i}`, `after ${a.ms}ms`, a.transition));
+    }
+    return out;
+}
+function sendsIn(feature, state) {
+    const out = [];
+    const states = feature.machine.states;
+    const walk = (node, view, visible) => {
+        if (!visible)
+            return;
+        switch (node.kind) {
+            case 'if':
+                for (const c of [...node.ifTrue, ...node.ifFalse])
+                    walk(c, view, visible);
+                return;
+            case 'el':
+            case 'widget':
+            case 'global':
+                for (const send of Object.values(node.on))
+                    out.push({
+                        view,
+                        node: node.id,
+                        event: send.event,
+                        handled: Boolean(states[state].on[send.event]?.length),
+                    });
+                if (node.kind !== 'global')
+                    for (const c of node.children)
+                        walk(c, view, visible);
+                return;
+            case 'when':
+                for (const c of node.children)
+                    walk(c, view, node.states.includes(state));
+                return;
+            case 'each':
+                walk(node.item, view, visible);
+                return;
+            case 'query':
+                for (const c of [node.ready, ...(node.pending ? [node.pending] : []), ...Object.values(node.failed)])
+                    walk(c, view, visible);
+                return;
+            default:
+                return;
+        }
+    };
+    for (const [vid, view] of Object.entries(feature.views))
+        if (view.machine === feature.id)
+            walk(view.root, `${feature.id}.${vid}`, true);
+    return out;
+}
+export function runExplain(loaded, target) {
+    if (!target?.includes('.'))
+        throw new HozuCliError('usage', 'Expected <feature>.<state>, e.g. hozu explain cart.idle');
+    const [fid, state] = [target.slice(0, target.indexOf('.')), target.slice(target.indexOf('.') + 1)];
+    const build = loaded.build();
+    const feature = requireFeature(build.ir, fid);
+    const m = feature.machine;
+    if (!m)
+        throw new HozuCliError('unknown-feature', `Feature "${fid}" has no machine`);
+    const s = m.states[state];
+    if (!s) {
+        const guess = closest(state, Object.keys(m.states));
+        throw new HozuCliError('unknown-feature', `Unknown state "${state}" in ${fid}`, guess ? [`${fid}.${guess}`] : Object.keys(m.states).map((n) => `${fid}.${n}`));
+    }
+    const { lock } = verify(build.ir, { bindings: build.bindings });
+    const entries = lock?.features[fid] ?? {};
+    const all = transitionsOf(feature, (id) => Object.keys(entries[id]?.contracts ?? {}));
+    const effect = s.invoke ? build.ir.features[s.invoke.effect.split('.')[0]] : undefined;
+    const effectSymbol = s.invoke ? local(s.invoke.effect) : '';
+    const declared = effect?.queries[effectSymbol]?.errors ?? effect?.mutations[effectSymbol]?.errors ?? {};
+    return {
+        feature: fid,
+        state,
+        initial: m.initial === state,
+        final: s.final,
+        invoke: s.invoke
+            ? {
+                effect: s.invoke.effect,
+                input: renderValue(s.invoke.input),
+                errors: [...Object.keys(declared), 'Unexpected'],
+            }
+            : null,
+        outgoing: all.filter((t) => t.from === state),
+        incoming: all.filter((t) => t.to === state),
+        sends: sendsIn(feature, state),
+    };
+}
+export function describeExplain(out) {
+    const line = (t, dir) => {
+        const guard = t.guard ? ` [${t.guard}]` : '';
+        const effects = [...t.assign, ...(t.navigate ? [`navigate(${t.navigate})`] : [])];
+        const body = effects.length ? `  { ${effects.join('; ')} }` : '';
+        const covered = t.coveredBy.length ? `  ✓ ${t.coveredBy.join(', ')}` : '  ✗ uncovered';
+        return dir === 'out'
+            ? `  ${t.trigger}${guard} → ${t.to}${body}${covered}`
+            : `  ${t.from} --${t.trigger}${guard}--> ${out.state}`;
+    };
+    const flags = [out.initial && 'initial', out.final && 'final'].filter(Boolean).join(', ');
+    return [
+        `${out.feature}.${out.state}${flags ? `  (${flags})` : ''}`,
+        `invoke: ${out.invoke ? `${out.invoke.effect}(${out.invoke.input})  errors: ${out.invoke.errors.join(', ')}` : 'none'}`,
+        'outgoing:',
+        ...(out.outgoing.length ? out.outgoing.map((t) => line(t, 'out')) : ['  (none)']),
+        'incoming:',
+        ...(out.incoming.length ? out.incoming.map((t) => line(t, 'in')) : ['  (none)']),
+        'views can send:',
+        ...(out.sends.length
+            ? out.sends.map((s) => `  ${local(s.event)} from ${s.node}${s.handled ? '' : '  ✗ not handled here'}`)
+            : ['  (nothing)']),
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=explain.js.map

package/dist/commands/explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAe,cAAc,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAErE,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;AAE9D,SAAS,aAAa,CAAC,OAAkB,EAAE,SAAmC;IAC5E,MAAM,GAAG,GAAwB,EAAE,CAAA;IACnC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAU,EAAE,OAAe,EAAE,CAAe,EAAE,EAAE,CACzE,GAAG,CAAC,IAAI,CAAC;QACP,EAAE;QACF,IAAI;QACJ,EAAE,EAAE,CAAC,CAAC,MAAM;QACZ,OAAO;QACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;QAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;QAClC,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QACrE,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;KACzB,CAAC,CAAA;IACJ,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;QACtE,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,OAAO,KAAK,IAAI,CAAC,EAAE,EAAE,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;QACxF,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;QAClF,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;YAChE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,kBAAkB,KAAK,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;QAChG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,UAAU,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;IAC7F,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,OAAO,CAAC,OAAkB,EAAE,KAAa;IAChD,MAAM,GAAG,GAAkB,EAAE,CAAA;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAQ,CAAC,MAAM,CAAA;IACtC,MAAM,IAAI,GAAG,CAAC,IAAc,EAAE,IAAY,EAAE,OAAgB,EAAE,EAAE;QAC9D,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,IAAI;gBACP,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;oBAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;gBACzE,OAAM;YACR,KAAK,IAAI,CAAC;YACV,KAAK,QAAQ,CAAC;YACd,KAAK,QAAQ;gBACX,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvC,GAAG,CAAC,IAAI,CAAC;wBACP,IAAI;wBACJ,IAAI,EAAE,IAAI,CAAC,EAAE;wBACb,KAAK,EAAE,IAAI,CAAC,KAAK;wBACjB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAE,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;qBACxD,CAAC,CAAA;gBACJ,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;oBAAE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ;wBAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;gBACjF,OAAM;YACR,KAAK,MAAM;gBACT,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ;oBAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;gBACzE,OAAM;YACR,KAAK,MAAM;gBACT,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;gBAC9B,OAAM;YACR,KAAK,OAAO;gBACV,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAClG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;gBACxB,OAAM;YACR;gBACE,OAAM;QACV,CAAC;IACH,CAAC,CAAA;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;QACrD,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,EAAE;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,CAAC,CAAA;IAChF,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,MAA0B;IACnE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC;QACxB,MAAM,IAAI,YAAY,CAAC,OAAO,EAAE,yDAAyD,CAAC,CAAA;IAC5F,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IAClG,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAA;IAC5B,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;IAC7C,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAA;IACzB,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,YAAY,GAAG,kBAAkB,CAAC,CAAA;IACpF,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACzB,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;QACnD,MAAM,IAAI,YAAY,CACpB,iBAAiB,EACjB,kBAAkB,KAAK,QAAQ,GAAG,EAAE,EACpC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAC9E,CAAA;IACH,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC/D,MAAM,OAAO,GAAG,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;IACzC,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,CAAA;IACrF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACvF,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3D,MAAM,QAAQ,GAAG,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,IAAI,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,IAAI,EAAE,CAAA;IACvG,OAAO;QACL,OAAO,EAAE,GAAG;QACZ,KAAK;QACL,OAAO,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK;QAC5B,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;YACd,CAAC,CAAC;gBACE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;gBACvB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAClC,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;aACjD;YACH,CAAC,CAAC,IAAI;QACR,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC;QAC7C,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC;QAC3C,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;KAC/B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAkB;IAChD,MAAM,IAAI,GAAG,CAAC,CAAoB,EAAE,GAAiB,EAAE,EAAE;QACvD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QAC5C,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACjF,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;QAChE,MAAM,OAAO,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAA;QACtF,OAAO,GAAG,KAAK,KAAK;YAClB,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI,GAAG,OAAO,EAAE;YACrD,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,OAAO,GAAG,KAAK,OAAO,GAAG,CAAC,KAAK,EAAE,CAAA;IAC1D,CAAC,CAAA;IACD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS,EAAE,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzF,OAAO;QACL,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3D,WAAW,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,cAAc,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;QACvH,WAAW;QACX,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACjF,WAAW;QACX,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAChF,iBAAiB;QACjB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM;YAClB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC;YACtG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QACpB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/commands/graph.d.ts

@@ -0,0 +1,7 @@
+import type { FeatureIR } from '@hozu/core/ir';
+import type { GraphOutput } from '../contract.ts';
+import { type Loaded } from '../load.ts';
+export declare function graphOf(feature: FeatureIR): GraphOutput;
+export declare const runGraph: (loaded: Loaded, id: string | undefined) => GraphOutput;
+export declare function mermaid(graph: GraphOutput): string;
+//# sourceMappingURL=graph.d.ts.map

package/dist/commands/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,eAAe,CAAA;AACxD,OAAO,KAAK,EAAwB,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACvE,OAAO,EAAE,KAAK,MAAM,EAAkB,MAAM,YAAY,CAAA;AAoDxD,wBAAgB,OAAO,CAAC,OAAO,EAAE,SAAS,GAAG,WAAW,CAiEvD;AAED,eAAO,MAAM,QAAQ,WAAY,MAAM,MAAM,MAAM,GAAG,SAAS,KAAG,WAClB,CAAA;AAEhD,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAUlD"}

package/dist/commands/graph.js

@@ -0,0 +1,137 @@
+import { requireFeature } from '../load.js';
+const local = (ref) => ref.slice(ref.indexOf('.') + 1);
+function collectViewEdges(node, from, edges, nodes) {
+    const add = (id, kind, label) => {
+        if (!nodes.has(id))
+            nodes.set(id, { id, kind, label, initial: false, final: false });
+    };
+    switch (node.kind) {
+        case 'if':
+            for (const child of [...node.ifTrue, ...node.ifFalse])
+                collectViewEdges(child, from, edges, nodes);
+            return;
+        case 'el':
+        case 'widget':
+        case 'global':
+            for (const send of Object.values(node.on)) {
+                add(`event:${send.event}`, 'event', send.event);
+                edges.push({
+                    from,
+                    to: `event:${send.event}`,
+                    kind: 'send',
+                    label: node.kind === 'el' ? node.tag : node.kind === 'widget' ? node.widget : node.target,
+                });
+            }
+            if (node.kind !== 'global')
+                for (const child of node.children)
+                    collectViewEdges(child, from, edges, nodes);
+            return;
+        case 'when':
+            for (const child of node.children)
+                collectViewEdges(child, from, edges, nodes);
+            return;
+        case 'each':
+            collectViewEdges(node.item, from, edges, nodes);
+            return;
+        case 'query':
+            add(`query:${node.query}`, 'query', node.query);
+            edges.push({ from, to: `query:${node.query}`, kind: 'reads', label: '' });
+            for (const child of [
+                node.ready,
+                ...(node.pending ? [node.pending] : []),
+                ...Object.values(node.failed),
+            ])
+                collectViewEdges(child, from, edges, nodes);
+            return;
+        case 'embed':
+            add(`view:${node.view}`, 'view', node.view);
+            edges.push({ from, to: `view:${node.view}`, kind: 'embeds', label: '' });
+            return;
+        default:
+            return;
+    }
+}
+export function graphOf(feature) {
+    const nodes = new Map();
+    const edges = [];
+    const m = feature.machine;
+    for (const [state, s] of Object.entries(m?.states ?? {})) {
+        const id = `state:${state}`;
+        nodes.set(id, { id, kind: 'state', label: state, initial: m?.initial === state, final: s.final });
+        const guarded = (g) => (g ? ' [guard]' : '');
+        for (const [event, list] of Object.entries(s.on))
+            for (const t of list)
+                edges.push({
+                    from: id,
+                    to: `state:${t.target}`,
+                    kind: 'on',
+                    label: `${local(event)}${guarded(t.guard)}`,
+                });
+        if (s.invoke) {
+            const effect = `effect:${s.invoke.effect}`;
+            if (!nodes.has(effect))
+                nodes.set(effect, {
+                    id: effect,
+                    kind: 'effect',
+                    label: s.invoke.effect,
+                    initial: false,
+                    final: false,
+                });
+            edges.push({ from: id, to: effect, kind: 'invoke', label: '' });
+            for (const t of s.invoke.done)
+                edges.push({ from: id, to: `state:${t.target}`, kind: 'done', label: `done${guarded(t.guard)}` });
+            for (const [error, list] of Object.entries(s.invoke.failed))
+                for (const t of list)
+                    edges.push({
+                        from: id,
+                        to: `state:${t.target}`,
+                        kind: 'failed',
+                        label: `failed.${error}${guarded(t.guard)}`,
+                    });
+        }
+        for (const a of s.after)
+            edges.push({
+                from: id,
+                to: `state:${a.transition.target}`,
+                kind: 'after',
+                label: `after ${a.ms}ms${guarded(a.transition.guard)}`,
+            });
+    }
+    for (const [vid, view] of Object.entries(feature.views)) {
+        const id = `view:${feature.id}.${vid}`;
+        nodes.set(id, { id, kind: 'view', label: `${feature.id}.${vid}`, initial: false, final: false });
+        collectViewEdges(view.root, id, edges, nodes);
+    }
+    for (const imported of feature.imports) {
+        const id = `feature:${imported}`;
+        nodes.set(id, { id, kind: 'feature', label: imported, initial: false, final: false });
+        edges.push({ from: `feature:${feature.id}`, to: id, kind: 'import', label: '' });
+    }
+    if (feature.imports.length)
+        nodes.set(`feature:${feature.id}`, {
+            id: `feature:${feature.id}`,
+            kind: 'feature',
+            label: feature.id,
+            initial: false,
+            final: false,
+        });
+    return { feature: feature.id, nodes: [...nodes.values()].sort((a, b) => a.id.localeCompare(b.id)), edges };
+}
+export const runGraph = (loaded, id) => graphOf(requireFeature(loaded.build().ir, id));
+export function mermaid(graph) {
+    const states = graph.nodes.filter((n) => n.kind === 'state');
+    if (!states.length)
+        return `stateDiagram-v2\n  note "${graph.feature} has no machine"\n`;
+    const lines = ['stateDiagram-v2'];
+    for (const s of states)
+        if (s.initial)
+            lines.push(`  [*] --> ${s.label}`);
+    for (const e of graph.edges)
+        if (e.from.startsWith('state:') && e.to.startsWith('state:'))
+            lines.push(`  ${e.from.slice(6)} --> ${e.to.slice(6)}: ${e.label}`);
+    for (const s of states)
+        if (s.final)
+            lines.push(`  ${s.label} --> [*]`);
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=graph.js.map

package/dist/commands/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"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"}

package/dist/commands/impact.d.ts

@@ -0,0 +1,5 @@
+import type { ImpactOutput } from '../contract.ts';
+import type { Loaded } from '../load.ts';
+export declare function runImpact(loaded: Loaded, target: string | undefined): ImpactOutput;
+export declare function describeImpact(out: ImpactOutput): string;
+//# sourceMappingURL=impact.d.ts.map

package/dist/commands/impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../../src/commands/impact.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAUlF;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAcxD"}

package/dist/commands/impact.js

@@ -0,0 +1,27 @@
+import { impact, UnknownSymbolError } from '@hozu/validator';
+import { HozuCliError } from '../errors.js';
+export function runImpact(loaded, target) {
+    if (!target?.includes('.'))
+        throw new HozuCliError('usage', 'Expected <feature>.<symbol>, e.g. hozu impact cart.addItem');
+    try {
+        return impact(loaded.build().ir, target);
+    }
+    catch (error) {
+        if (error instanceof UnknownSymbolError)
+            throw new HozuCliError('unknown-feature', error.message, error.suggestions);
+        throw error;
+    }
+}
+export function describeImpact(out) {
+    const lines = [`${out.target}  (${out.kind})`];
+    if (out.tags.length)
+        lines.push(`tags: ${out.tags.join(', ')}`);
+    if (out.queries.length)
+        lines.push('affects queries:', ...out.queries.map((q) => `  ${q.ref} via ${q.tag}${q.precision === 'exact' ? '' : '  (param-dependent)'}`));
+    if (out.invalidatedBy.length)
+        lines.push(`invalidated by: ${out.invalidatedBy.join(', ')}`);
+    lines.push('uses:', ...(out.uses.length ? out.uses.map((u) => `  ${u.via}`) : ['  (none)']));
+    lines.push(`features: ${out.features.join(', ')}`, '');
+    return lines.join('\n');
+}
+//# sourceMappingURL=impact.js.map

package/dist/commands/impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.js","sourceRoot":"","sources":["../../src/commands/impact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,MAA0B;IAClE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC;QACxB,MAAM,IAAI,YAAY,CAAC,OAAO,EAAE,4DAA4D,CAAC,CAAA;IAC/F,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,kBAAkB;YACrC,MAAM,IAAI,YAAY,CAAC,iBAAiB,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;QAC7E,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAiB;IAC9C,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,CAAA;IAC9C,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC/D,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM;QACpB,KAAK,CAAC,IAAI,CACR,kBAAkB,EAClB,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAChB,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,qBAAqB,EAAE,CACxF,CACF,CAAA;IACH,IAAI,GAAG,CAAC,aAAa,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC3F,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IAC5F,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IACtD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/commands/inspect.d.ts

@@ -0,0 +1,4 @@
+import type { InspectOutput } from '../contract.ts';
+import { type Loaded } from '../load.ts';
+export declare function runInspect(loaded: Loaded, id: string | undefined): InspectOutput;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/commands/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,KAAK,MAAM,EAAkB,MAAM,YAAY,CAAA;AAExD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CA+BhF"}

package/dist/commands/inspect.js

@@ -0,0 +1,31 @@
+import { hashJson } from '@hozu/core/ir';
+import { requireFeature } from '../load.js';
+export function runInspect(loaded, id) {
+    const { ir } = loaded.build();
+    const feature = requireFeature(ir, id);
+    const states = Object.values(feature.machine?.states ?? {});
+    const transitions = states.reduce((n, s) => n +
+        Object.values(s.on).reduce((m, l) => m + l.length, 0) +
+        (s.invoke
+            ? s.invoke.done.length + Object.values(s.invoke.failed).reduce((m, l) => m + l.length, 0)
+            : 0) +
+        s.after.length, 0);
+    return {
+        feature: feature.id,
+        hash: hashJson(feature),
+        summary: {
+            states: states.length,
+            transitions,
+            events: Object.keys(feature.events).length,
+            queries: Object.keys(feature.queries).length,
+            mutations: Object.keys(feature.mutations).length,
+            views: Object.keys(feature.views).length,
+            contracts: Object.keys(feature.contracts).length,
+            hydrates: Object.values(feature.views).some((v) => v.machine !== null),
+            imports: feature.imports,
+            exports: feature.exports,
+        },
+        ir: feature,
+    };
+}
+//# sourceMappingURL=inspect.js.map

package/dist/commands/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,OAAO,EAAe,cAAc,EAAE,MAAM,YAAY,CAAA;AAExD,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,EAAsB;IAC/D,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAA;IAC7B,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC,CAAA;IAC3D,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAC/B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC,MAAM;YACP,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACzF,CAAC,CAAC,CAAC,CAAC;QACN,CAAC,CAAC,KAAK,CAAC,MAAM,EAChB,CAAC,CACF,CAAA;IACD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,EAAE;QACnB,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC;QACvB,OAAO,EAAE;YACP,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW;YACX,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM;YAC1C,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM;YAC5C,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM;YAChD,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM;YACxC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM;YAChD,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC;YACtE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB;QACD,EAAE,EAAE,OAAO;KACZ,CAAA;AACH,CAAC"}

package/dist/commands/plan.d.ts

@@ -0,0 +1,5 @@
+import type { PlanOutput } from '../contract.ts';
+import type { Loaded } from '../load.ts';
+export declare function runPlan(loaded: Loaded, route: string | undefined): PlanOutput;
+export declare function describePlan(plan: PlanOutput): string;
+//# sourceMappingURL=plan.d.ts.map

package/dist/commands/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAS7E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAiBrD"}

package/dist/commands/plan.js

@@ -0,0 +1,30 @@
+import { planRoute, softTargets } from '@hozu/compiler';
+import { closest } from '@hozu/validator';
+import { HozuCliError } from '../errors.js';
+export function runPlan(loaded, route) {
+    const { ir } = loaded.build();
+    const routes = Object.keys(ir.pages);
+    if (!route)
+        throw new HozuCliError('usage', 'Missing <route> argument', routes);
+    if (!ir.pages[route]) {
+        const guess = closest(route, routes);
+        throw new HozuCliError('unknown-feature', `No page renders route "${route}"`, guess ? [guess] : routes);
+    }
+    return { ...planRoute(ir, route).plan, soft: softTargets(ir, route) };
+}
+export function describePlan(plan) {
+    const width = Math.max(...plan.regions.map((r) => r.id.length));
+    return [
+        `${plan.route}  ${plan.path}  · js: ${plan.js ? `${plan.islands.length} islands` : 'none (0 bytes)'} · cacheable: ${plan.cacheable ? 'yes' : 'no'}${plan.assert ? ` · asserts ${plan.assert}` : ''}`,
+        'regions:',
+        ...plan.regions.map((r) => `  ${r.id.padEnd(width)}  ${r.mode}${r.seconds === null ? '' : ` ${r.seconds}s`}${r.query ? `  ${r.query} (${r.scope})` : ''}`),
+        'islands:',
+        ...(plan.islands.length ? plan.islands.map((i) => `  ${i}`) : ['  (none)']),
+        'soft navigation (target route → kept views):',
+        ...(Object.keys(plan.soft).length
+            ? Object.entries(plan.soft).map(([r, views]) => `  ${r} → ${views.join(', ')}`)
+            : ['  (none: links from this page are document navigations)']),
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"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"}

package/dist/commands/skill.d.ts

@@ -0,0 +1,3 @@
+import type { SkillOutput } from '../contract.ts';
+export declare function runSkill(cwd: string, requested: string | undefined): Promise<SkillOutput>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/commands/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AASjD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAoB/F"}