berg-pages 0.1.0-alpha.6

package/dist/core/plans/plan-step.d.ts

@@ -0,0 +1,59 @@
+import type { DeployModeId } from "../entities/deploy-mode.js";
+import type { PagesTarget } from "../entities/pages-target.js";
+import type { AssumptionStatus } from "./assumption.js";
+export interface PlanStepBase {
+    id: string;
+    title: string;
+    detail?: string;
+}
+export interface VerifyStep extends PlanStepBase {
+    kind: "verify";
+    subject: string;
+    status: AssumptionStatus;
+    expected?: string;
+}
+export interface EnsureDirectoryStep extends PlanStepBase {
+    kind: "ensure-directory";
+    path: string;
+    reason: string;
+}
+export interface WriteFileStep extends PlanStepBase {
+    kind: "write-file";
+    path: string;
+    content: string;
+    mode: "create" | "overwrite" | "merge";
+    reason: string;
+}
+export interface DeleteFileStep extends PlanStepBase {
+    kind: "delete-file";
+    path: string;
+    reason: string;
+}
+export interface RunCommandStep extends PlanStepBase {
+    kind: "run-command";
+    executable: string;
+    args: string[];
+    cwd?: string;
+    reason: string;
+}
+export interface PublishSiteStep extends PlanStepBase {
+    kind: "publish-site";
+    modeId: DeployModeId;
+    targetKind: PagesTarget["kind"];
+    outputDir: string;
+    sourcePath: string;
+    destination: string;
+    remote: string;
+    branch: string;
+    force: boolean;
+    operations: string[];
+}
+export interface NoteStep extends PlanStepBase {
+    kind: "note";
+    category: "framework" | "deployment" | "docs" | "setup";
+    message: string;
+}
+export type PlanStep = VerifyStep | EnsureDirectoryStep | WriteFileStep | DeleteFileStep | RunCommandStep | PublishSiteStep | NoteStep;
+export type BuildPlanStep = RunCommandStep | VerifyStep | NoteStep;
+export type DeployPlanStep = PublishSiteStep | RunCommandStep | VerifyStep | NoteStep;
+export type TemplatePlanStep = EnsureDirectoryStep | WriteFileStep | DeleteFileStep;

package/dist/core/plans/plan-step.js

@@ -0,0 +1 @@
+export {};

package/dist/core/plans/template-plan.d.ts

@@ -0,0 +1,11 @@
+export type TemplatePlan = {
+    kind: "file";
+    path: string;
+    content: string;
+    mode: "create" | "overwrite" | "merge";
+    reason: string;
+} | {
+    kind: "directory";
+    path: string;
+    reason: string;
+};

package/dist/core/plans/template-plan.js

@@ -0,0 +1 @@
+export {};

package/dist/features/deployment-modes/git-pages-deploy-mode-plugin.d.ts

@@ -0,0 +1,12 @@
+import type { DeployExecutionPorts, DeployModePlugin } from "../../application/contracts/plugins/deploy-mode-plugin.js";
+import type { Diagnostic } from "../../core/diagnostics/diagnostic.js";
+import type { PagesTarget } from "../../core/entities/pages-target.js";
+import type { Project } from "../../core/entities/project.js";
+import type { DeployPlan, DeployResult } from "../../core/plans/deploy-plan.js";
+export declare class GitPagesDeployModePlugin implements DeployModePlugin {
+    readonly id = "git-pages";
+    supports(target: PagesTarget): boolean;
+    getDiagnostics(project: Project): Diagnostic[];
+    getDeployPlan(project: Project): DeployPlan;
+    execute(_plan: DeployPlan, _ports: DeployExecutionPorts): Promise<DeployResult>;
+}

package/dist/features/deployment-modes/git-pages-deploy-mode-plugin.js

