@assemora/cli 0.1.0

package/dist/commands/make.js

@@ -0,0 +1,393 @@
+/**
+ * `make:*` — the six generators of SPEC.md §77.
+ *
+ * A generated file is the first Assemora code most developers will ever read, so the
+ * bar is not "it saves typing": it is that the file compiles, runs, and shows the
+ * declaration the way the framework's own examples write it. A generator that emits
+ * code the framework rejects is worse than no generator, and
+ * `make.test.ts` compiles what these templates produce against the real packages
+ * rather than trusting them.
+ *
+ * The CLI writes source files against APIs it deliberately does not depend on —
+ * `@assemora/resources`, `@assemora/pages`, `@assemora/auth` (ADR-0021). That is a
+ * template problem rather than an architectural one: nothing here imports those
+ * packages, it only writes text that names them.
+ */
+import { mkdir, stat, writeFile } from 'node:fs/promises';
+import { dirname, join, relative } from 'node:path';
+import { ConflictError } from '@assemora/core';
+import { bool } from '../args.js';
+import { loadConfig } from '../config.js';
+import { detail, fail, ok, warn } from '../output.js';
+import { defineCommand, register } from '../registry.js';
+/**
+ * The words in a name, however it was typed.
+ *
+ * `BlogPost`, `blog_post`, `blog-post` and `blogPost` are the same three syllables,
+ * and a person typing at a terminal should not have to remember which spelling the
+ * generator wanted. Everything below is derived from these words, so all four
+ * spellings produce a byte-identical file.
+ */
+const wordsOf = (name) => name
+    // `BlogPost` → `Blog Post`, and `APIKey` → `API Key`: the second rule is what
+    // stops an acronym being split into one word per letter.
+    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+    .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+    .split(/[^a-zA-Z0-9]+/)
+    .filter((word) => word !== '')
+    .map((word) => word.toLowerCase());
+const capitalised = (word) => `${word.slice(0, 1).toUpperCase()}${word.slice(1)}`;
+/** `blog_post` → `BlogPost`. */
+export const pascalCase = (name) => wordsOf(name).map(capitalised).join('');
+/** `blog_post` → `blogPost`. */
+export const camelCase = (name) => wordsOf(name)
+    .map((word, index) => (index === 0 ? word : capitalised(word)))
+    .join('');
+/** `BlogPost` → `blog-post`. The form every generated file name takes. */
+export const kebabCase = (name) => wordsOf(name).join('-');
+/** `BlogPost` → `blog_post`. The form every generated table name takes. */
+export const snakeCase = (name) => wordsOf(name).join('_');
+/** `blog_post` → `Blog post`. What a label and a description read like. */
+export const sentenceCase = (name) => capitalised(wordsOf(name).join(' '));
+/**
+ * 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 const pluralOf = (word) => {
+    if (/(?:ss|us|is)$/.test(word))
+        return `${word}es`;
+    if (word.endsWith('s'))
+        return word;
+    if (/(?:x|z|ch|sh)$/.test(word))
+        return `${word}es`;
+    if (/[^aeiou]y$/.test(word))
+        return `${word.slice(0, -1)}ies`;
+    return `${word}s`;
+};
+/** The inverse, to the same standard: it decides a file name, never a table name. */
+export const singularOf = (word) => {
+    if (word.endsWith('ies'))
+        return `${word.slice(0, -3)}y`;
+    if (/(?:ss|us|is)$/.test(word))
+        return word;
+    if (/(?:x|z|ch|sh)es$/.test(word))
+        return word.slice(0, -2);
+    if (word.endsWith('ses'))
+        return word.slice(0, -2);
+    if (word.endsWith('s'))
+        return word.slice(0, -1);
+    return word;
+};
+/**
+ * Only the last word is inflected: `blog_post` pluralises to `blog posts`, never to
+ * `blogs posts`. The result is handed back space-separated, because every case
+ * helper re-reads it as words anyway.
+ */
+const inflectLast = (name, inflect) => {
+    const words = [...wordsOf(name)];
+    const last = words.at(-1);
+    if (last !== undefined)
+        words[words.length - 1] = inflect(last);
+    return words.join(' ');
+};
+const pluralName = (name) => inflectLast(name, pluralOf);
+const singularName = (name) => inflectLast(name, singularOf);
+/**
+ * Import lines are assembled rather than written out.
+ *
+ * `pnpm boundaries` reads source text and cannot tell a template apart from the code
+ * around it, so a template spelling out an import of the resource layer reads as this
+ * package importing it — the one thing the CLI must never do (ADR-0021). Composing
+ * the line keeps that check honest without changing a character of what reaches disk.
+ */
+const importFrom = (names, from) => `import { ${names.join(', ')} } from '${from}'`;
+/**
+ * A relative import carries the real `.ts` extension.
+ *
+ * Node 24 runs the TypeScript file directly and does not rewrite specifiers, so
+ * `../models/post.js` would name a file that never exists. `apps/playground` is
+ * written this way for the same reason; a project's tsconfig needs
+ * `allowImportingTsExtensions`.
+ */
+const fromSource = (directory, file) => `../${directory}/${file}.ts`;
+const isAlreadyExists = (error) => typeof error === 'object' && error !== null && error.code === 'EEXIST';
+const exists = async (path) => {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const write = async (file, shown, contents, force) => {
+    await mkdir(dirname(file), { recursive: true });
+    try {
+        // `wx` is what actually refuses, rather than a check followed by a write: two
+        // generators racing for the same path cannot then both believe they won.
+        await writeFile(file, contents, { encoding: 'utf8', flag: force ? 'w' : 'wx' });
+    }
+    catch (error) {
+        if (!isAlreadyExists(error))
+            throw error;
+        throw new ConflictError(`${shown} already exists. Pass --force to overwrite it.`);
+    }
+};
+const generate = async (spec, args, cwd) => {
+    const name = args.positionals[0];
+    // Checked before the config is loaded: a forgotten argument is a mistake in what
+    // was typed, and answering it with "no assemora.config.ts here" helps nobody.
+    if (name === undefined || wordsOf(name).length === 0) {
+        fail(`${spec.name} needs a name, for example: ${spec.example}`);
+        return 2;
+    }
+    const loaded = await loadConfig(cwd);
+    const generated = spec.plan(name);
+    const file = join(loaded.paths.source, generated.file);
+    const shown = relative(cwd, file) || file;
+    const force = bool(args, 'force');
+    // Asked before the write and reported after it, so that a write which failed does
+    // not leave behind a warning about work nobody did.
+    const replacing = force && (await exists(file));
+    await write(file, shown, generated.contents, force);
+    if (replacing)
+        warn(`${shown} existed already and was overwritten`);
+    // The path is the answer and goes to stdout, so `assemora make:model Post` can be
+    // piped into an editor; the next step is commentary and goes to stderr.
+    ok(shown);
+    detail(generated.nextStep);
+    return 0;
+};
+const generator = (spec) => defineCommand({
+    name: spec.name,
+    group: 'make',
+    summary: spec.summary,
+    usage: spec.usage,
+    handler: ({ args, cwd }) => generate(spec, args, cwd),
+});
+const modelFile = (name) => {
+    const model = pascalCase(singularName(name));
+    const table = snakeCase(pluralName(name));
+    return {
+        file: join('models', `${kebabCase(singularName(name))}.ts`),
+        nextStep: `Register it on a module with .models(${model}), then run \`assemora db:generate\`.`,
+        contents: `/**
+ * The ${model} model.
+ *
+ * One declaration is the record type, the database column, the runtime validation
+ * and every schema built from them — Studio's form, OpenAPI, the SDK and the MCP
+ * tool (SPEC.md §9, §17).
+ */
+${importFrom(['model', 'string', 'timestamp', 'uuid'], '@assemora/data')}
+
+export const ${model} = model('${table}', {
+  id: uuid().primary().defaultRandom(),
+  title: string(),
+  createdAt: timestamp().created(),
+  updatedAt: timestamp().updated(),
+})
+`,
+    };
+};
+const resourceFile = (name) => {
+    const model = pascalCase(singularName(name));
+    const collection = pascalCase(pluralName(name));
+    const modelFileName = kebabCase(singularName(name));
+    return {
+        file: join('resources', `${kebabCase(pluralName(name))}.ts`),
+        nextStep: `Register it on a module with .resources(${collection}).`,
+        contents: `/**
+ * The ${collection} resource.
+ *
+ * A resource presents a model rather than inventing data, so every field here names
+ * a column of ${model}, and only what is declared is ever returned — a column the
+ * resource never mentioned cannot leak into an API response (SPEC.md §35).
+ */
+${importFrom(['resource', 'text'], '@assemora/resources')}
+
+${importFrom([model], fromSource('models', modelFileName))}
+
+export const ${collection} = resource(
+  ${model},
+  {
+    title: text().required().searchable().sortable().label('Title'),
+  },
+  { label: '${sentenceCase(pluralName(name))}' },
+)
+`,
+    };
+};
+const blockFile = (name) => {
+    const block = pascalCase(name);
+    const type = kebabCase(name);
+    return {
+        file: join('blocks', `${type}.ts`),
+        nextStep: `Register it with pages({ blocks: [${block}] }).`,
+        contents: `/**
+ * The ${block} block.
+ *
+ * These fields are the Studio form, the runtime validation, the JSON Schema and what
+ * an agent is allowed to set — one declaration, never four (SPEC.md §55, §56).
+ */
+${importFrom(['block'], '@assemora/pages')}
+${importFrom(['text'], '@assemora/resources')}
+
+export const ${block} = block(
+  '${type}',
+  {
+    title: text().required().label('Title'),
+  },
+  { label: '${sentenceCase(name)}' },
+)
+`,
+    };
+};
+const moduleFile = (name) => {
+    const factory = camelCase(name);
+    const moduleName = kebabCase(name);
+    return {
+        file: join('modules', `${moduleName}.ts`),
+        // `assemora()`, not `createApplication()`: the project this same CLI scaffolds
+        // calls the umbrella in `src/app.ts` and contains the word `createApplication`
+        // nowhere at all, so the other name sends a reader looking for something that is
+        // not there (ADR-0022).
+        nextStep: `Register it with assemora({ modules: [${factory}()] }) in src/app.ts.`,
+        contents: `/**
+ * The ${moduleName} module.
+ *
+ * A module is the registration unit: models, resources, blocks, routes, commands and
+ * queries (SPEC.md §13). \`.models()\` and \`.resources()\` appear on the builder as
+ * soon as the packages that own them are imported — each contributes its own method
+ * rather than core learning what a model is (ADR-0009).
+ */
+${importFrom(['module'], '@assemora/core')}
+
+export const ${factory} = () => module('${moduleName}')
+`,
+    };
+};
+/**
+ * `posts.publish` names a command; the file is named after it.
+ *
+ * The last segment is the verb and the one before it is what the verb acts on, so
+ * `posts.publish` becomes `publish-post.ts` holding `PublishPost` — the file sorts
+ * beside the other things done to a post, and the export reads as the act. A name
+ * with no dot is taken as the verb alone.
+ */
+const commandFile = (name) => {
+    const segments = name
+        .split('.')
+        .map(camelCase)
+        .filter((segment) => segment !== '');
+    const verb = segments.at(-1) ?? camelCase(name);
+    const subject = segments.length > 1 ? (segments.at(-2) ?? '') : '';
+    const subjectWords = subject === '' ? '' : wordsOf(singularName(subject)).join(' ');
+    const definition = `${pascalCase(verb)}${subject === '' ? '' : pascalCase(singularName(subject))}`;
+    const fileName = subject === '' ? kebabCase(verb) : `${kebabCase(verb)}-${kebabCase(singularName(subject))}`;
+    const commandName = segments.join('.');
+    return {
+        file: join('commands', `${fileName}.ts`),
+        nextStep: `Register it on a module with .commands(${definition}).`,
+        contents: `/**
+ * The ${commandName} command.
+ *
+ * Every state change takes one path — validation, authorization, transaction,
+ * handler, revision, events, audit — and Studio, REST, the SDK, this CLI and an
+ * agent all arrive through it. The name is also the permission it requires
+ * (SPEC.md §14, ADR-0015).
+ */
+${importFrom(['command'], '@assemora/core')}
+${importFrom(['uuid'], '@assemora/schema')}
+
+export const ${definition} = command('${commandName}', {
+  description: '${sentenceCase(verb)}${subjectWords === '' ? '' : ` ${subjectWords}`}',
+  input: { id: uuid() },
+  output: { id: uuid() },
+  handle: async ({ id }, context) => {
+    context.logger.info('${commandName}', { id })
+
+    return { id }
+  },
+})
+`,
+    };
+};
+const policyFile = (name) => {
+    const subject = snakeCase(pluralName(name));
+    const definition = `${pascalCase(singularName(name))}Policy`;
+    return {
+        file: join('policies', `${kebabCase(pluralName(name))}.ts`),
+        nextStep: `Register it with auth({ policies: [${definition}] }).`,
+        contents: `/**
+ * Who may do what to ${wordsOf(subject).join(' ')}.
+ *
+ * The same answer is given to Studio, REST, the SDK, this CLI and an agent, because
+ * all of them arrive through the same buses: there is no trusted caller. A rule
+ * about a record is asked once the record has been read (SPEC.md §51, ADR-0015).
+ */
+${importFrom(['policy'], '@assemora/auth')}
+
+export const ${definition} = policy('${subject}', {
+  read: ({ can }) => can('${subject}.read'),
+  create: ({ can }) => can('${subject}.create'),
+  update: ({ can }) => can('${subject}.update'),
+  delete: ({ can }) => can('${subject}.delete'),
+})
+`,
+    };
+};
+/** Registered in the order SPEC.md §77 lists them, which is the order they print in. */
+export const makeCommands = [
+    generator({
+        name: 'make:model',
+        summary: 'a model and the table it maps to',
+        usage: 'assemora make:model <name> [--force]',
+        example: 'assemora make:model Post',
+        plan: modelFile,
+    }),
+    generator({
+        name: 'make:resource',
+        summary: 'a resource: how a model appears as content',
+        usage: 'assemora make:resource <name> [--force]',
+        example: 'assemora make:resource Post',
+        plan: resourceFile,
+    }),
+    generator({
+        name: 'make:block',
+        summary: 'a block for the page builder',
+        usage: 'assemora make:block <name> [--force]',
+        example: 'assemora make:block hero',
+        plan: blockFile,
+    }),
+    generator({
+        name: 'make:module',
+        summary: 'a module to register declarations in',
+        usage: 'assemora make:module <name> [--force]',
+        example: 'assemora make:module blog',
+        plan: moduleFile,
+    }),
+    generator({
+        name: 'make:command',
+        summary: 'a command for the Command Bus',
+        usage: 'assemora make:command <group.action> [--force]',
+        example: 'assemora make:command posts.publish',
+        plan: commandFile,
+    }),
+    generator({
+        name: 'make:policy',
+        summary: 'a policy for one subject',
+        usage: 'assemora make:policy <subject> [--force]',
+        example: 'assemora make:policy posts',
+        plan: policyFile,
+    }),
+];
+register(...makeCommands);
+//# sourceMappingURL=make.js.map

package/dist/commands/make.js.map

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

package/dist/commands/mcp.d.ts

@@ -0,0 +1,19 @@
+import { type McpEndpoint } from '../project.js';
+/** The environment variable the token arrives in, because a pipe carries no headers. */
+export declare const TOKEN_VARIABLE = "ASSEMORA_AGENT_TOKEN";
+export type McpSession = {
+    /** Defaults to `process.stdin`. */
+    readonly input?: NodeJS.ReadableStream;
+    /** Defaults to `process.stdout`. */
+    readonly output?: NodeJS.WritableStream;
+};
+/**
+ * Serves the endpoint until the input closes, and resolves when it has.
+ *
+ * Sequential on purpose. The protocol permits a client to have several requests in
+ * flight, and answering them in order costs a stdio client nothing — it is one process
+ * talking to one process — while concurrency here would put the ordering of two writes
+ * to one pipe in the hands of whichever handler finished first.
+ */
+export declare const serveMcp: (endpoint: McpEndpoint, token: string, session?: McpSession) => Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AAG7D,wFAAwF;AACxF,eAAO,MAAM,cAAc,yBAAyB,CAAA;AAEpD,MAAM,MAAM,UAAU,GAAG;IACvB,mCAAmC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;IACtC,oCAAoC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CACxC,CAAA;AAqBD;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,aACT,WAAW,SACd,MAAM,YACJ,UAAU,KAClB,OAAO,CAAC,IAAI,CAsCd,CAAA"}

package/dist/commands/mcp.js

@@ -0,0 +1,116 @@
+/**
+ * `assemora mcp` — the project's MCP endpoint, over a pipe (SPEC.md §68, §76).
+ *
+ * The application already speaks the protocol; what it lacked was the transport every
+ * client actually uses. Claude Code, Claude Desktop and Cursor start a process and talk
+ * to it over stdin and stdout, and until this existed the only way in was a bespoke
+ * `POST /api/mcp` that no such client knows how to reach.
+ *
+ * It reimplements nothing. The endpoint is the one `assemora()` built — the same
+ * generated tools, the same buses, the same seven checks of SPEC.md §76 — handed over by
+ * the project's own config, which is how this package drives a feature it may not import
+ * (ADR-0021).
+ *
+ * The framing is newline-delimited JSON, which is what the MCP stdio transport specifies:
+ * one message per line, and no message may contain a newline of its own. `JSON.stringify`
+ * escapes them, so that holds by construction.
+ */
+import { createInterface } from 'node:readline';
+import { ConfigurationError } from '@assemora/core';
+import { loadConfig } from '../config.js';
+import { detail } from '../output.js';
+import { loadProject } from '../project.js';
+import { defineCommand, register } from '../registry.js';
+/** The environment variable the token arrives in, because a pipe carries no headers. */
+export const TOKEN_VARIABLE = 'ASSEMORA_AGENT_TOKEN';
+/**
+ * A JSON-RPC error, as a message rather than as a thrown thing.
+ *
+ * A transport that dies on a malformed line takes the session with it, and a client
+ * that sent one bad message is owed an answer rather than a closed pipe. `-32700` is
+ * parse error and `-32603` is internal error, both from the JSON-RPC 2.0 specification.
+ */
+const failure = (id, code, message) => JSON.stringify({ jsonrpc: '2.0', id: id ?? null, error: { code, message } });
+/** The id of a message that may not have parsed, for the error to be addressed to. */
+const idOf = (line) => {
+    try {
+        return JSON.parse(line).id ?? null;
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Serves the endpoint until the input closes, and resolves when it has.
+ *
+ * Sequential on purpose. The protocol permits a client to have several requests in
+ * flight, and answering them in order costs a stdio client nothing — it is one process
+ * talking to one process — while concurrency here would put the ordering of two writes
+ * to one pipe in the hands of whichever handler finished first.
+ */
+export const serveMcp = async (endpoint, token, session = {}) => {
+    const input = session.input ?? process.stdin;
+    const output = session.output ?? process.stdout;
+    const lines = createInterface({ input, crlfDelay: Number.POSITIVE_INFINITY });
+    for await (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === '')
+            continue;
+        let message;
+        try {
+            message = JSON.parse(trimmed);
+        }
+        catch {
+            output.write(`${failure(null, -32_700, 'That line is not JSON')}\n`);
+            continue;
+        }
+        try {
+            const answered = await endpoint.handle(message, { token });
+            // A notification is answered by not answering, and writing an empty line for one
+            // is how a client comes to read a reply it never asked for.
+            if (answered !== undefined)
+                output.write(`${JSON.stringify(answered)}\n`);
+        }
+        catch (error) {
+            // Reported to the client rather than thrown: a refused message is one message,
+            // and the session is still good. What went wrong goes to stderr, which is not
+            // the protocol's channel and is where a client shows a server's own output.
+            const reason = error instanceof Error ? error.message : String(error);
+            detail(reason);
+            output.write(`${failure(idOf(trimmed), -32_603, reason)}\n`);
+        }
+    }
+    input.pause();
+};
+const mcpCommand = async ({ cwd }) => {
+    // Loaded before the token is looked for, and the order is the whole point: a project
+    // reads its own `.env` as it is imported — that is what makes one file serve `dev`,
+    // `db:migrate` and everything else — so a token kept there is not in the environment
+    // until this line has run. Asked for first, this command told a developer that
+    // `ASSEMORA_AGENT_TOKEN` was unset while they were looking at it in `.env`.
+    const loaded = await loadConfig(cwd);
+    const project = await loadProject(loaded);
+    const token = process.env[TOKEN_VARIABLE];
+    if (token === undefined || token.trim() === '') {
+        throw new ConfigurationError(`${TOKEN_VARIABLE} is not set, and an MCP session is somebody. Put it in .env, or ` +
+            'run `assemora agents:create <name> --permissions … --write-mcp-json`, which ' +
+            'creates the identity and writes both — an anonymous caller reaches every tool ' +
+            'with no permissions at all, which is a confusing way to be refused.');
+    }
+    if (project.mcp === undefined) {
+        throw new ConfigurationError(`${loaded.file}: this project has no MCP endpoint. Assemble the application with ` +
+            'assemora({ mcp: true }) and have the config return it whole — `app: () => ' +
+            'createApp()` rather than `createApp().app`, which drops the half that speaks ' +
+            'the protocol.');
+    }
+    await serveMcp(project.mcp, token.trim());
+    return 0;
+};
+register(defineCommand({
+    name: 'mcp',
+    group: 'run',
+    summary: 'serve this project to an agent over stdin and stdout',
+    usage: 'assemora mcp',
+    handler: mcpCommand,
+}));
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

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

package/dist/commands/new.d.ts

@@ -0,0 +1,20 @@
+import { type ParsedArgs } from '../args.js';
+/** Exactly what `scaffold()` in `create-assemora` accepts. */
+export type ScaffoldOptions = {
+    readonly name: string;
+    readonly directory: string;
+    readonly database?: string;
+    readonly studio?: boolean;
+    readonly pages?: boolean;
+    readonly mcp?: boolean;
+    readonly template?: string;
+};
+/**
+ * argv, as the scaffolder's options.
+ *
+ * The name is not validated beyond being present. What makes a legal project name is
+ * `create-assemora`'s question — it is the thing that writes the directory and the
+ * `package.json` — and answering it twice is how the two would come to disagree.
+ */
+export declare const scaffoldOptions: (name: string, args: ParsedArgs, cwd: string) => ScaffoldOptions;
+//# sourceMappingURL=new.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AAIxD,8DAA8D;AAC9D,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAqBD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,SAAU,MAAM,QAAQ,UAAU,OAAO,MAAM,KAAG,eAc7E,CAAA"}

package/dist/commands/new.js

@@ -0,0 +1,83 @@
+/**
+ * `assemora new <name>` — the convenience, not a second scaffolder (SPEC.md §78).
+ *
+ * `pnpm create assemora my-project` is the primary way a project starts, and this
+ * command runs the same `scaffold()` it does. Nothing about the layout of a
+ * generated project is decided here: a second implementation would drift from the
+ * starter the moment either changed, and the starter is the one CI typechecks
+ * (ADR-0021).
+ *
+ * What this file owns is the translation from argv to that function's options, and
+ * the defaults SPEC.md §78 fixes — Studio, Pages and MCP are all in unless the
+ * invocation says otherwise.
+ */
+import { relative, resolve } from 'node:path';
+import { scaffold } from 'create-assemora';
+import { bool, flag } from '../args.js';
+import { fail, line, ok } from '../output.js';
+import { defineCommand, register } from '../registry.js';
+/**
+ * Whether an optional part of the starter is included.
+ *
+ * SPEC.md §78 makes all three default to yes, so the question here is only whether
+ * the invocation turned one off. Both spellings are accepted because both get typed:
+ * `--no-studio` is what a person writes, and `--studio=false` is what a script does.
+ */
+const included = (args, name) => {
+    if (args.flags[`no-${name}`] !== undefined)
+        return !bool(args, `no-${name}`);
+    if (args.flags[name] !== undefined)
+        return bool(args, name);
+    return true;
+};
+/**
+ * argv, as the scaffolder's options.
+ *
+ * The name is not validated beyond being present. What makes a legal project name is
+ * `create-assemora`'s question — it is the thing that writes the directory and the
+ * `package.json` — and answering it twice is how the two would come to disagree.
+ */
+export const scaffoldOptions = (name, args, cwd) => {
+    const directory = flag(args, 'directory');
+    const database = flag(args, 'database');
+    const template = flag(args, 'template');
+    return {
+        name,
+        directory: resolve(cwd, directory ?? name),
+        ...(database === undefined ? {} : { database }),
+        ...(template === undefined ? {} : { template }),
+        studio: included(args, 'studio'),
+        pages: included(args, 'pages'),
+        mcp: included(args, 'mcp'),
+    };
+};
+const runScaffold = async (options) => scaffold(options);
+/** An absolute path is a poor thing to type; a relative one is what `cd` wants. */
+const shortest = (from, directory) => {
+    const step = relative(from, directory);
+    return step === '' || step.startsWith('..') ? directory : step;
+};
+const create = async ({ args, cwd }) => {
+    const name = args.positionals[0];
+    if (name === undefined || name.trim() === '') {
+        fail('`assemora new` needs a name for the project: `assemora new my-project`.');
+        return 2;
+    }
+    const options = scaffoldOptions(name, args, cwd);
+    const created = await runScaffold(options);
+    ok(`Created ${options.name}: ${created.files.length} files in ${created.directory}`);
+    line();
+    line('Next');
+    line(`  cd ${shortest(cwd, created.directory)}`);
+    line('  pnpm install');
+    line('  assemora dev');
+    return 0;
+};
+register(defineCommand({
+    name: 'new',
+    group: 'project',
+    summary: 'scaffold a new project',
+    usage: 'assemora new <name> [--directory <path>] [--database <url>] [--template <name>] [--no-studio] [--no-pages] [--no-mcp]',
+    handler: create,
+}));
+//# sourceMappingURL=new.js.map