@decohere/scaffold 0.0.1-dev.125 → 0.0.1-dev.18

package/es6/src/webapi/workspace-readme.js

@@ -1,88 +0,0 @@
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-import { WELL_KNOWN_FILES } from "../models/const.js";
-import { apiNameFromProjectDir, listExistingApiNames } from "./api-name.js";
-/** Pure renderer — keep feature sections short and copy-paste ready. */ export function renderWorkspaceReadme(input) {
-    const { projectName, apiNames, hasPostgres, hasAuth0, hasPostman } = input;
-    const apis = apiNames.length > 0 ? apiNames : [
-        "api"
-    ];
-    const lines = [
-        `# ${projectName}`,
-        "",
-        "Decohere web API workspace. Scaffolded with [`@decohere/create`](https://www.npmjs.com/package/@decohere/create).",
-        "",
-        "## Get started",
-        "",
-        "1. Open this folder in VS Code / Cursor.",
-        "2. **Reopen in Container** (or rebuild the Dev Container).",
-        "   Host `initialize.sh` and container `post-start.sh` ask y/N (TTY only) before npm auth or codebase RAG MCP.",
-        "   Skip or decline; missing TTY skips. RAG credentials land in `.cursor/` (gitignored).",
-        "3. Install dependencies if needed:",
-        "",
-        "```bash",
-        "pnpm install",
-        "```",
-        "",
-        "## Develop",
-        "",
-        "```bash",
-        "pnpm dev              # Flux HMR (first API)",
-        "pnpm start            # run the compiled first API",
-        "pnpm run build        # forge release build",
-        "pnpm run package      # release build + .package/ for each API (what Docker copies)"
-    ];
-    for (const name of apis){
-        lines.push(`pnpm run dev:${name}     # HMR for ${name}`);
-        lines.push(`pnpm run start:${name}   # production entry for ${name}`);
-    }
-    lines.push("```", "");
-    lines.push("## Logging", "", "In development, Scribe uses pino-pretty and rolling files under `logs/` (gitignored).", "When `NODE_ENV=production`, the process writes structured JSON to stdout and does not rotate files.", "Ship and retain those streams outside the app (platform logs, a sidecar, or a log agent) so shipping can change without rebuilding.", "", "Override roll path and rotation without changing app code:", "`SCRIBE_LOG_FILE`, `SCRIBE_LOG_SIZE`, `SCRIBE_LOG_FREQUENCY`, `SCRIBE_LOG_KEEP`.", "", 'Opt into in-process pretty or roll in production only with `{ when: "always" }` on `scribe.withPinoPretty` / `scribe.withPinoRoll`.', "");
-    if (hasPostgres) {
-        lines.push("## Database", "", "Postgres runs via Dev Container Compose:", "", "```bash", "pnpm db:up", "pnpm db:down", "pnpm db:reset", "```", "");
-    }
-    lines.push("## Deploy", "", "Each API has its own `projects/<name>/Dockerfile`. It copies `.package/`, which `forge package`", "writes before Docker runs: the API's compiled code, the workspace libraries it imports, and", "a plain `node_modules` of the third-party packages it uses (no symlinks). The image build", "installs nothing and needs no npm token.", "", "```bash", "pnpm run package         # release build, then .package/ in every API", `docker build -t ${projectName} projects/api`, "```", "", "One API: `pnpm run package:<name>`, then `docker build projects/<name>`.", "A host that builds from a git clone does not have `.package/`; build and push the image", "from CI instead (`forge docker` after `pnpm run package`).", "");
-    lines.push("## Add another API", "", "```bash", "decohere add api <name>", "```", "", "Example: `decohere add api billing`", "");
-    if (hasAuth0) {
-        lines.push("## Auth0", "", "JWT auth is wired from `.env` (`AUTH0_ISSUER_BASE_URL`, `AUTH0_AUDIENCE`).", 'After you add a controller, `@Authorize("read", "Invoice")` becomes the Auth0 permission `read:Invoice`.', "Sync the Auth0 API, admin grants, and Postman token scopes without re-scaffolding:", "", "```bash", "npx @decohere/create auth0 login      # once / when the CLI token expires", "npx @decohere/create auth0 configure  # after new @Authorize decorators", "```", "");
-    }
-    if (hasPostman) {
-        lines.push("## Postman", "", "Open this **project root** in Postman Local View (Files → Open folder), not the `postman/` subfolder.", "Select the Local environment, then Authorization → Get New Access Token when Auth0 is enabled.", "");
-    }
-    lines.push("## More", "", "- Package docs: https://www.npmjs.com/package/@decohere/create", "- After `decohere add api`, this README is refreshed so scripts and APIs stay accurate.", "");
-    return `${lines.join("\n")}`;
-}
-export function resolveWorkspaceReadmeInput(workspace, options) {
-    const newNames = workspace.getProjects().map((project)=>apiNameFromProjectDir(project.dir));
-    const apiNames = options.add ? mergeApiNames(listExistingApiNames(workspace.targetDir), newNames) : newNames;
-    const pkg = workspace.getModel(WELL_KNOWN_FILES.PACKAGE_JSON);
-    const env = workspace.getModel(WELL_KNOWN_FILES.ENV_FILE);
-    const hasPostgres = options.databaseProvider === "postgres/typeorm" || Boolean(pkg?.hasScript("db:up"));
-    const hasAuth0 = options.authProvider === "auth0" || Boolean(env?.hasEntry("AUTH0_ISSUER_BASE_URL"));
-    const hasPostman = options.postmanProvider === "local" || options.postmanProvider === "api" || existsSync(join(workspace.targetDir, "postman")) || existsSync(join(workspace.targetDir, ".postman"));
-    return {
-        projectName: workspace.name,
-        apiNames,
-        hasPostgres,
-        hasAuth0,
-        hasPostman
-    };
-}
-export function writeWorkspaceReadme(workspace, options) {
-    const content = renderWorkspaceReadme(resolveWorkspaceReadmeInput(workspace, options));
-    workspace.addFile({
-        files: ()=>[
-                {
-                    filePath: "README.md",
-                    content
-                }
-            ]
-    });
-}
-function mergeApiNames(existing, added) {
-    const seen = new Set(existing);
-    return [
-        ...existing,
-        ...added.filter((name)=>!seen.has(name))
-    ];
-}