@@ -0,0 +1,49 @@
+export class GitPagesDeployModePlugin {
+    id = "git-pages";
+    supports(target) {
+        return target.kind === "codeberg-project";
+    }
+    getDiagnostics(project) {
+        if (project.pages.target && !this.supports(project.pages.target)) {
+            return [
+                {
+                    code: "deploy-mode.git-pages.unsupported-target",
+                    severity: "warning",
+                    summary: "The git-pages deployment mode only supports Codeberg project Pages in M2.",
+                    detail: "This first slice is intentionally limited to one Codeberg project-site path.",
+                    suggestions: [
+                        "Use a Codeberg project Pages target for the M2 slice.",
+                        "Delay broader target support until after init --apply and deploy exist."
+                    ],
+                    source: "deploy-mode-plugin"
+                }
+            ];
+        }
+        return [];
+    }
+    getDeployPlan(project) {
+        return {
+            modeId: this.id,
+            summary: "Publish the generated site through the planned git-pages workflow.",
+            ...(project.pages.target ? { target: project.pages.target } : {}),
+            assumptions: project.pages.target
+                ? [
+                    {
+                        code: "deploy.git-pages.target",
+                        summary: "The git-pages deployment target is known.",
+                        status: "confirmed",
+                        detail: `Target URL: ${project.pages.target.url}`
+                    }
+                ]
+                : [],
+            diagnostics: [],
+            steps: []
+        };
+    }
+    async execute(_plan, _ports) {
+        return {
+            appliedStepIds: [],
+            diagnostics: []
+        };
+    }
+}

package/dist/features/frameworks/astro-framework-plugin.d.ts

@@ -0,0 +1,36 @@
+import type { FrameworkPlugin } from "../../application/contracts/plugins/framework-plugin.js";
+import type { DetectionResult } from "../../application/contracts/plugins/framework-plugin.js";
+import type { ProjectContext } from "../../application/contracts/project-context.js";
+import type { Project } from "../../core/entities/project.js";
+import type { Diagnostic } from "../../core/diagnostics/diagnostic.js";
+export declare class AstroFrameworkPlugin implements FrameworkPlugin {
+    readonly id = "astro";
+    detect(context: ProjectContext): Promise<DetectionResult>;
+    getBuildPlan(project: Project): {
+        frameworkId: string;
+        summary: string;
+        outputDir: string;
+        assumptions: {
+            code: string;
+            summary: string;
+            status: "confirmed";
+            detail: string;
+        }[];
+        diagnostics: never[];
+        steps: never[];
+    };
+    getInitTemplates(project: Project): ({
+        kind: "directory";
+        path: string;
+        reason: string;
+        mode?: never;
+        content?: never;
+    } | {
+        kind: "file";
+        path: string;
+        mode: "create";
+        reason: string;
+        content: string;
+    })[];
+    getDiagnostics(project: Project): Diagnostic[];
+}

package/dist/features/frameworks/astro-framework-plugin.js

