create-ailk 0.13.0 → 0.15.0

package/dist/team-profiles.js

@@ -0,0 +1,43 @@
+/**
+ * The seeded team (#7744 D8) — the one source of the three placeholder people
+ * the organization shapes ship.
+ *
+ * The `_base` layer installs one `TeamMember` profile per person at
+ * `/team/<slug>` and a `/team` index listing them (#7744 D4); minimalism's
+ * home seeds for the three organization shapes carry a `people` slide listing
+ * the same members, each linking to their profile. `team-profiles.test.ts`
+ * pins that every one of those seeds agrees with `TEAM_SEED_MEMBERS`.
+ *
+ * `node:fs` only: create-ailk ships one runtime dependency (`tar`), and its
+ * scaffold-time readers may not import `yaml` (see `design-package.ts`), so
+ * this module parses nothing — it only checks which profile files a site has.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+function seedMember(slug, ordinal) {
+    return {
+        slug,
+        name: `{${ordinal} team member's name}`,
+        role: "{Their title}",
+        links: [{ type: "page", url: `/team/${slug}`, label: "{View profile}" }],
+    };
+}
+/**
+ * The three seeded people, in seed order: slug, the seed's `title` as `name`,
+ * "{Their title}", and a page link to `/team/<slug>` labelled "{View profile}".
+ */
+export const TEAM_SEED_MEMBERS = [
+    seedMember("first-member", "First"),
+    seedMember("second-member", "Second"),
+    seedMember("third-member", "Third"),
+];
+/**
+ * `TEAM_SEED_MEMBERS` whose `<siteRoot>/content/en/TeamMember/<slug>.mdx`
+ * exists (without `slug`), or `undefined` when none does (person-service, or
+ * a site that deleted them). Reads, never writes.
+ */
+export function teamSlideMembers(siteRoot) {
+    const dir = join(siteRoot, "content", "en", "TeamMember");
+    const members = TEAM_SEED_MEMBERS.filter(({ slug }) => existsSync(join(dir, `${slug}.mdx`))).map(({ slug: _slug, ...member }) => member);
+    return members.length > 0 ? members : undefined;
+}

package/dist/topology.d.ts