package/es6/src/webapi.action.js

@@ -1,18 +0,0 @@
-function _ts_decorate(decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-import { injectable } from "@decohere/crucible/decorators";
-import { ActionResponse } from "@decohere/devkit/cli";
-import { runScaffoldApi, toApiOptions } from "./webapi/cli-options.js";
-export class WebapiAction {
-    async run(options) {
-        await runScaffoldApi(toApiOptions(options.directory, options));
-        return ActionResponse.Success("webapi");
-    }
-}
-WebapiAction = _ts_decorate([
-    injectable()
-], WebapiAction);

package/es6/src/webapi.command.js

@@ -1,33 +0,0 @@
-import { DecohereCommand } from "@decohere/devkit/cli";
-import { addWebapiFeatureOptions, collectName } from "./webapi/cli-options.js";
-import { WebapiAction } from "./webapi.action.js";
-export class WebapiCommand extends DecohereCommand {
-    get actions() {
-        return [
-            WebapiAction
-        ];
-    }
-    constructor(name){
-        super(name);
-        this.description("Scaffold a web API workspace");
-        this.argument("[directory]", "Target directory (default: -d or current directory)");
-        this.option("-d <directory>", "Target directory (default: current directory)", ".");
-        this.option("--name <slug>", "API name under projects/ (repeatable; default: api)", collectName, []);
-        addWebapiFeatureOptions(this);
-    }
-    /**
-	 * Commander passes positional args before options when `[directory]` is declared.
-	 * ModuleFactory expects `(opts, cmd)` — stash the directory on the command.
-	 */ action(fn) {
-        return super.action((...args)=>{
-            const cmd = args.at(-1);
-            const first = args[0];
-            const hasPositional = typeof first === "string" || first === undefined;
-            const opts = hasPositional ? args[1] : args[0];
-            if (typeof first === "string" && first !== "") {
-                cmd.setOptionValue("directory", first);
-            }
-            return fn(opts, cmd);
-        });
-    }
-}

package/types/src/add-api.action.d.ts

@@ -1,13 +0,0 @@
-import { type Action, ActionResponse } from "@decohere/devkit/cli";
-export type AddApiOptions = {
-    apiName?: string;
-    d?: string;
-    database?: string;
-    auth?: string;
-    postman?: string;
-    yes?: boolean;
-    install?: string;
-};
-export declare class AddApiAction implements Action<AddApiOptions> {
-    run(options: AddApiOptions): Promise<ActionResponse>;
-}

package/types/src/add-api.command.d.ts

@@ -1,7 +0,0 @@
-import { DecohereCommand } from "@decohere/devkit/cli";
-import { AddApiAction } from "./add-api.action.js";
-export declare class AddApiCommand extends DecohereCommand {
-    get actions(): (typeof AddApiAction)[];
-    constructor(name: string);
-    action(fn: (...args: unknown[]) => void | Promise<void>): this;
-}

package/types/src/add.command.d.ts

@@ -1,6 +0,0 @@
-import type { Actions } from "@decohere/devkit/cli";
-import { type CommandHandler, type CommandResponse, type CommandType, DecohereCommand } from "@decohere/devkit/cli";
-export declare class AddCommand extends DecohereCommand {
-    constructor(commands: Record<string, CommandType>, handler: CommandHandler);
-    run(_actions: Actions, _options: never): Promise<CommandResponse>;
-}

package/types/src/add.module.d.ts

@@ -1,14 +0,0 @@
-import { ModuleManifest } from "@decohere/devkit/cli";
-import { AddCommand } from "./add.command.js";
-import { AddApiAction } from "./add-api.action.js";
-import { AddApiCommand } from "./add-api.command.js";
-export declare class AddModule extends ModuleManifest {
-    readonly id = "add";
-    readonly command: typeof AddCommand;
-    readonly commands: {
-        api: typeof AddApiCommand;
-    };
-    readonly actions: {
-        api: typeof AddApiAction;
-    };
-}

package/types/src/auth0-configure.action.d.ts

@@ -1,7 +0,0 @@
-import { type Action, ActionResponse } from "@decohere/devkit/cli";
-export type Auth0ConfigureOptions = {
-    d?: string;
-};
-export declare class Auth0ConfigureAction implements Action<Auth0ConfigureOptions> {
-    run(options: Auth0ConfigureOptions): Promise<ActionResponse>;
-}

package/types/src/auth0-configure.command.d.ts

@@ -1,6 +0,0 @@
-import { DecohereCommand } from "@decohere/devkit/cli";
-import { Auth0ConfigureAction } from "./auth0-configure.action.js";
-export declare class Auth0ConfigureCommand extends DecohereCommand {
-    get actions(): (typeof Auth0ConfigureAction)[];
-    constructor(name: string);
-}

package/types/src/auth0-login.action.d.ts

@@ -1,4 +0,0 @@
-import { type Action, ActionResponse } from "@decohere/devkit/cli";
-export declare class Auth0LoginAction implements Action {
-    run(): Promise<ActionResponse>;
-}

package/types/src/auth0-login.command.d.ts

@@ -1,6 +0,0 @@
-import { DecohereCommand } from "@decohere/devkit/cli";
-import { Auth0LoginAction } from "./auth0-login.action.js";
-export declare class Auth0LoginCommand extends DecohereCommand {
-    get actions(): (typeof Auth0LoginAction)[];
-    constructor(name: string);
-}

package/types/src/auth0.command.d.ts

@@ -1,6 +0,0 @@
-import type { Actions } from "@decohere/devkit/cli";
-import { type CommandHandler, type CommandResponse, type CommandType, DecohereCommand } from "@decohere/devkit/cli";
-export declare class Auth0Command extends DecohereCommand {
-    constructor(commands: Record<string, CommandType>, handler: CommandHandler);
-    run(_actions: Actions, _options: never): Promise<CommandResponse>;
-}

package/types/src/auth0.module.d.ts

@@ -1,18 +0,0 @@
-import { ModuleManifest } from "@decohere/devkit/cli";
-import { Auth0Command } from "./auth0.command.js";
-import { Auth0ConfigureAction } from "./auth0-configure.action.js";
-import { Auth0ConfigureCommand } from "./auth0-configure.command.js";
-import { Auth0LoginAction } from "./auth0-login.action.js";
-import { Auth0LoginCommand } from "./auth0-login.command.js";
-export declare class Auth0Module extends ModuleManifest {
-    readonly id = "auth0";
-    readonly command: typeof Auth0Command;
-    readonly commands: {
-        login: typeof Auth0LoginCommand;
-        configure: typeof Auth0ConfigureCommand;
-    };
-    readonly actions: {
-        login: typeof Auth0LoginAction;
-        configure: typeof Auth0ConfigureAction;
-    };
-}

package/types/src/cli.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/types/src/create.command.d.ts

@@ -1,6 +0,0 @@
-import type { Actions } from "@decohere/devkit/cli";
-import { type CommandHandler, type CommandResponse, type CommandType, DecohereCommand } from "@decohere/devkit/cli";
-export declare class CreateCommand extends DecohereCommand {
-    constructor(commands: Record<string, CommandType>, handler: CommandHandler);
-    run(_actions: Actions, _options: never): Promise<CommandResponse>;
-}

package/types/src/create.module.d.ts

@@ -1,14 +0,0 @@
-import { ModuleManifest } from "@decohere/devkit/cli";
-import { CreateCommand } from "./create.command.js";
-import { WebapiAction } from "./webapi.action.js";
-import { WebapiCommand } from "./webapi.command.js";
-export declare class CreateModule extends ModuleManifest {
-    readonly id = "create";
-    readonly command: typeof CreateCommand;
-    readonly commands: {
-        webapi: typeof WebapiCommand;
-    };
-    readonly actions: {
-        webapi: typeof WebapiAction;
-    };
-}

package/types/src/domain/prompt.d.ts

@@ -1,4 +0,0 @@
-/** Release stdin so the process can exit after interactive prompts. */
-export declare function closePrompt(): void;
-export declare function ask(question: string, fallback?: string): Promise<string>;
-export declare function pick<T>(label: string, items: T[], display: (item: T) => string): Promise<T | null>;

package/types/src/models/compose.model.d.ts

@@ -1,73 +0,0 @@
-import type { KeyedModel } from "./source-file.js";
-export type ComposeNetworkRef = string | {
-    /** Network key under `networks:` on this service */
-    [networkKey: string]: {
-        aliases?: string[];
-    };
-};
-export interface ComposeHealthcheck {
-    test: string[];
-    interval?: string;
-    timeout?: string;
-    retries?: number;
-}
-export interface ComposeService {
-    build?: string;
-    image?: string;
-    container_name?: string;
-    /** Quoted in YAML (`0:0` must not parse as a number). */
-    user?: string;
-    env_file?: string[];
-    environment?: Record<string, string>;
-    ports?: string[];
-    volumes?: string[];
-    command?: string;
-    restart?: string;
-    depends_on?: string[];
-    /** Compose profiles (service only starts when profile is enabled). */
-    profiles?: string[];
-    /** Attach to compose networks (string name or map with aliases). */
-    networks?: ComposeNetworkRef[];
-    healthcheck?: ComposeHealthcheck;
-}
-export type ComposeNetwork = {
-    /** Fixed Docker network name (shareable across compose projects). */
-    name: string;
-    external?: boolean;
-};
-/**
- * Live builder for `docker-compose.yml`.
- *
- * Features call `addService` / `addVolume` / `addNetwork` in their scaffold phases.
- * Loaded with `fromFile` (`decohere add api`), additions merge into the existing file:
- * services, networks and volumes already there are left untouched, comments kept.
- */
-export declare class DockerCompose implements KeyedModel {
-    readonly key: string;
-    private _projectName;
-    private readonly _headerComments;
-    private readonly _services;
-    private readonly _volumes;
-    private readonly _networks;
-    private readonly _envFiles;
-    private _existing;
-    /** Load an existing compose file so `decohere add api` can merge into it. */
-    static fromFile(absolutePath: string): DockerCompose;
-    /** True when the service is defined (in the loaded file or added since). */
-    hasService(name: string): boolean;
-    /** Compose project name (`name:` top-level) — isolates containers/volumes. */
-    setProjectName(name: string): this;
-    /** File-level `#` comments rendered above `name:` / `services:`. */
-    addHeaderComment(...lines: string[]): this;
-    addService(name: string, config: ComposeService): this;
-    files(): {
-        filePath: string;
-        content: string;
-    }[];
-    addVolume(name: string): this;
-    addNetwork(key: string, network: ComposeNetwork): this;
-    /** Append an env_file path to an existing service. */
-    addEnvFile(serviceName: string, filePath: string): this;
-    getContent(): string;
-    private mergeIntoExisting;
-}

package/types/src/models/config-yaml.model.d.ts

@@ -1,27 +0,0 @@
-import type { KeyedModel, SourceFile } from "./source-file.js";
-/**
- * Builder for a YAML config file (e.g. config/config.yaml or config/config.dev.yaml).
- *
- * Starts with a base section passed to the constructor. Features call
- * `addSection(yaml)` during their scaffold phase to append their own block.
- * `files()` joins all sections with a blank line separator.
- */
-export declare class ConfigYaml implements KeyedModel {
-    readonly key: string;
-    private readonly filePath;
-    private readonly _sections;
-    constructor(key: string, filePath: string, baseContent: string);
-    addSection(yaml: string): this;
-    /** True when a datasource with this `name:` already appears in the file. */
-    hasDataSource(name: string): boolean;
-    hasDataSources(): boolean;
-    /**
-     * Insert a `dataSources` list item. Used by `webapi add` so we do not write a
-     * second top-level `database:` key (YAML last-key-wins).
-     */
-    appendDataSource(item: string): this;
-    static fromFile(key: string, relativePath: string, absolutePath: string): ConfigYaml;
-    files(): SourceFile[];
-}
-/** Insert a YAML list item under `dataSources:`; append a new `database:` block if missing. */
-export declare function injectYamlDataSource(yaml: string, item: string): string;

package/types/src/models/const.d.ts

@@ -1,20 +0,0 @@
-export declare const WELL_KNOWN_FILES: {
-    VSCODE_SETTINGS: string;
-    LAUNCH_JSON: string;
-    DOCKER_COMPOSE: string;
-    DEVCONTAINER_JSON: string;
-    DOCKERFILE: string;
-    PRODUCTION_DOCKERFILE: string;
-    GITHUB_CI: string;
-    PACKAGE_JSON: string;
-    API_PACKAGE_JSON: string;
-    TSCONFIG: string;
-    VITEST_CONFIG: string;
-    MAIN_TS: string;
-    CONTROLLER_TS: string;
-    CONFIG_YAML: string;
-    CONFIG_DEV_YAML: string;
-    GITIGNORE: string;
-    AUTH_CONFIG: string;
-    ENV_FILE: string;
-};

package/types/src/models/dev-container.model.d.ts

@@ -1,49 +0,0 @@
-import type { KeyedModel, SourceFile } from "./source-file.js";
-/**
- * Model for `.devcontainer/devcontainer.json`.
- *
- * Features call builder methods (`addExtension`, `forwardPort`, etc.) during
- * their configure phase. `MonoRepoScaffold` calls `files()` at render time.
- */
-export type PortAttributes = {
-    label?: string;
-    /** When true, host port must match the container port (no random remap). */
-    requireLocalPort?: boolean;
-    onAutoForward?: "notify" | "openBrowser" | "openPreview" | "silent" | "ignore";
-};
-export declare class DevContainer implements KeyedModel {
-    readonly key: string;
-    private readonly _extensions;
-    private readonly _ports;
-    private readonly _portAttributes;
-    private _mounts;
-    private _workspaceFolder;
-    private _postCreateCommand?;
-    private _updateContentCommand?;
-    private _postStartCommand?;
-    private _initializeCommand?;
-    private _remoteUser;
-    private _useCompose;
-    private _existing;
-    /**
-     * Load an existing devcontainer.json so `decohere add api` can merge into it.
-     * Only extensions, forwarded ports and port attributes are merged; everything else is kept.
-     */
-    static fromFile(absolutePath: string): DevContainer;
-    constructor();
-    /** In-container path Cursor/VS Code opens (Agents window uses the basename). */
-    setWorkspaceFolder(folder: string): this;
-    private bindMount;
-    addExtension(...ids: string[]): this;
-    forwardPort(...ports: number[]): this;
-    setPortAttributes(port: number, attrs: PortAttributes): this;
-    setPostCreateCommand(cmd: string): this;
-    setUpdateContentCommand(cmd: string): this;
-    setPostStartCommand(cmd: string): this;
-    setInitializeCommand(cmd: string): this;
-    setRemoteUser(user: string): this;
-    useCompose(): this;
-    files(): SourceFile[];
-    private mergeIntoExisting;
-    private build;
-}

package/types/src/models/docker-image.model.d.ts

@@ -1,90 +0,0 @@
-import type { KeyedModel, SourceFile } from "./source-file.js";
-export type LayerWriter = (dockerfile: DockerfileModel) => void;
-export declare class DockerStep {
-    readonly key: string;
-    readonly content: string;
-    readonly order: number;
-    constructor(key: string, content: string, order?: number);
-    static run(key: string, command: string, order?: number): DockerStep;
-    static raw(key: string, content: string, order?: number): DockerStep;
-    static entrypoint(key: string, value: string | readonly string[], order?: number): DockerStep;
-}
-/** Named volume + paths for interactive bash history in app Dev Containers. */
-export declare const commandHistory: {
-    readonly volumeName: "bashhistory";
-    readonly dir: "/commandhistory";
-    readonly fileName: ".bash_history";
-    readonly histFile: "/commandhistory/.bash_history";
-};
-export declare function withCommandHistory(options?: {
-    historyDir?: string;
-    historyFileName?: string;
-    username?: string;
-    order?: number;
-}): LayerWriter;
-export declare function withNodeUser(options?: {
-    username?: string;
-    includeUserInstruction?: boolean;
-    order?: number;
-}): LayerWriter;
-export declare function withPnpm(options?: {
-    version?: string;
-    usernameExpr?: string;
-    order?: number;
-}): LayerWriter;
-/**
- * Client-only (`psql`, etc.). Escalates to root so this also works when layered on
- * a published base image that already switched to `USER node`.
- */
-export declare function withPostgresqlClient(options?: {
-    order?: number;
-    username?: string;
-}): LayerWriter;
-/** GitHub CLI — install before USER switches away from root. */
-export declare function withGithubCli(options?: {
-    order?: number;
-}): LayerWriter;
-export declare function withWorkspaceNodeModulesOwnership(options?: {
-    workspaceDir?: string;
-    usernameExpr?: string;
-    order?: number;
-}): LayerWriter;
-export declare function withVsCodeJsDebugBootloaderFix(options?: {
-    bashrcPath?: string;
-    order?: number;
-}): LayerWriter;
-export declare class DockerfileModel implements KeyedModel {
-    readonly key: string;
-    private readonly _steps;
-    private readonly _layerWriters;
-    private _fromImage;
-    private _layerCounter;
-    private _existing;
-    constructor(baseImage: string);
-    /**
-     * Load an existing Dockerfile so `decohere add api` can append feature layers.
-     * The new steps are appended as one block, unless the file already contains it.
-     */
-    static fromFile(absolutePath: string, filePath: string): DockerfileModel;
-    from(baseImage: string): this;
-    addLayer(layer: LayerWriter | string, order?: 5000): this;
-    addStep(step: DockerStep): this;
-    removeStep(key: string): this;
-    entrypoint(value: string | readonly string[], order?: 10000): this;
-    addRunStep(cmd: string): this;
-    build(): string;
-    protected registerBaseLayers(): void;
-    files(): SourceFile[];
-}
-/**
- * Shared layers for the published `ghcr.io/typesmiths/decohere/devcontainer` image.
- * Checked in at `projects/devcontainer/Dockerfile` — keep in sync via the unit test.
- */
-export declare class AppDevContainerBaseImage extends DockerfileModel {
-    protected registerBaseLayers(): void;
-}
-/** Generic Dev Container image helpers (history + bootloader) without webapi defaults. */
-export declare class DevContainerImageModel extends DockerfileModel {
-    protected registerBaseLayers(): void;
-    files(): SourceFile[];
-}

package/types/src/models/env-file.model.d.ts

@@ -1,16 +0,0 @@
-import type { KeyedModel, SourceFile } from "./source-file.js";
-/**
- * Accumulates key=value pairs and renders them as a `.env` file.
- *
- * Register once in the workspace; features call `addEntry` during their
- * scaffold phase to contribute environment variables. The final file is
- * written at render time when `workspace.scaffold()` is called.
- */
-export declare class EnvFile implements KeyedModel {
-    readonly key: string;
-    private readonly _entries;
-    addEntry(key: string, value: string): this;
-    hasEntry(key: string): boolean;
-    static fromFile(absolutePath: string): EnvFile;
-    files(): SourceFile[];
-}

package/types/src/models/gitignore.model.d.ts

@@ -1,9 +0,0 @@
-import type { KeyedModel, SourceFile } from "./source-file.js";
-export declare class Gitignore implements KeyedModel {
-    readonly key: string;
-    private ignoreList;
-    /** Load an existing .gitignore so `decohere add api` appends instead of replacing. */
-    static fromFile(absolutePath: string): Gitignore;
-    add(...patterns: string[]): this;
-    files(): SourceFile[];
-}

package/types/src/models/launch-json.model.d.ts

@@ -1,7 +0,0 @@
-import type { KeyedModel, SourceFile } from "./source-file.js";
-export declare class LaunchJson implements KeyedModel {
-    private readonly apiNames;
-    readonly key: string;
-    constructor(apiNames?: readonly string[]);
-    files(): SourceFile[];
-}

package/types/src/models/package-json.model.d.ts

@@ -1,36 +0,0 @@
-import type { KeyedModel, SourceFile } from "./source-file.js";
-export type PackageJsonOptions = {
-    startEntry?: string;
-    /** API slugs in this workspace. Drives `start:<name>` / `dev:<name>`. */
-    apiNames?: readonly string[];
-    /** Host workspace name used in `@<workspace>/<api>` for flux `--project`. */
-    workspaceName?: string;
-};
-/**
- * Builder for the root `package.json`.
- *
- * Starts with the core API dependencies. Features call `addDependency` /
- * `addDevDependency` during their scaffold phase to inject their own deps
- * before `files()` is called at render time.
- */
-export declare class PackageJson implements KeyedModel {
-    private readonly name;
-    readonly key: string;
-    private _dependencies;
-    private _devDependencies;
-    private _scripts;
-    private _version;
-    private _type;
-    private _rest;
-    constructor(name: string, options?: PackageJsonOptions);
-    /** Load an existing root package.json so `webapi add` can merge scripts/deps. */
-    static fromFile(filePath: string): PackageJson;
-    addDependency(name: string, version: string): this;
-    addDevDependency(name: string, version: string): this;
-    addScript(name: string, command: string): this;
-    hasScript(name: string): boolean;
-    files(): SourceFile[];
-}
-/** Stable A→Z key order for package.json dependency maps. */
-export declare function sortStringMap(map: Record<string, string>): Record<string, string>;
-export declare function packageScript(workspaceName: string, apiName: string): string;