@assemora/cli 0.1.0

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,UAAU,CAAA;AACjB,OAAO,UAAU,CAAA;AACjB,OAAO,SAAS,CAAA;AAChB,OAAO,cAAc,CAAA;AACrB,OAAO,gBAAgB,CAAA;AACvB,OAAO,aAAa,CAAA;AACpB,OAAO,cAAc,CAAA;AACrB,OAAO,UAAU,CAAA;AAEjB,OAAO,WAAW,CAAA"}

package/dist/commands/inspect.d.ts

@@ -0,0 +1,8 @@
+export declare const Routes: import("../registry.js").CliCommand;
+export declare const Models: import("../registry.js").CliCommand;
+export declare const Resources: import("../registry.js").CliCommand;
+export declare const Blocks: import("../registry.js").CliCommand;
+export declare const Agents: import("../registry.js").CliCommand;
+/** In the order SPEC.md §77 lists them, which is the order the help prints them in. */
+export declare const inspectCommands: readonly [import("../registry.js").CliCommand, import("../registry.js").CliCommand, import("../registry.js").CliCommand, import("../registry.js").CliCommand, import("../registry.js").CliCommand];
+//# 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":"AA8JA,eAAO,MAAM,MAAM,qCAWjB,CAAA;AAEF,eAAO,MAAM,MAAM,qCAWjB,CAAA;AAEF,eAAO,MAAM,SAAS,qCAWpB,CAAA;AAEF,eAAO,MAAM,MAAM,qCAWjB,CAAA;AA6DF,eAAO,MAAM,MAAM,qCAoFjB,CAAA;AAEF,uFAAuF;AACvF,eAAO,MAAM,eAAe,oMAAuD,CAAA"}

package/dist/commands/inspect.js