@@ -0,0 +1,97 @@
+export class AstroFrameworkPlugin {
+    id = "astro";
+    async detect(context) {
+        const detectedConfigFiles = context.project.paths.detectedConfigFiles ?? [];
+        const hasAstroConfig = detectedConfigFiles.some((file) => file.startsWith("astro.config."));
+        return {
+            matches: context.project.framework?.id === this.id || hasAstroConfig,
+            confidence: hasAstroConfig ? "high" : context.project.framework?.id === this.id ? "medium" : "low",
+            reasons: hasAstroConfig ? ["Detected Astro config file in the project root."] : [],
+            ...(context.project.framework?.id === this.id || hasAstroConfig
+                ? { detectedFrameworkId: this.id }
+                : {})
+        };
+    }
+    getBuildPlan(project) {
+        const outputDir = project.paths.buildOutputDir ?? "dist";
+        return {
+            frameworkId: this.id,
+            summary: "Build the site with Astro and publish the generated dist directory.",
+            outputDir,
+            assumptions: [
+                {
+                    code: "framework.astro.output-dir",
+                    summary: "Astro writes static builds to dist by default.",
+                    status: "confirmed",
+                    detail: `Expected output directory: ${outputDir}`
+                }
+            ],
+            diagnostics: [],
+            steps: []
+        };
+    }
+    getInitTemplates(project) {
+        const targetUrl = project.pages.target?.url ?? "https://example.codeberg.page/project/";
+        const basePath = project.pages.target?.kind === "codeberg-project"
+            ? project.pages.target.basePath
+            : `/${project.repository.name}/`;
+        return [
+            {
+                kind: "directory",
+                path: ".forgejo/workflows",
+                reason: "Forgejo workflow files are stored under .forgejo/workflows."
+            },
+            {
+                kind: "file",
+                path: ".forgejo/workflows/pages.yml",
+                mode: "create",
+                reason: "Add the planned git-pages workflow for an Astro project on Codeberg Pages.",
+                content: [
+                    "name: pages",
+                    "",
+                    "on:",
+                    "  push:",
+                    "    branches:",
+                    "      - main",
+                    "",
+                    "jobs:",
+                    "  build:",
+                    "    runs-on: ubuntu-latest",
+                    "    steps:",
+                    "      - name: Checkout",
+                    "        uses: actions/checkout@v4",
+                    "      - name: Setup Node",
+                    "        uses: actions/setup-node@v4",
+                    "        with:",
+                    "          node-version: 20",
+                    "      - name: Install dependencies",
+                    "        run: npm ci",
+                    "      - name: Build site",
+                    "        run: npm run build",
+                    "        env:",
+                    `          BERG_PAGES_BASE_PATH: ${basePath}`,
+                    "      - name: Publish preview",
+                    `        run: echo \"Publish dist to ${targetUrl} via git-pages\"`,
+                    ""
+                ].join("\n")
+            }
+        ];
+    }
+    getDiagnostics(project) {
+        const diagnostics = [];
+        if (project.framework?.id === this.id && !project.paths.detectedConfigFiles?.some((file) => file.startsWith("astro.config."))) {
+            diagnostics.push({
+                code: "framework.astro.config.missing",
+                severity: "warning",
+                summary: "The project is marked as Astro, but no Astro config file was detected.",
+                detail: "M11 can detect Astro from package signals, but an Astro config gives stronger confirmation.",
+                suggestions: [
+                    "Check for an astro.config file.",
+                    "Confirm package.json dependencies and scripts if the config is intentionally absent."
+                ],
+                source: "framework-plugin"
+            });
+        }
+        return diagnostics;
+    }
+}

package/dist/features/frameworks/static-html-framework-plugin.d.ts

@@ -0,0 +1,36 @@
+import type { FrameworkPlugin } from "../../application/contracts/plugins/framework-plugin.js";
+import type { DetectionResult } from "../../application/contracts/plugins/framework-plugin.js";
+import type { ProjectContext } from "../../application/contracts/project-context.js";
+import type { Project } from "../../core/entities/project.js";
+import type { Diagnostic } from "../../core/diagnostics/diagnostic.js";
+export declare class StaticHtmlFrameworkPlugin implements FrameworkPlugin {
+    readonly id = "static-html";
+    detect(context: ProjectContext): Promise<DetectionResult>;
+    getBuildPlan(project: Project): {
+        frameworkId: string;
+        summary: string;
+        outputDir: string;
+        assumptions: {
+            code: string;
+            summary: string;
+            status: "confirmed" | "unverified";
+            detail: string;
+        }[];
+        diagnostics: never[];
+        steps: never[];
+    };
+    getInitTemplates(project: Project): ({
+        kind: "directory";
+        path: string;
+        reason: string;
+        mode?: never;
+        content?: never;
+    } | {
+        kind: "file";
+        path: string;
+        mode: "create";
+        reason: string;
+        content: string;
+    })[];
+    getDiagnostics(project: Project): Diagnostic[];
+}

package/dist/features/frameworks/static-html-framework-plugin.js