@@ -0,0 +1,131 @@
+import { type ModuleName } from "./parse-args.js";
+/** The two topologies. `hub` is the default and the only one before #7426. */
+export declare const TOPOLOGIES: readonly ["hub", "spoke"];
+export type Topology = (typeof TOPOLOGIES)[number];
+/** A refusal or a malformed input this module names. */
+export declare class TopologyError extends Error {
+    constructor(message: string);
+}
+/** Roots no spoke carries. `apps/mcp` joins them with `--without-mcp`. */
+export declare const SPOKE_REMOVED_ROOTS: readonly string[];
+/** The root `--without-mcp` removes. */
+export declare const SPOKE_MCP_ROOT = "apps/mcp";
+/**
+ * The sign-in and database files a spoke does not carry — files and
+ * directories, scaffold-relative. Every other file that imports one of them
+ * goes with it (`spokeExclusions`).
+ */
+export declare const SPOKE_REMOVAL_SEEDS: readonly string[];
+/** The two generated seam files (D5). A seam is rewritten, never removed. */
+export declare const WEB_SEAM_PATH = "apps/web/lib/topology.generated.ts";
+export declare const MCP_SEAM_PATH = "apps/mcp/src/lib/topology.generated.ts";
+export declare const SPOKE_SEAM_FILES: readonly string[];
+/**
+ * The closure's allow-list: a file `spokeExclusions` removes must sit under
+ * one of these prefixes, or under a `__tests__/` directory. A member outside
+ * both is a defect — a shared file started importing a sign-in or database
+ * file — and `spokeExclusions` throws naming it rather than cut it silently.
+ */
+export declare const SPOKE_REMOVABLE_PREFIXES: readonly string[];
+export interface SpokeShapeOptions {
+    /** Whether the spoke keeps `apps/mcp` (the default; `--without-mcp` drops it). */
+    mcp: boolean;
+}
+/** The removed roots for these options. */
+export declare function spokeRemovedRoots(opts: SpokeShapeOptions): string[];
+/** Whether a closure member is one the registry allows a spoke to drop. */
+export declare function isRemovableClosureMember(path: string): boolean;
+/**
+ * Every path a spoke does not carry, computed over the built `templates/`
+ * tree: the removed roots, the seeds that apply, and every source file under
+ * the kept apps that reaches a seed through relative imports, to a fixed
+ * point. Sorted; directories and files alike, matched at a directory
+ * boundary by `isSpokeExcluded` and `copyTemplate`'s `excludePaths`.
+ *
+ * The walk is the relative-import resolution `importClosure` uses
+ * (`lib/import-graph.ts`), with ONE difference: a seam file is never a
+ * candidate, so the walk never crosses it. The hub render of a seam imports
+ * a seed by design (D5); its importers keep their place on a spoke because
+ * the spoke render of the same file imports none.
+ *
+ * @throws TopologyError naming every closure member outside
+ *   `SPOKE_REMOVABLE_PREFIXES` and not a test — a new shared file importing
+ *   a sign-in or database file, which removing would silently break the
+ *   spoke (spec § 5.3: escalate, never widen).
+ */
+export declare function spokeExclusions(templatesDir: string, opts: SpokeShapeOptions): string[];
+export interface IsSpokeExcludedOptions extends SpokeShapeOptions {
+    /**
+     * The full `spokeExclusions(...)` list, when the caller computed it. Absent,
+     * only the removed roots and the seeds are checked — exact for any path
+     * that is not a file of the built `templates/` tree (a module bundle's
+     * file, a route directory), since only a template file can be a closure
+     * member.
+     */
+    exclusions?: readonly string[];
+}
+/**
+ * The one predicate for "a spoke does not carry this path" (the Phase 2
+ * generator contract). Scaffold-relative, `/`- or `\`-separated.
+ */
+export declare function isSpokeExcluded(path: string, opts: IsSpokeExcludedOptions): boolean;
+/** `apps/web/lib/topology.generated.ts` for `topology` (D5). */
+export declare function renderWebSeam(topology: Topology): string;
+/** `apps/mcp/src/lib/topology.generated.ts` for `topology` (D5). */
+export declare function renderMcpSeam(topology: Topology): string;
+/** `pnpm-workspace.yaml` without its `database` package entry. */
+export declare function transformWorkspaceYaml(text: string): string;
+/** The root `package.json` without its `db:*` scripts. */
+export declare function transformRootPackageJson(text: string): string;
+/** The root `tsconfig.json` without a reference under a removed root. */
+export declare function transformRootTsconfig(text: string, opts: SpokeShapeOptions): string;
+/**
+ * An app's `package.json` without its `@working-theory/database` dependency.
+ * @throws TopologyError when `required` and the dependency is absent.
+ */
+export declare function transformAppPackageJson(text: string, label: string, required: boolean): string;
+/**
+ * Apply every D6 root-file transform to the spoke at `targetDir` (after the
+ * base copy, before any module or template layer), and write the spoke
+ * render of each seam it carries (D5).
+ * @throws TopologyError naming the file whose anchor is missing.
+ */
+export declare function applySpokeTransforms(targetDir: string, opts: SpokeShapeOptions): void;
+/** The env var a spoke reaches its hub through. */
+export declare const HUB_ORIGIN_ENV_VAR = "AILK_API_URL";
+/**
+ * Write `AILK_API_URL=<origin>` to the spoke's `apps/web/.env.local` (D2) —
+ * the `auth-secret-file.ts` never-clobber rule: an assignment already in any
+ * env file Next loads for `apps/web` is kept, and `.env.local` stays
+ * gitignored. Never writes `AILK_SPOKE_KEY` or `AILK_VISITOR_FORWARD_KEY`:
+ * the hub issues those.
+ */
+export declare function writeHubOriginEnv(targetDir: string, origin: string): void;
+/** The `hard_floors:` block a spoke's `project.yaml` carries (D9). */
+export declare function renderSpokeHardFloors(opts: SpokeShapeOptions): string;
+/** `project.yaml` with its `hard_floors:` block replaced by the spoke's (D9). */
+export declare function transformProjectYaml(text: string, opts: SpokeShapeOptions): string;
+/** The modules a spoke may carry — every slice declaring `spoke: true`. */
+export declare function spokeModules(): ModuleName[];
+/** The refusal for a module a spoke cannot carry, or undefined when admitted. */
+export declare function spokeModuleRefusal(name: ModuleName): string | undefined;
+/**
+ * The topology `<targetDir>` records. A missing manifest, or one without a
+ * `topology` key, reads as `"hub"` — every site scaffolded before #7426.
+ * @throws TopologyError on an unreadable manifest or an unknown value.
+ */
+export declare function readSiteTopology(targetDir: string): Topology;
+/**
+ * Hosts a spoke may reach over plain `http:` — the set
+ * `packages/api-client/src/http.ts` sends the spoke key under. Named here
+ * rather than imported: create-ailk carries no runtime dependency.
+ */
+export declare const LOOPBACK_HOSTS: readonly string[];
+/**
+ * The hub origin for a spoke: `--hub-url`, else `AILK_API_URL`. An `https:`
+ * URL, or `http:` on a loopback host, with no path but `/`, no query and no
+ * fragment — normalized to its origin with no trailing slash.
+ * @throws TopologyError naming both inputs when neither is set or the value
+ *   is not such an origin. Never echoes a query or fragment.
+ */
+export declare function normalizeHubUrl(raw: string | undefined): string;