@@ -0,0 +1,280 @@
+/**
+ * `assemora routes | models | resources | blocks | agents` (SPEC.md §77).
+ *
+ * Four of these read the Schema Registry, and by the time the CLI sees it, it is
+ * plain data: `describe()` hands back entries typed as a name and nothing more,
+ * because `@assemora/cli` cannot import the packages that declare what a route or a
+ * block *is* (ADR-0021). Every column below therefore reads a field it has checked
+ * for itself, and a descriptor missing one prints an empty cell rather than taking
+ * the whole listing down.
+ *
+ * `agents` is the odd one, and the reason is worth stating: an agent identity is
+ * data, not a declaration. It comes through the Query Bus, so listing agents is
+ * validated, authorized and audited exactly as it is from Studio or from an agent
+ * asking about itself (SPEC.md §72, §76).
+ */
+import { AssemoraError } from '@assemora/core';
+import { bool, flag } from '../args.js';
+import { loadConfig } from '../config.js';
+import { detail, fail, json, line, table } from '../output.js';
+import { loadApplication } from '../project.js';
+import { defineCommand, register } from '../registry.js';
+const isEntry = (value) => typeof value === 'object' && value !== null;
+const sectionsOf = (app) => app.registry.describe();
+/** A string field, or an empty cell where the descriptor carries none. */
+const text = (entry, key) => {
+    const value = entry[key];
+    return typeof value === 'string' ? value : '';
+};
+const strings = (value) => Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
+/** The `name` of every member of a list of descriptors — fields, relations, columns. */
+const namesIn = (value) => (Array.isArray(value) ? value.filter(isEntry) : []).map((entry) => text(entry, 'name')).join(', ');
+const countIn = (value) => String(Array.isArray(value) ? value.length : 0);
+const byName = (left, right) => text(left, 'name').localeCompare(text(right, 'name'));
+const routeColumns = [
+    { header: 'Method', value: (entry) => text(entry, 'method').toUpperCase() },
+    { header: 'Path', value: (entry) => text(entry, 'path') },
+    { header: 'Summary', value: (entry) => text(entry, 'description') },
+    {
+        // Tags are what a route was filed under; the module is where it was declared.
+        // Both answer "where did this come from", and the tags are the more specific
+        // answer, so a route carrying them is described by them.
+        header: 'From',
+        value: (entry) => {
+            const tags = strings(entry.tags);
+            return tags.length === 0 ? text(entry, 'module') : tags.join(', ');
+        },
+    },
+];
+/**
+ * Routes read by path rather than in the order they were mounted.
+ *
+ * Mount order is an accident of module order, and somebody running this is looking
+ * for one URL — which puts every method on it next to each other.
+ */
+const byPath = (left, right) => text(left, 'path').localeCompare(text(right, 'path')) ||
+    text(left, 'method').localeCompare(text(right, 'method'));
+const tableOf = (entry) => (isEntry(entry.table) ? entry.table : {});
+/** `author (belongsTo), comments (hasMany)` — the kind says which side holds the key. */
+const relationsOf = (entry) => {
+    const declared = tableOf(entry).relations;
+    return (Array.isArray(declared) ? declared.filter(isEntry) : [])
+        .map((relation) => `${text(relation, 'name')} (${text(relation, 'kind')})`)
+        .join(', ');
+};
+const modelColumns = [
+    { header: 'Model', value: (entry) => text(entry, 'name') },
+    { header: 'Table', value: (entry) => text(tableOf(entry), 'name') },
+    { header: 'Columns', value: (entry) => countIn(tableOf(entry).columns), align: 'right' },
+    { header: 'Relations', value: relationsOf },
+];
+const resourceColumns = [
+    { header: 'Resource', value: (entry) => text(entry, 'name') },
+    { header: 'Model', value: (entry) => text(entry, 'model') },
+    // A hidden field is listed here. This is a developer reading their own
+    // declarations, and what SPEC.md §85 keeps out of a published document is the
+    // value — no value is read by any of these commands.
+    { header: 'Fields', value: (entry) => namesIn(entry.fields) },
+];
+/**
+ * `no`, `any`, or the block types it will take.
+ *
+ * "Whether it accepts children" is the question; naming what it accepts answers that
+ * and says more, at no cost in width for the blocks that accept nothing.
+ */
+const childrenOf = (entry) => {
+    if (entry.acceptsChildren !== true)
+        return 'no';
+    const allowed = strings(entry.allowedChildren);
+    return allowed.length === 0 ? 'any' : allowed.join(', ');
+};
+const blockColumns = [
+    { header: 'Block', value: (entry) => text(entry, 'name') },
+    { header: 'Fields', value: (entry) => namesIn(entry.fields) },
+    { header: 'Children', value: childrenOf },
+];
+/**
+ * The shape all four registry listings share.
+ *
+ * `--json` prints the section exactly as the registry holds it, fields the table
+ * leaves out included: the next thing anybody does with a listing is pipe it, and a
+ * pipe wants the data rather than the layout (ADR-0021).
+ */
+const registryListing = (options) => {
+    return async ({ args, cwd }) => {
+        const app = await loadApplication(await loadConfig(cwd));
+        const entries = sectionsOf(app)[options.section] ?? [];
+        if (bool(args, 'json')) {
+            json(entries);
+            return 0;
+        }
+        // A grid with a header and no rows says less than one sentence does.
+        if (entries.length === 0) {
+            line(options.empty);
+            return 0;
+        }
+        table([...entries].sort(options.order), options.columns);
+        return 0;
+    };
+};
+export const Routes = defineCommand({
+    name: 'routes',
+    group: 'inspect',
+    summary: 'the HTTP routes this application registers',
+    usage: 'assemora routes [--json]',
+    handler: registryListing({
+        section: 'routes',
+        columns: routeColumns,
+        order: byPath,
+        empty: 'No routes are registered.',
+    }),
+});
+export const Models = defineCommand({
+    name: 'models',
+    group: 'inspect',
+    summary: 'the models it declares, with their tables and relations',
+    usage: 'assemora models [--json]',
+    handler: registryListing({
+        section: 'models',
+        columns: modelColumns,
+        order: byName,
+        empty: 'No models are declared.',
+    }),
+});
+export const Resources = defineCommand({
+    name: 'resources',
+    group: 'inspect',
+    summary: 'the resources it declares, and the models behind them',
+    usage: 'assemora resources [--json]',
+    handler: registryListing({
+        section: 'resources',
+        columns: resourceColumns,
+        order: byName,
+        empty: 'No resources are declared.',
+    }),
+});
+export const Blocks = defineCommand({
+    name: 'blocks',
+    group: 'inspect',
+    summary: 'the block types a page can be assembled from',
+    usage: 'assemora blocks [--json]',
+    handler: registryListing({
+        section: 'blocks',
+        columns: blockColumns,
+        order: byName,
+        empty: 'No block types are declared.',
+    }),
+});
+/** The query `@assemora/auth` registers, named rather than imported (ADR-0021). */
+const AGENTS_QUERY = 'auth.agents.list';
+const agentColumns = [
+    { header: 'Agent', value: (entry) => text(entry, 'name') },
+    { header: 'Enabled', value: (entry) => (entry.enabled === true ? 'yes' : 'no') },
+    { header: 'Permissions', value: (entry) => strings(entry.permissions).join(', ') },
+];
+/**
+ * A count typed on the command line.
+ *
+ * `--page two` is a wrong invocation rather than a command that failed, and those are
+ * different exit codes (SPEC.md §77), so this reports the refusal instead of throwing
+ * and letting `run()` call it a failure.
+ */
+const countOf = (args, name) => {
+    const written = flag(args, name);
+    if (written === undefined)
+        return { ok: true, value: undefined };
+    const value = Number(written);
+    return Number.isInteger(value) && value >= 1 ? { ok: true, value } : { ok: false };
+};
+const numberIn = (value, key) => {
+    const found = isEntry(value) ? value[key] : undefined;
+    return typeof found === 'number' ? found : undefined;
+};
+const rowsIn = (answer) => {
+    const data = isEntry(answer) ? answer.data : undefined;
+    return Array.isArray(data) ? data.filter(isEntry) : [];
+};
+/** What the authorizer raises, whichever package registered it (SPEC.md §83). */
+const isRefusal = (error) => error instanceof AssemoraError && error.code === 'FORBIDDEN';
+/**
+ * The one sentence a refused listing is missing.
+ *
+ * The authorizer names the subject and the action, because that is all it knows — it
+ * has never heard of a command line. Running as nobody is the commonest way to meet
+ * it, and `--actor` is the thing to type next, so the CLI says so rather than leaving
+ * a reader to find it in the guide.
+ */
+const refusalHint = (actorId) => actorId === undefined
+    ? 'Reading agent identities is authorized like every other query, and no actor was named. ' +
+        'Pass --actor <user id> — a user allowed to read auth.agents.'
+    : `${actorId} is not allowed to read auth.agents. Pass --actor with a user who holds that ` +
+        'permission, or grant it to this one.';
+export const Agents = defineCommand({
+    name: 'agents',
+    group: 'inspect',
+    summary: 'the agent identities this application knows',
+    usage: 'assemora agents [--actor <id>] [--page <n>] [--per-page <n>] [--json]',
+    handler: async ({ args, cwd }) => {
+        const app = await loadApplication(await loadConfig(cwd));
+        // An application built without `@assemora/auth` has no agents at all, which is a
+        // truthful answer and a more useful one than the unknown-query error it would
+        // otherwise throw. It is still a failure: the question could not be asked, which
+        // is not the same as it being answered with nothing.
+        if (!app.queries.has(AGENTS_QUERY)) {
+            fail(`This application registers no "${AGENTS_QUERY}", so it knows no agent identities. ` +
+                'They come with @assemora/auth (SPEC.md §72).');
+            return 1;
+        }
+        const page = countOf(args, 'page');
+        const perPage = countOf(args, 'per-page');
+        if (!page.ok || !perPage.ok) {
+            fail('--page and --per-page each take a whole number of 1 or more.');
+            return 2;
+        }
+        const named = flag(args, 'actor');
+        const actor = named === undefined ? undefined : { type: 'user', id: named };
+        // `cli` is a source of its own so the audit log can tell a terminal from Studio
+        // (SPEC.md §12). No actor means no permissions: running as nobody is refused, and
+        // that refusal is the correct answer rather than a fault in this command.
+        const context = { source: 'cli', ...(actor === undefined ? {} : { actor }) };
+        let answer;
+        try {
+            answer = await app.run(context, () => app.queries.execute(AGENTS_QUERY, {
+                ...(page.value === undefined ? {} : { page: page.value }),
+                ...(perPage.value === undefined ? {} : { perPage: perPage.value }),
+            }));
+        }
+        catch (error) {
+            // Everything else is `run()`'s to report: a query that could not run is a
+            // failure of the application, and only the refusal has a next step to offer.
+            if (!isRefusal(error))
+                throw error;
+            fail(error instanceof Error ? error.message : String(error));
+            detail(refusalHint(named));
+            return 1;
+        }
+        // The whole answer, not just its rows: a page carries the total and where in it
+        // this page sits, and a pipe that asked for JSON wants to know both.
+        if (bool(args, 'json')) {
+            json(answer);
+            return 0;
+        }
+        const rows = rowsIn(answer);
+        if (rows.length === 0) {
+            line('No agent identities exist.');
+            return 0;
+        }
+        table(rows, agentColumns);
+        const total = numberIn(answer, 'total');
+        // A page of twenty that says nothing about the other eighty is a lie a listing
+        // can tell in silence, so it does not.
+        if (total !== undefined && total > rows.length) {
+            detail(`Showing ${rows.length} of ${total}. Pass --page to see the rest.`);
+        }
+        return 0;
+    },
+});
+/** In the order SPEC.md §77 lists them, which is the order the help prints them in. */
+export const inspectCommands = [Routes, Models, Resources, Blocks, Agents];
+register(...inspectCommands);
+//# 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":"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"}

