@acta-dev/cli 1.3.0 → 1.5.0

package/dist/index.js

@@ -223,7 +223,7 @@ var graphCommand = defineCommand2({
 
 // src/commands/init.ts
 import { existsSync as existsSync3 } from "fs";
-import { mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
+import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
 import { join as join3, resolve as resolve2 } from "path";
 import { createInterface } from "readline";
 import { resolveConfig as resolveConfig3 } from "@acta-dev/core";
@@ -418,6 +418,187 @@ async function installAgentSkill(cwd, format) {
   return format === "both" ? { skillPaths, agentsPath: join2(cwd, "AGENTS.md") } : { skillPaths };
 }
 
+// src/commands/deploy-workflows.ts
+var DEPLOY_PROVIDERS = ["pages", "cloudflare", "vercel", "netlify"];
+var DEPLOY_WORKFLOW_TEMPLATES = {
+  pages: `name: Deploy Acta Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: acta-pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build Acta static viewer
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Build Acta site
+        run: pnpm dlx @acta-dev/cli site --base "/\${{ github.event.repository.name }}"
+
+      - name: Configure Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: .acta/site
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: \${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+`,
+  cloudflare: `name: Deploy Acta to Cloudflare Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  deploy:
+    name: Deploy Acta static viewer
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Build Acta site
+        run: pnpm dlx @acta-dev/cli site
+
+      - name: Deploy to Cloudflare Pages
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: \${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: \${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          command: pages deploy .acta/site --project-name="\${{ vars.CLOUDFLARE_PROJECT_NAME }}"
+`,
+  vercel: `name: Deploy Acta to Vercel
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  deploy:
+    name: Deploy Acta static viewer
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Build Acta site
+        run: pnpm dlx @acta-dev/cli site
+
+      - name: Deploy to Vercel
+        run: pnpm dlx vercel .acta/site --prod --yes --token="\${{ secrets.VERCEL_TOKEN }}"
+        env:
+          VERCEL_ORG_ID: \${{ secrets.VERCEL_ORG_ID }}
+          VERCEL_PROJECT_ID: \${{ secrets.VERCEL_PROJECT_ID }}
+`,
+  netlify: `name: Deploy Acta to Netlify
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  deploy:
+    name: Deploy Acta static viewer
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Build Acta site
+        run: pnpm dlx @acta-dev/cli site
+
+      - name: Deploy to Netlify
+        run: pnpm dlx netlify-cli deploy --dir=.acta/site --prod
+        env:
+          NETLIFY_AUTH_TOKEN: \${{ secrets.NETLIFY_AUTH_TOKEN }}
+          NETLIFY_SITE_ID: \${{ secrets.NETLIFY_SITE_ID }}
+`
+};
+function isDeployProvider(value) {
+  return DEPLOY_PROVIDERS.includes(value);
+}
+
 // src/commands/init.ts
 var ADR_TEMPLATE = `---
 id: ADR-0000
@@ -585,6 +766,11 @@ jobs:
       - name: Build Acta artifacts
         run: pnpm exec acta build
 `;
+var ACTA_MCP_SERVER_CONFIG = {
+  command: "npx",
+  args: ["-y", "@acta-dev/mcp-server"],
+  env: {}
+};
 async function confirm(message) {
   return new Promise((resolvePromise) => {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -631,11 +817,20 @@ var initCommand = defineCommand3({
       description: "Install GitHub Actions workflow template",
       default: false
     },
+    deploy: {
+      type: "string",
+      description: "Install a deploy workflow template: pages, cloudflare, vercel or netlify"
+    },
     skill: {
       type: "boolean",
       description: "Compatibility alias for `acta skill --init` after scaffolding",
       default: false
     },
+    mcp: {
+      type: "boolean",
+      description: "Install an MCP server config for acta-mcp",
+      default: false
+    },
     config: {
       type: "string",
       alias: "c",
@@ -645,6 +840,10 @@ var initCommand = defineCommand3({
   async run({ args }) {
     const cwd = resolve2(process.cwd());
     const yes = args.yes;
+    const deploy = args.deploy;
+    if (deploy !== void 0 && !isDeployProvider(deploy)) {
+      return exitUsage(`Expected --deploy to be one of: ${DEPLOY_PROVIDERS.join(", ")}.`);
+    }
     const config = resolveConfig3({}, { rootDir: cwd });
     printLine("Initializing Acta docs structure...");
     printLine();
@@ -668,8 +867,8 @@ var initCommand = defineCommand3({
     if (specWritten) printSuccess(`Created ${specTplPath}`);
     const gitignorePath = join3(cwd, ".gitignore");
     if (existsSync3(gitignorePath)) {
-      const { readFile: readFile4, appendFile } = await import("fs/promises");
-      const content = await readFile4(gitignorePath, "utf8");
+      const { appendFile } = await import("fs/promises");
+      const content = await readFile2(gitignorePath, "utf8");
       if (!content.includes(".acta/")) {
         await appendFile(gitignorePath, "\n# Acta build artifacts\n.acta/\n");
         printSuccess(`Added .acta/ to .gitignore`);
@@ -687,6 +886,17 @@ var initCommand = defineCommand3({
       const workflowWritten = await safeWriteFile(workflowPath, GITHUB_ACTION_TEMPLATE, yes);
       if (workflowWritten) printSuccess(`Created ${workflowPath}`);
     }
+    if (deploy !== void 0) {
+      const workflowsDir = join3(cwd, ".github", "workflows");
+      await mkdir2(workflowsDir, { recursive: true });
+      const workflowPath = join3(workflowsDir, `acta-deploy-${deploy}.yml`);
+      const workflowWritten = await safeWriteFile(
+        workflowPath,
+        DEPLOY_WORKFLOW_TEMPLATES[deploy],
+        yes
+      );
+      if (workflowWritten) printSuccess(`Created ${workflowPath}`);
+    }
     if (args.skill) {
       const result = await installAgentSkill(cwd, "both");
       for (const skillPath of result.skillPaths) {
@@ -696,10 +906,30 @@ var initCommand = defineCommand3({
         printSuccess(`Updated ${result.agentsPath} with Acta agent guidance`);
       }
     }
+    if (args.mcp) {
+      const mcpPath = join3(cwd, ".mcp.json");
+      await installMcpConfig(mcpPath);
+      printSuccess(`Updated ${mcpPath} with Acta MCP server config`);
+    }
     printLine();
     printSuccess("Acta initialized. Run `acta validate` to check your documents.");
   }
 });
+async function installMcpConfig(path) {
+  const existing = existsSync3(path) ? JSON.parse(await readFile2(path, "utf8")) : {};
+  const next = {
+    ...existing,
+    mcpServers: {
+      ...isRecord(existing.mcpServers) ? existing.mcpServers : {},
+      acta: ACTA_MCP_SERVER_CONFIG
+    }
+  };
+  await writeFile2(path, `${JSON.stringify(next, null, 2)}
+`, "utf8");
+}
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 
 // src/commands/list.ts
 import { loadProject as loadProject2 } from "@acta-dev/core";
@@ -831,11 +1061,11 @@ function titleToSlug(title) {
 }
 
 // src/template.ts
-import { readFile as readFile2 } from "fs/promises";
+import { readFile as readFile3 } from "fs/promises";
 import { join as join4 } from "path";
 async function renderTemplate(kind, vars, config) {
   const templateFile = join4(config.resolvedDocs.templatesDir, `${kind}.md`);
-  const raw = await readFile2(templateFile, "utf8");
+  const raw = await readFile3(templateFile, "utf8");
   return interpolate(raw, vars);
 }
 function interpolate(raw, vars) {
@@ -997,7 +1227,7 @@ function parseTags(value) {
 }
 
 // src/commands/renumber.ts
-import { readFile as readFile3, rename, writeFile as writeFile4 } from "fs/promises";
+import { readFile as readFile4, rename, writeFile as writeFile4 } from "fs/promises";
 import { basename, dirname, join as join6 } from "path";
 import { internalLinkKeys as internalLinkKeys2, loadProject as loadProject3 } from "@acta-dev/core";
 import { defineCommand as defineCommand6 } from "citty";
@@ -1033,7 +1263,7 @@ function buildRenumberPlan(fromId, toId, project) {
   };
 }
 async function rewriteDocument(filePath, oldId, newId, isTarget) {
-  const raw = await readFile3(filePath, "utf8");
+  const raw = await readFile4(filePath, "utf8");
   const match = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
   if (!match) {
     throw new Error(`Cannot parse frontmatter in ${filePath}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acta-dev/cli",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "Acta CLI — TypeScript-first docs-as-code tooling for ADR and spec documents in Git. Provides the `acta` binary.",
   "keywords": [
     "adr",
@@ -45,8 +45,8 @@
     "citty": "^0.2.2",
     "kleur": "^4.1.5",
     "yaml": "^2.8.3",
-    "@acta-dev/core": "1.1.0",
-    "@acta-dev/web": "1.0.0"
+    "@acta-dev/core": "1.2.0",
+    "@acta-dev/web": "1.0.1"
   },
   "devDependencies": {
     "execa": "^9.6.1",