@endora-commerce/cli 0.100.0

package/dist/generate/index.js

@@ -0,0 +1,369 @@
+/**
+ * `endora generate` — the artefacts an instance builds from and commits none of
+ * (`contracts/instance-repository.md` R3.2, `contracts/instance-tree.md` §2.6).
+ *
+ * ## Why the command exists
+ *
+ * An instance's admin project holds six files and imports two it does not have:
+ * the contribution registry `main.tsx` hands the shell, and the stylesheet
+ * enumeration `index.css` imports. Both are **facts about the process** — which
+ * packages this client installed — so R3.1 says they are resolved at build time
+ * and never committed, and R3.2 says Vite and Tailwind are static, so they have
+ * to exist as files before either runs.
+ *
+ * Until this command existed the renderer lived in `backend/scripts`, which no
+ * client can reach: the file manifest §2.4 writes was a tree that could not be
+ * built. The renderer is `../lib/admin-artefacts.js`' now and is the **same**
+ * program `composer:generate` runs over this repository's workspace members —
+ * R3.5's *"one generator, one derivation … never a second implementation"*.
+ *
+ * ## It reports what it excluded (R8.2)
+ *
+ * A `link:`, a `file:` and a workspace member are invisible to the platform's
+ * runtime discovery by design (§8 R8.1), and these artefacts apply the same
+ * rule because they must: *"an admin registry naming a module the backend will
+ * not compose is a nav entry that 404s"*. So every exclusion is printed with the
+ * package name and the real path it resolved to. A module that is simply not
+ * there is indistinguishable from a module nobody installed, and a client whose
+ * screen never appeared has nothing to read.
+ *
+ * ## Exit codes are `cli-surface.md` §2's, unchanged
+ *
+ * **0** it did what it was asked, **1** a refusal the operator can act on, **2**
+ * an input it could not read. An instance with no admin member is **1** and
+ * names the remedy; a directory that is no workspace at all is **2**, because a
+ * run that could not find the tree it was pointed at has said nothing.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+import { adminRegistryOutputPathIn, collectAdminContributions, collectTailwindSources, emitAdminRegistry, emitTailwindRegistry, tailwindRegistryOutputPathIn, } from '../lib/admin-artefacts.js';
+import { AdminLayoutUnresolvableError } from '../lib/admin-surfaces.js';
+import { collectEntityIndexEntries, emitEntityIndex, entityIndexOutputPathIn, } from '../lib/entity-index-artefact.js';
+import { collectDocsIntoSiteFrom, docsRegistryOf, installedDocsModules, renderDocsSidebarFrom, renderModuleMapFrom, renderModuleReferencesFrom, } from '../lib/docs-artefacts.js';
+import { DocsLayoutUnresolvableError, resolveDocsLayout } from '../lib/module-docs.js';
+import { scanInstalledModulePackages, } from '../lib/module-packages.js';
+import { renderInstanceDivergence, DivergenceHostError, } from './divergence.js';
+/** A refusal the operator can act on — exit 1. */
+export class GenerateInputError extends Error {
+    name = 'GenerateInputError';
+}
+/** An input this run could not read — exit 2. */
+export class GenerateHostError extends Error {
+    name = 'GenerateHostError';
+}
+/**
+ * The instance root: the nearest directory above `from` holding a
+ * `pnpm-workspace.yaml`.
+ *
+ * Upwards, so the command works from the admin member as well as from the root
+ * — `pnpm -C admin run generate` runs it with the member as its working
+ * directory, and a client typing it in the directory they are editing is the
+ * ordinary case.
+ */
+export function findInstanceRoot(from) {
+    let current = resolve(from);
+    for (;;) {
+        if (existsSync(join(current, 'pnpm-workspace.yaml')))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+/**
+ * Render the instance's build artefacts, and write them unless this is a dry
+ * run.
+ *
+ * Every artefact is rendered **before** any is written, in `new instance`'s own
+ * discipline (R5.2): a half-written pair is a bundle that names modules the
+ * stylesheet did not scan, which is the silent failure
+ * `admin-stylesheet-composition.md` exists to remove.
+ */
+export async function runGenerate(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const root = findInstanceRoot(cwd);
+    if (root === null) {
+        throw new GenerateHostError(`no \`pnpm-workspace.yaml\` above ${cwd}, so there is no instance to render artefacts ` +
+            `for. This command renders the files an instance's admin project and documentation ` +
+            `site are built from; run it inside the tree \`endora new instance\` wrote.`);
+    }
+    const scan = scanInstalledModulePackages(root);
+    if (scan.root === null) {
+        throw new GenerateHostError(`${join(root, 'node_modules')} is not there, so which modules this instance installed ` +
+            `cannot be read and the artefacts would name none. Run \`pnpm install\` first — an ` +
+            `empty registry is a bundle with no screens in it, rendered without an error.`);
+    }
+    const artefacts = [];
+    const omitted = [];
+    // --- the admin project's two (§2.6) --------------------------------------
+    //
+    // The project is found through the `"@/*"` tsconfig alias, exactly as every
+    // other admin derivation in this estate finds it. A workspace with no such
+    // member is an instance with no admin project, which is an **omission** and
+    // not a refusal: `endora new instance` writes one only when the shell and the
+    // design system resolve, so a headless instance is a tree this command must
+    // still be able to serve.
+    try {
+        const contributions = collectAdminContributions(scan.packages);
+        const sources = collectTailwindSources(root, scan.packages);
+        artefacts.push({
+            path: adminRegistryOutputPathIn(root),
+            content: emitAdminRegistry(contributions, GENERATED_REGISTRY_HEADER),
+            label: `the admin contribution registry (${String(contributions.length)} module(s))`,
+        }, {
+            path: tailwindRegistryOutputPathIn(root),
+            content: emitTailwindRegistry(sources, GENERATED_STYLESHEET_HEADER),
+            label: `the admin stylesheet enumeration (${String(sources.length)} package(s))`,
+        });
+    }
+    catch (error) {
+        if (!(error instanceof AdminLayoutUnresolvableError))
+            throw error;
+        omitted.push(`the admin project's two artefacts — ${error.message}. They land in the source root of ` +
+            `the workspace member declaring the \`"@/*"\` path its tsconfig carries, so an instance ` +
+            `scaffolded without an admin member has nothing here to write`);
+    }
+    // --- the documentation site's (§2.6, feature 100) -------------------------
+    //
+    // The site is found by the workspace member holding a Docusaurus
+    // configuration — the same derivation `check:module-docs` and
+    // `composer:generate` share — and the population is the packages above, so a
+    // navigation names exactly the modules this client installed. Same omission
+    // discipline as the admin half.
+    let collected = null;
+    let swept = [];
+    try {
+        const layout = resolveDocsLayout(root);
+        const registry = docsRegistryOf(layout, installedDocsModules(scan.packages), scan.packages);
+        artefacts.push({
+            path: renderDocsSidebarFrom(registry, INSTANCE_DOCS_HEADER).outputPath,
+            content: renderDocsSidebarFrom(registry, INSTANCE_DOCS_HEADER).content,
+            label: `the documentation navigation (${String(registry.entries.length)} module(s))`,
+        }, {
+            path: renderModuleMapFrom(registry, INSTANCE_DOCS_PAGE_HEADER).outputPath,
+            content: renderModuleMapFrom(registry, INSTANCE_DOCS_PAGE_HEADER).content,
+            label: 'the module map',
+        });
+        // `stray: 'sweep'` because in an instance this category is generated and
+        // git-ignored: a module the client uninstalled would otherwise leave a page
+        // that refuses every subsequent run, with a remedy (`git rm`) naming a tool
+        // the file is not under.
+        const references = await renderModuleReferencesFrom(registry, {
+            header: INSTANCE_DOCS_PAGE_HEADER,
+            stray: options.dryRun === true ? 'report' : 'sweep',
+        });
+        for (const page of references.pages) {
+            artefacts.push({ path: page.outputPath, content: page.content, label: page.label });
+        }
+        swept = references.swept;
+        // The copies are a filesystem operation rather than a rendered artefact —
+        // a module's page is copied verbatim, byte for byte — so it is not in the
+        // list above and is skipped on a dry run with everything else.
+        if (options.dryRun !== true)
+            collected = collectDocsIntoSiteFrom(registry);
+    }
+    catch (error) {
+        if (!(error instanceof DocsLayoutUnresolvableError))
+            throw error;
+        omitted.push(`the documentation site's artefacts — ${error.message}. The site is the workspace member ` +
+            `holding a Docusaurus configuration; an instance scaffolded without one has nothing ` +
+            `here to write`);
+    }
+    // --- the entity index (§2.6, feature 109 T065) ----------------------------
+    //
+    // Last of the `.gitignore`d three-become-four, and the only one that belongs
+    // to **no member**: its consumer is a test, and a test is not a member of a
+    // client's workspace. So it is rendered whenever this host installed a module
+    // at all, with no omission branch above it to fall into — there is no
+    // directory it needs and nothing about it that can be absent.
+    //
+    // **Why every instance gets it, including one that runs no test.** The
+    // population is *which modules this host installed*, which is §2.6's own
+    // predicate for a generated artefact, and it is the one fact
+    // `@endora-commerce/test-kit` may not know (109 R2.2, FR-001). A client who
+    // writes no test never imports the file and it is git-ignored, so the cost is
+    // one small file; the alternative is a flag nobody asked for, and a repository
+    // built on published packages — `specs/134-paid-module-extraction/` T018's
+    // host is the first — could write no server-bound test at all without it.
+    if (scan.packages.length > 0) {
+        const entries = collectEntityIndexEntries(scan.packages);
+        artefacts.push({
+            path: entityIndexOutputPathIn(root),
+            content: emitEntityIndex(entries, INSTANCE_ENTITY_INDEX_HEADER),
+            label: `the test entity index (${String(entries.length)} module(s))`,
+        });
+    }
+    // --- the deployment's own (§2.2, feature 107) ---------------------------
+    //
+    // Not an `artefacts.push`, and the difference is the whole of the report
+    // contract's §1: those three are `.gitignore`d facts about *this install* and
+    // these are a committed fact about the client's own tree. Rendering them in
+    // the same run is right — one walk of `node_modules` answers both — but
+    // mixing them into one list would put a committed artefact under a header
+    // telling its reader not to commit it.
+    //
+    // A deployment tree that is not there is an omission and not a refusal, in the
+    // discipline the two members above already use: `endora new instance` writes
+    // `apps/<deployment>/`, and a client who deleted it has said something.
+    let divergence = [];
+    try {
+        divergence = renderInstanceDivergence({ root, packages: scan.packages });
+        if (divergence.length === 0) {
+            omitted.push(`the divergence report — this instance has no \`apps/<deployment>/\` tree, so there is ` +
+                `no deployment whose divergence from core could be derived. \`endora new instance\` ` +
+                `writes one`);
+        }
+    }
+    catch (error) {
+        if (!(error instanceof DivergenceHostError))
+            throw error;
+        // Exit 2, never a silent skip: the report's own §5 is one refusal per input
+        // whose absence would make a predicate vacuously clean, and every one of
+        // this half's inputs is of that kind — an unread composition reports every
+        // decoration as owned by nobody.
+        throw new GenerateHostError(error.message);
+    }
+    // No member and no deployment is a workspace this command has anything to do
+    // with, and a run that wrote nothing and said it succeeded is the silent green
+    // the whole estate refuses. It is a refusal the operator can act on — exit 1 —
+    // because the remedy is theirs: scaffold a member, or stop running this.
+    //
+    // The divergence half counts toward "it rendered something": a headless
+    // instance with a deployment tree is a tree this command still has an answer
+    // for, and refusing it would be the command declining to describe the one
+    // thing about that tree a client is asked to trust.
+    //
+    // **The entity index counts too, and that narrows this refusal rather than
+    // weakening it** (T065). Its reason is *a run that wrote nothing and said it
+    // succeeded*, so what it may fire on is an empty `artefacts` — and a host with
+    // a module installed now has one entry there whatever its members are. The
+    // state that remains is a workspace with no member, no deployment **and no
+    // module**, which is a directory this command genuinely has nothing to say
+    // about. The message names that third condition rather than continuing to
+    // claim the first two are the whole of it.
+    if (artefacts.length === 0 && divergence.length === 0) {
+        throw new GenerateInputError(`${root} has no admin project, no documentation site, no \`apps/<deployment>/\` tree and ` +
+            `no installed module package, so this command has nothing to render:\n` +
+            `${omitted.map((reason) => `  - ${reason}`).join('\n')}\n` +
+            `  - the test entity index — ${scan.packages.length === 0
+                ? 'no `@endora-commerce/*` module package is installed, so the index would name none'
+                : 'rendered'}`);
+    }
+    if (options.dryRun !== true) {
+        for (const artefact of artefacts) {
+            mkdirSync(dirname(artefact.path), { recursive: true });
+            writeFileSync(artefact.path, artefact.content, 'utf8');
+        }
+        for (const report of divergence) {
+            for (const rendering of report.renderings) {
+                mkdirSync(dirname(rendering.outputPath), { recursive: true });
+                writeFileSync(rendering.outputPath, rendering.content, 'utf8');
+            }
+        }
+    }
+    return {
+        root,
+        artefacts,
+        modules: scan.packages.length,
+        excluded: scan.skipped,
+        omitted,
+        collected,
+        swept,
+        divergence,
+        dryRun: options.dryRun === true,
+    };
+}
+/** The lines the command prints, in order. Exported so a proof reads them. */
+export function generateReport(result) {
+    const lines = result.artefacts.map((artefact) => `${result.dryRun ? 'would write' : 'wrote'} ${relative(result.root, artefact.path)} — ` +
+        `${artefact.label}`);
+    if (result.swept.length > 0) {
+        lines.push(`removed ${String(result.swept.length)} module reference page(s) no installed module ` +
+            `renders any more`);
+    }
+    for (const report of result.divergence) {
+        for (const rendering of report.renderings) {
+            lines.push(`${result.dryRun ? 'would write' : 'wrote'} ` +
+                `${relative(result.root, rendering.outputPath)} — ${rendering.label} ` +
+                `(${String(report.overlayModules.length)} overlay module(s), ` +
+                `${String(report.entries)} divergence(s)). Commit it: it is a fact about your tree`);
+        }
+        // The generator writes the artefact whatever it found, exactly as this
+        // repository's does; a finding is something the client can act on and the
+        // person running this is the person who can.
+        for (const finding of report.findings) {
+            lines.push(`  [${finding.kind}] ${finding.where}: ${finding.detail}`);
+        }
+        // Never folded into "declares nothing": an absent declaration and one this
+        // run could not read are the same answer only if you let them be.
+        for (const field of report.unresolvedDeclaration) {
+            lines.push(`  [unreadable-declaration] ${report.deployment}: ${field} is not written as a literal, ` +
+                `so this report was derived as though it were absent`);
+        }
+    }
+    if (result.collected !== null) {
+        lines.push(`copied ${String(result.collected.copied.length)} module-owned page(s) into ` +
+            `${result.collected.modulesRoot}` +
+            (result.collected.removed.length === 0
+                ? ''
+                : `, removing ${String(result.collected.removed.length)} the previous run wrote`));
+    }
+    // A member this instance does not have is named, never silently skipped:
+    // a client who does not know a surface is missing goes looking for it.
+    for (const reason of result.omitted)
+        lines.push(`omitted ${reason}`);
+    // R8.2 — the exclusion is said out loud. A module that is simply not there is
+    // indistinguishable from a module nobody installed.
+    for (const skipped of result.excluded) {
+        lines.push(skipped.kind === 'links-out-of-node-modules'
+            ? `excluded ${skipped.name} — links-out-of-node-modules, real path ${skipped.realPath}. ` +
+                `A linked package is invisible to this instance's runtime discovery too, so an ` +
+                `artefact naming it would register a screen the backend never composes. Develop it ` +
+                `as an overlay module under \`apps/<deployment>/modules/\`, or \`pnpm pack\` it and ` +
+                `install the tarball.`
+            : `excluded ${skipped.at} — unreadable: ${skipped.reason}`);
+    }
+    return lines;
+}
+/** Is this instance's admin registry the same as the one on disk? */
+export function artefactIsCurrent(artefact) {
+    if (!existsSync(artefact.path))
+        return false;
+    return readFileSync(artefact.path, 'utf8') === artefact.content;
+}
+/**
+ * The "do not edit" header the documentation artefacts carry in an instance.
+ *
+ * A separate value from the registry's because the comment syntax differs — a
+ * `.js` sidebar fragment and a markdown page — and separate from
+ * `composer:generate`'s because the two hosts tell a reader different things to
+ * run. An artefact naming `composer:generate` would send a client to a script
+ * their tree does not have.
+ */
+const INSTANCE_DOCS_HEADER = `// AUTO-GENERATED by \`endora generate\` — DO NOT EDIT, and do not commit.\n` +
+    `// It names the module packages THIS instance installed, so it is a fact about\n` +
+    `// the install and not about the tree. \`.gitignore\` covers it;\n` +
+    `// \`pnpm run generate\` rewrites it.\n`;
+/** The same, for a markdown page, whose comment syntax is HTML's. */
+const INSTANCE_DOCS_PAGE_HEADER = `<!-- AUTO-GENERATED by \`endora generate\` — DO NOT EDIT, and do not commit.\n` +
+    `     It names the module packages THIS instance installed, so it is a fact\n` +
+    `     about the install and not about the tree. \`.gitignore\` covers it;\n` +
+    `     \`pnpm run generate\` rewrites it. -->`;
+/** The "do not edit" header an instance's artefacts carry. */
+const GENERATED_REGISTRY_HEADER = `// AUTO-GENERATED by \`endora generate\` — DO NOT EDIT, and do not commit.\n` +
+    `// It names the module packages THIS instance installed, so it is a fact about\n` +
+    `// the install and not about the tree: a different module set is a different\n` +
+    `// bundle. \`.gitignore\` covers it; \`pnpm run generate\` rewrites it.\n`;
+/** The same, for the entity index, whose staleness is a test asking about no table. */
+const INSTANCE_ENTITY_INDEX_HEADER = `// AUTO-GENERATED by \`endora generate\` — DO NOT EDIT, and do not commit.\n` +
+    `// It names the module packages THIS instance installed, so it is a fact about\n` +
+    `// the install and not about the tree. \`.gitignore\` covers it;\n` +
+    `// \`pnpm run generate\` rewrites it, and a stale index is a test asking the ORM\n` +
+    `// about a table nothing mapped.\n`;
+/** The same, for the stylesheet, whose comment syntax is CSS's. */
+const GENERATED_STYLESHEET_HEADER = `/* AUTO-GENERATED by \`endora generate\` — DO NOT EDIT, and do not commit.\n` +
+    ` * It names the packages THIS instance installed, so it is a fact about the\n` +
+    ` * install and not about the tree. \`.gitignore\` covers it; \`pnpm run generate\`\n` +
+    ` * rewrites it.\n`;
+//# sourceMappingURL=index.js.map

package/dist/generate/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `@endora-commerce/cli` — the programmatic surface of the `endora` command.
+ *
+ * The argv layer is `src/bin/endora.ts` and is deliberately not exported: a
+ * caller that wants the scaffold wants {@link runNewModule}, not a parser.
+ */
+export { runNewModule, type NewModuleOptions, type NewModuleResult, } from './new-module/index.js';
+export { bundleEntries, emitModuleFiles, entityClassOf, entityFileOf, migrationClassOf, migrationFileOf, portInterfaceOf, portNameOf, tableNameOf, type EmittedFile, } from './new-module/emit.js';
+export { BASELINE_THROUGH, buildScaffoldSpec, camelOf, camelOfActionId, formatStamp, manifestObjectFor, migrationStampFor, npmNameFor, pascalOf, ScaffoldHostError, ScaffoldInputError, segmentOf, slugOf, TENANT_SCOPE_DECORATORS, TENANT_SCOPES, type ModuleScaffoldSpec, type ScaffoldAction, type ScaffoldActivation, type ScaffoldInput, type ScaffoldLayers, type ScaffoldPermission, type TenantScope, } from './new-module/spec.js';
+export { defaultModulesRootOf, findRepoRoot, resolveHost, workspaceGlobs, workspaceScopeOf, type ScaffoldHost, } from './new-module/host.js';
+export { runNewInstance, type NewInstanceOptions, type NewInstanceResult, } from './new-instance/index.js';
+export { assertTopology, deployFiles, DEFAULT_TOPOLOGY, TOPOLOGIES, type DeployFile, type DeployInput, type Topology, } from './new-instance/deploy.js';
+export { InstanceHostError, InstanceInputError, resolveInstanceHost, scopeOfPackageName, type InstanceHost, type ResolvedPackage, } from './new-instance/host.js';
+export { loadModuleCandidates, requiredModuleIds, resolveModuleSet, type ModuleCandidate, type ModuleSetResolution, } from './new-instance/modules.js';
+export { assertDeploymentName, assertWorkspaceName, devDependenciesFor, envExample, GENERATED_ARTEFACTS, GENERATED_TREES, planInstance, wiringLineCount, type FileKind, type InstancePlan, type MemberName, type PlanInput, type PlannedFile as PlannedInstanceFile, type PlannedOmission, } from './new-instance/template.js';
+export { artefactIsCurrent, findInstanceRoot, generateReport, GenerateHostError, GenerateInputError, runGenerate, type GeneratedArtefact, type GenerateOptions, type GenerateResult, } from './generate/index.js';
+export { runNewStorefront, storefrontDeclaredInputs, type NewStorefrontOptions, type NewStorefrontResult, } from './new-storefront/index.js';
+export { flagFor } from './inputs/resolve.js';
+export { parseEnvFile, renderEnvValue, writeEnvFile } from './inputs/env-file.js';
+export { addressVariables, backendAddressVariablesOf, declaredVariablesOf, storefrontAddressVariablesOf, STOREFRONT_DECLARATION_EXPORT, ENV_EXAMPLE_FILE, envExampleDeclarations, envExampleDeclarationsOf, outwardReferences, resolveReference, StorefrontHostError, StorefrontInputError, trackedFiles, workspaceRanges, type OutwardReference, type StorefrontReference, type WorkspaceRange, } from './new-storefront/reference.js';
+export { authKeys, installedScopes, normalizeRegistry, npmrcContent, TOKEN_VARIABLE, } from './new-storefront/npmrc.js';
+export { cutForeignImports, cutForeignJsonPaths, packageManagerFor, planStorefront, publishedRange, retargetPackageGlob, testRoots, UnclassifiedReferenceError, type PlannedFile, type PlanOptions, type RangeRewrite, type StorefrontPlan, } from './new-storefront/rewrite.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,35 @@
+/**
+ * `@endora-commerce/cli` — the programmatic surface of the `endora` command.
+ *
+ * The argv layer is `src/bin/endora.ts` and is deliberately not exported: a
+ * caller that wants the scaffold wants {@link runNewModule}, not a parser.
+ */
+export { runNewModule, } from './new-module/index.js';
+export { bundleEntries, emitModuleFiles, entityClassOf, entityFileOf, migrationClassOf, migrationFileOf, portInterfaceOf, portNameOf, tableNameOf, } from './new-module/emit.js';
+export { BASELINE_THROUGH, buildScaffoldSpec, camelOf, camelOfActionId, formatStamp, manifestObjectFor, migrationStampFor, npmNameFor, pascalOf, ScaffoldHostError, ScaffoldInputError, segmentOf, slugOf, TENANT_SCOPE_DECORATORS, TENANT_SCOPES, } from './new-module/spec.js';
+export { defaultModulesRootOf, findRepoRoot, resolveHost, workspaceGlobs, workspaceScopeOf, } from './new-module/host.js';
+export { runNewInstance, } from './new-instance/index.js';
+// The deployment examples' two axes. `Topology` is exported because `PlanInput`
+// carries one and a caller that cannot name the type cannot build the input;
+// `TOPOLOGIES` and `assertTopology` are exported because a caller offering the
+// flag needs the vocabulary and the refusal rather than a second copy of both.
+export { assertTopology, deployFiles, DEFAULT_TOPOLOGY, TOPOLOGIES, } from './new-instance/deploy.js';
+export { InstanceHostError, InstanceInputError, resolveInstanceHost, scopeOfPackageName, } from './new-instance/host.js';
+export { loadModuleCandidates, requiredModuleIds, resolveModuleSet, } from './new-instance/modules.js';
+export { assertDeploymentName, assertWorkspaceName, devDependenciesFor, envExample, GENERATED_ARTEFACTS, GENERATED_TREES, planInstance, wiringLineCount, } from './new-instance/template.js';
+export { artefactIsCurrent, findInstanceRoot, generateReport, GenerateHostError, GenerateInputError, runGenerate, } from './generate/index.js';
+export { runNewStorefront, storefrontDeclaredInputs, } from './new-storefront/index.js';
+// The flag spelling is derived from the variable's name and never written down,
+// so a caller that builds an `endora new storefront` command line takes the
+// derivation rather than re-deriving it — see `storefrontDeclaredInputs`.
+export { flagFor } from './inputs/resolve.js';
+// The `.env` writer, exported for the one caller outside this package that has
+// to put a value into a scaffolded tree's own configuration: the instance
+// acceptance criterion, which fills the file `endora new instance` wrote exactly
+// as a client would. A second merge implementation there would be a second set
+// of rules about quoting, blank values and the operator's own lines.
+export { parseEnvFile, renderEnvValue, writeEnvFile } from './inputs/env-file.js';
+export { addressVariables, backendAddressVariablesOf, declaredVariablesOf, storefrontAddressVariablesOf, STOREFRONT_DECLARATION_EXPORT, ENV_EXAMPLE_FILE, envExampleDeclarations, envExampleDeclarationsOf, outwardReferences, resolveReference, StorefrontHostError, StorefrontInputError, trackedFiles, workspaceRanges, } from './new-storefront/reference.js';
+export { authKeys, installedScopes, normalizeRegistry, npmrcContent, TOKEN_VARIABLE, } from './new-storefront/npmrc.js';
+export { cutForeignImports, cutForeignJsonPaths, packageManagerFor, planStorefront, publishedRange, retargetPackageGlob, testRoots, UnclassifiedReferenceError, } from './new-storefront/rewrite.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,YAAY,GAGb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,UAAU,EACV,WAAW,GAEZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,MAAM,EACN,uBAAuB,EACvB,aAAa,GAQd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,gBAAgB,GAEjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,GAGf,MAAM,yBAAyB,CAAC;AACjC,gFAAgF;AAChF,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAC/E,OAAO,EACL,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,UAAU,GAIX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GAGnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GAGjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,eAAe,GAOhB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,GAIZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GAGzB,MAAM,2BAA2B,CAAC;AACnC,gFAAgF;AAChF,4EAA4E;AAC5E,0EAA0E;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,+EAA+E;AAC/E,0EAA0E;AAC1E,iFAAiF;AACjF,+EAA+E;AAC/E,qEAAqE;AACrE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,EACnB,4BAA4B,EAC5B,6BAA6B,EAC7B,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,eAAe,GAIhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,0BAA0B,GAK3B,MAAM,6BAA6B,CAAC"}

package/dist/inputs/declaration.d.ts

@@ -0,0 +1,18 @@
+import { type EnvironmentInput } from '@endora-commerce/contracts';
+/** The file every application-level declaration is named, in every tree. */
+export declare const DECLARATION_FILE = "environment-inputs.mjs";
+/** Raised when a tree's declaration is absent or is not one. Exit 2's shape. */
+export declare class DeclarationLoadError extends Error {
+    readonly name = "DeclarationLoadError";
+}
+/**
+ * The declaration a tree ships, or a refusal.
+ *
+ * **Absent is a refusal, never "this tree needs nothing"**, which is the failure
+ * `manifest-locations.ts` was written to end one surface over: a command that
+ * read a missing declaration as an empty one would write a `.env` holding
+ * nothing, print `total=0 defaulted=0` — perfectly true, and about a population
+ * it never found — and hand its author a storefront that refuses to build.
+ */
+export declare function loadTreeDeclaration(treeDir: string, exportName: string): Promise<readonly EnvironmentInput[]>;
+//# sourceMappingURL=declaration.d.ts.map

package/dist/inputs/declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../../src/inputs/declaration.ts"],"names":[],"mappings":"AAuBA,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE5F,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;AAEzD,gFAAgF;AAChF,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAkB,IAAI,0BAA0B;CACjD;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CA6BtC"}

package/dist/inputs/declaration.js

@@ -0,0 +1,64 @@
+/**
+ * Reading a tree's own environment-input declaration
+ * (`environment-inputs.md` §R2.3).
+ *
+ * ## Why this loads the file rather than importing a package
+ *
+ * The declaration a scaffolding command resolves against is the **declaration
+ * of the tree being written** — the reference storefront's here, a client's own
+ * copy of it once they have one. Under D-195 that tree is a repository the
+ * client owns outright: its declaration travels in the copy and is edited there,
+ * so it cannot be a constant compiled into this program. A list in the CLI would
+ * be a derived fact written down (D-100) that could never see a tree a client
+ * changed.
+ *
+ * The declaration is `.mjs` for the reason `storefront/lib/env.mjs` is: it has
+ * to be readable by a plain Node process before the tree it describes has been
+ * installed or built. `import()` of a file URL is therefore all that is needed,
+ * and there is no compiler in the path.
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { EnvironmentInputsSchema } from '@endora-commerce/contracts';
+/** The file every application-level declaration is named, in every tree. */
+export const DECLARATION_FILE = 'environment-inputs.mjs';
+/** Raised when a tree's declaration is absent or is not one. Exit 2's shape. */
+export class DeclarationLoadError extends Error {
+    name = 'DeclarationLoadError';
+}
+/**
+ * The declaration a tree ships, or a refusal.
+ *
+ * **Absent is a refusal, never "this tree needs nothing"**, which is the failure
+ * `manifest-locations.ts` was written to end one surface over: a command that
+ * read a missing declaration as an empty one would write a `.env` holding
+ * nothing, print `total=0 defaulted=0` — perfectly true, and about a population
+ * it never found — and hand its author a storefront that refuses to build.
+ */
+export async function loadTreeDeclaration(treeDir, exportName) {
+    const path = join(treeDir, DECLARATION_FILE);
+    if (!existsSync(path)) {
+        throw new DeclarationLoadError(`${path} is not there, so this run cannot say what the tree needs from its ` +
+            `environment. A declaration that is absent is not a tree with no requirements.`);
+    }
+    let loaded;
+    try {
+        loaded = (await import(pathToFileURL(path).href));
+    }
+    catch (error) {
+        throw new DeclarationLoadError(`${path} could not be loaded: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const parsed = EnvironmentInputsSchema.safeParse(loaded[exportName]);
+    if (!parsed.success) {
+        throw new DeclarationLoadError(`${path} does not export \`${exportName}\` as an environment-input declaration — ` +
+            parsed.error.issues
+                .map((issue) => `${issue.path.join('.')}: ${issue.message}`)
+                .join('; '));
+    }
+    if (parsed.data.length === 0) {
+        throw new DeclarationLoadError(`${path} declares no input at all`);
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=declaration.js.map

package/dist/inputs/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../../src/inputs/declaration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,uBAAuB,EAAyB,MAAM,4BAA4B,CAAC;AAE5F,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAEzD,gFAAgF;AAChF,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC3B,IAAI,GAAG,sBAAsB,CAAC;CACjD;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAe,EACf,UAAkB;IAElB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,oBAAoB,CAC5B,GAAG,IAAI,qEAAqE;YAC1E,+EAA+E,CAClF,CAAC;IACJ,CAAC;IACD,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAA4B,CAAC;IAC/E,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,IAAI,oBAAoB,CAC5B,GAAG,IAAI,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACzF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,oBAAoB,CAC5B,GAAG,IAAI,sBAAsB,UAAU,2CAA2C;YAChF,MAAM,CAAC,KAAK,CAAC,MAAM;iBAChB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;iBAC3D,IAAI,CAAC,IAAI,CAAC,CAChB,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,oBAAoB,CAAC,GAAG,IAAI,2BAA2B,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/inputs/env-file.d.ts

@@ -0,0 +1,73 @@
+/**
+ * The `.env` a command reads values from and writes values into.
+ *
+ * `specs/117-instance-bring-up/contracts/input-resolution.md` tier 2, and R1.3:
+ * **this is not a configuration file for the tool**. `cli-product.md` R2.5's
+ * *"there is no `.endorarc`"* stands unamended. Nothing in a `.env` changes a
+ * verdict, a rule or a behaviour of the CLI — it supplies values, exactly as a
+ * flag does, and it is the *instance's* own runtime configuration, which is to
+ * say the artefact the command's own output already contains.
+ *
+ * ## Blank does not answer
+ *
+ * `SESSION_COOKIE_SECRET=` and no line at all are the same state for whoever has
+ * to fix it, so a blank value does not resolve an input: it is skipped, and the
+ * input goes on to the next tier. Reading it as an answer would let a run print
+ * `env-file=6` over six empty strings and a shop boot with an unsigned session
+ * cookie — a provenance line that is true about where it looked and false about
+ * what it found. `storefront/lib/env.mjs` makes the same call for the same
+ * reason and calls the state `missing` rather than malformed.
+ *
+ * ## What it deliberately does not implement
+ *
+ * No variable expansion (`${OTHER}`), no multi-line values, no `.env.local`
+ * chain. Each is a dialect: `dotenv`, `pnpm`, Next and Docker Compose disagree
+ * about all three, and a scaffold that picked one would write a file that means
+ * something different to the tool that reads it next. What is implemented is the
+ * intersection every one of them agrees on — `KEY=value`, one line, optional
+ * quotes, `#` comments — and a line outside it is left alone rather than
+ * rewritten.
+ */
+/**
+ * Every value the file supplies, in file order.
+ *
+ * A blank value is **absent** — see the header. A key repeated in one file keeps
+ * the last assignment, which is what every reader of a `.env` does.
+ */
+export declare function parseEnvFile(text: string): ReadonlyMap<string, string>;
+/**
+ * A value as it is written back, quoted only where it has to be.
+ *
+ * A generated secret is base64 and needs no quoting; a URL needs none. What does
+ * is a value carrying a space, a quote or a `#`, because an unquoted `#` starts
+ * a comment in every dialect above and would truncate the value silently.
+ */
+export declare function renderEnvValue(value: string): string;
+/**
+ * The file's new text: every existing line kept, in place, with the values this
+ * run resolved written over the keys they name and appended where they are new.
+ *
+ * **Kept in place** rather than re-rendered, because the operator may already
+ * have put comments, ordering and their own keys in it, and a scaffold that
+ * rewrote the file would silently discard all three. That is the same rule
+ * `endora new storefront` applies to a directory it will not merge into, one
+ * granularity down.
+ *
+ * ## A commented-out placeholder is filled in, not duplicated
+ *
+ * `endora new instance` writes its `.env` with every declared input present and
+ * **commented out**, because a blank assignment is not the same state as no
+ * assignment: Node's `--env-file` sets `MEILISEARCH_URL=` to the empty string,
+ * and the platform's `??` fallbacks read that as a value. Measured — the
+ * instance acceptance criterion's health route answered 503 over a search
+ * engine that was running, because a file listing every optional input as a
+ * blank had turned twenty "unset"s into twenty empty strings.
+ *
+ * So a value written over such a placeholder replaces the commented line rather
+ * than being appended below it, which keeps the operator's ordering and the
+ * sentence above it and leaves no second assignment of the same key for a
+ * reader to wonder about. A key the run has no value for stays commented, and
+ * therefore stays genuinely unset.
+ */
+export declare function writeEnvFile(existingText: string, values: ReadonlyMap<string, string>): string;
+//# sourceMappingURL=env-file.d.ts.map

package/dist/inputs/env-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-file.d.ts","sourceRoot":"","sources":["../../src/inputs/env-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAuBH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAYtE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,MAAM,CAyBR"}