package/dist/commands/make.d.ts

@@ -0,0 +1,29 @@
+import { type CliCommand } from '../registry.js';
+/** `blog_post` → `BlogPost`. */
+export declare const pascalCase: (name: string) => string;
+/** `blog_post` → `blogPost`. */
+export declare const camelCase: (name: string) => string;
+/** `BlogPost` → `blog-post`. The form every generated file name takes. */
+export declare const kebabCase: (name: string) => string;
+/** `BlogPost` → `blog_post`. The form every generated table name takes. */
+export declare const snakeCase: (name: string) => string;
+/** `blog_post` → `Blog post`. What a label and a description read like. */
+export declare const sentenceCase: (name: string) => string;
+/**
+ * The plural of one lower-case word.
+ *
+ * Four ordinary English rules, plus one that leaves a word already ending in `s`
+ * alone so that `make:policy posts` is not a policy about `postses`. A genuine
+ * singular ending in `s` is caught by the first rule, which is why `status` becomes
+ * `statuses` rather than staying put.
+ *
+ * Nothing here knows that a person is people. An irregular plural is one word to fix
+ * in the generated file, and a dictionary of English exceptions inside a CLI is a
+ * promise it cannot keep — `model('people', …)` is the honest answer.
+ */
+export declare const pluralOf: (word: string) => string;
+/** The inverse, to the same standard: it decides a file name, never a table name. */
+export declare const singularOf: (word: string) => string;
+/** Registered in the order SPEC.md §77 lists them, which is the order they print in. */
+export declare const makeCommands: readonly CliCommand[];
+//# sourceMappingURL=make.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"make.d.ts","sourceRoot":"","sources":["../../src/commands/make.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,KAAK,UAAU,EAA2B,MAAM,gBAAgB,CAAA;AAsBzE,gCAAgC;AAChC,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,MAAiD,CAAA;AAE3F,gCAAgC;AAChC,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,MAG5B,CAAA;AAEb,0EAA0E;AAC1E,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,MAAiC,CAAA;AAE1E,2EAA2E;AAC3E,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,MAAiC,CAAA;AAE1E,2EAA2E;AAC3E,eAAO,MAAM,YAAY,SAAU,MAAM,KAAG,MAA8C,CAAA;AAE1F;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,SAAU,MAAM,KAAG,MAOvC,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,MAQzC,CAAA;AA+TD,wFAAwF;AACxF,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EA2C7C,CAAA"}