@@ -0,0 +1,94 @@
+export class StaticHtmlFrameworkPlugin {
+    id = "static-html";
+    async detect(context) {
+        const outputDir = resolveStaticOutputDir(context.project);
+        return {
+            matches: context.project.framework?.id === this.id || outputDir !== undefined,
+            confidence: context.project.framework?.id === this.id ? "medium" : outputDir ? "medium" : "low",
+            reasons: outputDir ? [`Detected static publish directory: ${outputDir}.`] : [],
+            ...(context.project.framework?.id === this.id || outputDir
+                ? { detectedFrameworkId: this.id }
+                : {})
+        };
+    }
+    getBuildPlan(project) {
+        const outputDir = project.paths.buildOutputDir ?? resolveStaticOutputDir(project) ?? "public";
+        return {
+            frameworkId: this.id,
+            summary: "Publish an existing plain static HTML directory without running a build.",
+            outputDir,
+            assumptions: [
+                {
+                    code: "framework.static-html.output-dir",
+                    summary: "Plain static sites publish an existing output directory.",
+                    status: project.paths.buildOutputDirExists === true ? "confirmed" : "unverified",
+                    detail: `Expected static output directory: ${outputDir}`
+                }
+            ],
+            diagnostics: [],
+            steps: []
+        };
+    }
+    getInitTemplates(project) {
+        const outputDir = project.paths.buildOutputDir ?? resolveStaticOutputDir(project) ?? "public";
+        const targetUrl = project.pages.target?.url ?? "https://example.codeberg.page/project/";
+        return [
+            {
+                kind: "directory",
+                path: ".forgejo/workflows",
+                reason: "Forgejo workflow files are stored under .forgejo/workflows."
+            },
+            {
+                kind: "file",
+                path: ".forgejo/workflows/pages.yml",
+                mode: "create",
+                reason: "Add the planned git-pages workflow for a plain static site on Codeberg Pages.",
+                content: [
+                    "name: pages",
+                    "",
+                    "on:",
+                    "  push:",
+                    "    branches:",
+                    "      - main",
+                    "",
+                    "jobs:",
+                    "  publish:",
+                    "    runs-on: ubuntu-latest",
+                    "    steps:",
+                    "      - name: Checkout",
+                    "        uses: actions/checkout@v4",
+                    "      - name: Publish static site",
+                    `        run: echo \"Publish ${outputDir} to ${targetUrl} via git-pages\"`,
+                    ""
+                ].join("\n")
+            }
+        ];
+    }
+    getDiagnostics(project) {
+        if (!project.paths.buildOutputDir) {
+            return [
+                {
+                    code: "framework.static-html.output-dir.missing",
+                    severity: "warning",
+                    summary: "No plain static publish directory was detected.",
+                    detail: "M10 static support expects a publishable dist or public directory.",
+                    suggestions: [
+                        "Create a public directory for hand-written static HTML.",
+                        "Create a dist directory if the site is already built elsewhere."
+                    ],
+                    source: "framework-plugin"
+                }
+            ];
+        }
+        return [];
+    }
+}
+function resolveStaticOutputDir(project) {
+    if (project.paths.detectedBuildOutputDirs?.includes("dist")) {
+        return "dist";
+    }
+    if (project.paths.detectedBuildOutputDirs?.includes("public")) {
+        return "public";
+    }
+    return undefined;
+}

package/dist/features/frameworks/vite-framework-plugin.d.ts

@@ -0,0 +1,36 @@
+import type { FrameworkPlugin } from "../../application/contracts/plugins/framework-plugin.js";
+import type { ProjectContext } from "../../application/contracts/project-context.js";
+import type { Project } from "../../core/entities/project.js";
+import type { DetectionResult } from "../../application/contracts/plugins/framework-plugin.js";
+import type { Diagnostic } from "../../core/diagnostics/diagnostic.js";
+export declare class ViteFrameworkPlugin implements FrameworkPlugin {
+    readonly id = "vite";
+    detect(context: ProjectContext): Promise<DetectionResult>;
+    getBuildPlan(project: Project): {
+        frameworkId: string;
+        summary: string;
+        outputDir: string;
+        assumptions: {
+            code: string;
+            summary: string;
+            status: "confirmed";
+            detail: string;
+        }[];
+        diagnostics: never[];
+        steps: never[];
+    };
+    getInitTemplates(project: Project): ({
+        kind: "directory";
+        path: string;
+        reason: string;
+        mode?: never;
+        content?: never;
+    } | {
+        kind: "file";
+        path: string;
+        mode: "create";
+        reason: string;
+        content: string;
+    })[];
+    getDiagnostics(project: Project): Diagnostic[];
+}

package/dist/features/frameworks/vite-framework-plugin.js

@@ -0,0 +1,97 @@
+export class ViteFrameworkPlugin {
+    id = "vite";
+    async detect(context) {
+        const detectedConfigFiles = context.project.paths.detectedConfigFiles ?? [];
+        const hasViteConfig = detectedConfigFiles.some((file) => file.startsWith("vite.config."));
+        return {
+            matches: context.project.framework?.id === this.id || hasViteConfig,
+            confidence: hasViteConfig ? "high" : context.project.framework?.id === this.id ? "medium" : "low",
+            reasons: hasViteConfig ? ["Detected Vite config file in the project root."] : [],
+            ...(context.project.framework?.id === this.id || hasViteConfig
+                ? { detectedFrameworkId: this.id }
+                : {})
+        };
+    }
+    getBuildPlan(project) {
+        const outputDir = project.paths.buildOutputDir ?? "dist";
+        return {
+            frameworkId: this.id,
+            summary: "Build the site with Vite and publish the generated dist directory.",
+            outputDir,
+            assumptions: [
+                {
+                    code: "framework.vite.output-dir",
+                    summary: "Vite writes the built site to dist.",
+                    status: "confirmed",
+                    detail: `Expected output directory: ${outputDir}`
+                }
+            ],
+            diagnostics: [],
+            steps: []
+        };
+    }
+    getInitTemplates(project) {
+        const targetUrl = project.pages.target?.url ?? "https://example.codeberg.page/project/";
+        const basePath = project.pages.target?.kind === "codeberg-project"
+            ? project.pages.target.basePath
+            : `/${project.repository.name}/`;
+        return [
+            {
+                kind: "directory",
+                path: ".forgejo/workflows",
+                reason: "Forgejo workflow files are stored under .forgejo/workflows."
+            },
+            {
+                kind: "file",
+                path: ".forgejo/workflows/pages.yml",
+                mode: "create",
+                reason: "Add the planned git-pages workflow for a Vite project on Codeberg Pages.",
+                content: [
+                    "name: pages",
+                    "",
+                    "on:",
+                    "  push:",
+                    "    branches:",
+                    "      - main",
+                    "",
+                    "jobs:",
+                    "  build:",
+                    "    runs-on: ubuntu-latest",
+                    "    steps:",
+                    "      - name: Checkout",
+                    "        uses: actions/checkout@v4",
+                    "      - name: Setup Node",
+                    "        uses: actions/setup-node@v4",
+                    "        with:",
+                    "          node-version: 20",
+                    "      - name: Install dependencies",
+                    "        run: npm ci",
+                    "      - name: Build site",
+                    "        run: npm run build",
+                    "        env:",
+                    `          BERG_PAGES_BASE_PATH: ${basePath}`,
+                    "      - name: Publish preview",
+                    `        run: echo \"Publish dist to ${targetUrl} via git-pages\"`,
+                    ""
+                ].join("\n")
+            }
+        ];
+    }
+    getDiagnostics(project) {
+        const diagnostics = [];
+        if (project.framework?.id === this.id && !project.paths.detectedConfigFiles?.some((file) => file.startsWith("vite.config."))) {
+            diagnostics.push({
+                code: "framework.vite.config.missing",
+                severity: "warning",
+                summary: "The project is marked as Vite, but no Vite config file was detected.",
+                detail: "M2 currently expects a recognizable Vite project shape.",
+                suggestions: [
+                    "Add a vite.config file or adjust framework detection.",
+                    "Keep the first slice constrained to the supported Vite path."
+                ],
+                source: "framework-plugin"
+            });
+        }
+        return diagnostics;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./application/index.js";
+export * from "./core/index.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./application/index.js";
+export * from "./core/index.js";

package/dist/interfaces/cli/main.d.ts

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