@mauvezero/azpipe-cli 0.3.0 → 0.5.0

package/dist/bin.js

@@ -2,6 +2,8 @@
 import { runBuild } from './cmd-build.js';
 import { runBuildImport } from './cmd-build-import.js';
 import { runRelease } from './cmd-release.js';
+import { runBootstrap } from './cmd-bootstrap.js';
+import { runGha } from './cmd-gha-import.js';
 function topLevelUsage() {
     console.log(`azpipe <command> [options]
 
@@ -12,6 +14,8 @@ Commands:
   release diff <entry.ts>    Show what \`push\` would change
   release push <entry.ts>    Diff-first PUT (interactive by default)
   release import <json>      Convert a classic-release JSON to TypeScript
+  gha import <workflow.yml>  Convert a GitHub Actions workflow to TypeScript
+  bootstrap                  Scaffold a pipelines/ directory in the current repo
 
 Run \`azpipe <command> --help\` for command-specific options.`);
 }
@@ -34,6 +38,12 @@ async function main() {
         case 'release':
             await runRelease(argv.slice(1));
             return;
+        case 'gha':
+            await runGha(argv.slice(1));
+            return;
+        case 'bootstrap':
+            await runBootstrap(argv.slice(1));
+            return;
         default:
             console.error(`Unknown command: ${command}`);
             topLevelUsage();

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,SAAS,aAAa;IACpB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;8DAUgD,CAAC,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzD,aAAa,EAAE,CAAC;QAChB,OAAO;IACT,CAAC;IACD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACzB,MAAM,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;YACD,OAAO;QACT,KAAK,SAAS;YACZ,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,OAAO;QACT;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC7C,aAAa,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,SAAS,aAAa;IACpB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;8DAYgD,CAAC,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzD,aAAa,EAAE,CAAC;QAChB,OAAO;IACT,CAAC;IACD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACzB,MAAM,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;YACD,OAAO;QACT,KAAK,SAAS;YACZ,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,OAAO;QACT,KAAK,KAAK;YACR,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,OAAO;QACT,KAAK,WAAW;YACd,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,OAAO;QACT;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC7C,aAAa,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cmd-bootstrap.d.ts

@@ -0,0 +1,2 @@
+export declare function runBootstrap(argv: string[]): Promise<void>;
+//# sourceMappingURL=cmd-bootstrap.d.ts.map

package/dist/cmd-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-bootstrap.d.ts","sourceRoot":"","sources":["../src/cmd-bootstrap.ts"],"names":[],"mappings":"AAoYA,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6KhE"}

package/dist/cmd-bootstrap.js

@@ -0,0 +1,510 @@
+import { execSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { createInterface } from 'node:readline';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { yamlToTs } from '@mauvezero/azpipe-convert';
+// ---------------------------------------------------------------------------
+// CLI version — stamped into generated package.json
+// ---------------------------------------------------------------------------
+const here = dirname(fileURLToPath(import.meta.url));
+const cliPkgJson = JSON.parse(readFileSync(resolve(here, '../package.json'), 'utf8'));
+const CLI_VERSION = cliPkgJson.version;
+function parseArgs(argv) {
+    const opts = { yes: false, outDir: 'pipelines', help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '-h' || a === '--help')
+            opts.help = true;
+        else if (a === '--yes' || a === '-y')
+            opts.yes = true;
+        else if (a === '--out' || a === '-o')
+            opts.outDir = argv[++i] ?? opts.outDir;
+        else if (a.startsWith('-'))
+            throw new Error(`Unknown flag: ${a}`);
+    }
+    return opts;
+}
+function usage() {
+    console.log(`azpipe bootstrap [options]
+
+Scaffold a pipelines/ directory in the current git repo with:
+  - pipelines/package.json       (build / diff / push scripts)
+  - pipelines/tsconfig.json
+  - pipelines/README.md
+  - pipelines/azure-pipelines.ts (CI pipeline, converted from root yml if present)
+  - pipelines/release.ts         (release definition stub)
+  - pipelines/release-sync.yml   (YAML pipeline to diff/push releases)
+  - <root>/azure-pipelines.yml   (generated from azure-pipelines.ts)
+
+Options:
+  -o, --out <dir>   Output directory relative to git root (default: pipelines)
+  -y, --yes         Accept all defaults, skip interactive prompts
+  -h, --help        Show this help`);
+}
+// ---------------------------------------------------------------------------
+// Git helpers
+// ---------------------------------------------------------------------------
+function findGitRoot(from) {
+    let dir = isAbsolute(from) ? from : resolve(process.cwd(), from);
+    while (true) {
+        if (existsSync(join(dir, '.git')))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            throw new Error('Not inside a git repository.');
+        dir = parent;
+    }
+}
+function tryExec(cmd) {
+    try {
+        return execSync(cmd, { stdio: ['ignore', 'pipe', 'ignore'], encoding: 'utf8' }).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+function detectDefaultBranch() {
+    const ref = tryExec('git symbolic-ref refs/remotes/origin/HEAD');
+    if (ref) {
+        const m = ref.match(/refs\/remotes\/origin\/(.+)/);
+        if (m?.[1])
+            return m[1];
+    }
+    // Fallback: look for common branch names
+    const branches = tryExec('git branch -r');
+    if (branches?.includes('origin/main'))
+        return 'main';
+    if (branches?.includes('origin/master'))
+        return 'master';
+    return 'main';
+}
+function detectFromGitRemote() {
+    const remote = tryExec('git remote get-url origin');
+    if (!remote)
+        return {};
+    // HTTPS: https://dev.azure.com/ORG/PROJECT/_git/REPO
+    const httpsMatch = remote.match(/dev\.azure\.com\/([^/]+)\/([^/]+)/);
+    if (httpsMatch)
+        return { org: httpsMatch[1], project: httpsMatch[2] };
+    // SSH: git@ssh.dev.azure.com:v3/ORG/PROJECT/REPO
+    const sshMatch = remote.match(/v3\/([^/]+)\/([^/]+)/);
+    if (sshMatch)
+        return { org: sshMatch[1], project: sshMatch[2] };
+    return {};
+}
+function makePrompter(rl) {
+    const prompt = (question, defaultValue) => new Promise((resolve) => {
+        const suffix = defaultValue ? ` [${defaultValue}]` : '';
+        rl.question(`  ${question}${suffix}: `, (answer) => {
+            resolve(answer.trim() || defaultValue || '');
+        });
+    });
+    const yesNo = (question, defaultYes = true) => new Promise((resolve) => {
+        const suffix = defaultYes ? ' [Y/n]' : ' [y/N]';
+        rl.question(`  ${question}${suffix}: `, (answer) => {
+            const a = answer.trim().toLowerCase();
+            if (a === '')
+                resolve(defaultYes);
+            else
+                resolve(a === 'y' || a === 'yes');
+        });
+    });
+    return { prompt, yesNo };
+}
+// ---------------------------------------------------------------------------
+// Template generators
+// ---------------------------------------------------------------------------
+function packageJsonTemplate(org, project) {
+    void org;
+    void project; // Reserved for future use (e.g. to embed metadata)
+    const deps = {
+        '@mauvezero/azpipe': CLI_VERSION,
+        '@mauvezero/azpipe-releases': CLI_VERSION,
+        '@mauvezero/azpipe-tasks': CLI_VERSION,
+        '@mauvezero/azpipe-utils': CLI_VERSION,
+        '@mauvezero/azpipe-cli': CLI_VERSION,
+    };
+    const pkg = {
+        name: 'pipelines',
+        private: true,
+        type: 'module',
+        scripts: {
+            build: 'azpipe build azure-pipelines.ts --out ../azure-pipelines.yml',
+            diff: 'azpipe release diff release.ts',
+            'push:dry': 'azpipe release push release.ts --dry-run',
+            push: 'azpipe release push release.ts',
+        },
+        dependencies: deps,
+    };
+    return JSON.stringify(pkg, null, 2) + '\n';
+}
+function tsconfigTemplate() {
+    return JSON.stringify({
+        compilerOptions: {
+            target: 'ES2022',
+            module: 'NodeNext',
+            moduleResolution: 'NodeNext',
+            lib: ['ES2022'],
+            strict: true,
+            noUncheckedIndexedAccess: true,
+            noImplicitOverride: true,
+            esModuleInterop: true,
+            forceConsistentCasingInFileNames: true,
+            skipLibCheck: true,
+            noEmit: true,
+            resolveJsonModule: true,
+        },
+        include: ['**/*.ts'],
+    }, null, 2) + '\n';
+}
+function pipelineStubTemplate() {
+    return `import { pipeline, script, checkout } from '@mauvezero/azpipe';
+
+export default pipeline()
+  .name('CI $(Date:yyyyMMdd).$(Rev:r)')
+  .trigger({ branches: { include: ['main'] } })
+  .pr({ branches: { include: ['main'] } })
+  .pool({ vmImage: 'ubuntu-latest' })
+  .stage('Build', (s) =>
+    s.job('build', (j) =>
+      j
+        .step(checkout('self', { fetchDepth: 1 }))
+        .step(script('echo "Add your build steps here"', { displayName: 'Build' })),
+    ),
+  );
+`;
+}
+function releaseStubTemplate(org, project, releaseName) {
+    return `import { releasePipeline, buildArtifact } from '@mauvezero/azpipe-releases';
+
+// Replace definitionId with the ID of your Azure Pipelines build pipeline.
+const artifact = buildArtifact({
+  alias: 'drop',
+  definitionId: 0, // TODO: replace with your build pipeline's definition ID
+  defaultVersionType: 'latestType',
+  isPrimary: true,
+});
+
+export default releasePipeline({
+  org: '${org}',
+  project: '${project}',
+  name: '${releaseName}',
+  releaseNameFormat: 'Release-$(rev:r)',
+  description: 'Managed by azpipe.',
+})
+  .artifact(artifact)
+  .trigger(artifact)
+  .environment('staging', (e) =>
+    e.agentPhase((p) =>
+      p
+        .name('Deploy to staging')
+        .pool({ vmImage: 'ubuntu-latest' })
+        // TODO: add your deployment steps here
+    ),
+  );
+`;
+}
+function releaseSyncYmlTemplate(defaultBranch, syncPipelineName, org, project) {
+    return `# ============================================================
+# Source: pipelines/release-sync.yml
+# This file is NOT compiled from TypeScript — it IS the source.
+#
+# Pipeline name in Azure DevOps: ${syncPipelineName}
+#
+# After registering this pipeline in Azure DevOps, grant the
+# build service account "Release Definition Contributor" in:
+#   ${project} project → Project Settings → Permissions
+#   Search for: "${project} Build Service (${org})"
+# ============================================================
+name: ${syncPipelineName}
+
+trigger:
+  branches:
+    include:
+      - ${defaultBranch}
+  paths:
+    include:
+      - pipelines/**
+
+pr:
+  branches:
+    include:
+      - ${defaultBranch}
+  paths:
+    include:
+      - pipelines/**
+
+pool:
+  vmImage: ubuntu-latest
+
+variables:
+  AZURE_DEVOPS_ORG: '${org}'
+  AZURE_DEVOPS_PROJECT: '${project}'
+
+steps:
+  - checkout: self
+
+  - task: NodeTool@0
+    inputs:
+      versionSpec: '20.x'
+    displayName: Install Node
+
+  - script: npm ci
+    workingDirectory: pipelines
+    displayName: Install dependencies
+
+  - script: npx azpipe release diff release.ts
+    workingDirectory: pipelines
+    displayName: Diff release definitions
+    # Non-zero exit means drift detected. On a PR this is expected and informational.
+    continueOnError: true
+    env:
+      AZURE_DEVOPS_ORG: $(AZURE_DEVOPS_ORG)
+      AZURE_DEVOPS_PROJECT: $(AZURE_DEVOPS_PROJECT)
+      SYSTEM_ACCESSTOKEN: $(System.AccessToken)
+
+  - script: npx azpipe release push release.ts --yes
+    workingDirectory: pipelines
+    displayName: Push release definitions
+    # Only runs on the default branch, not on PRs.
+    condition: and(succeeded(), ne(variables['Build.Reason'], 'PullRequest'))
+    env:
+      AZURE_DEVOPS_ORG: $(AZURE_DEVOPS_ORG)
+      AZURE_DEVOPS_PROJECT: $(AZURE_DEVOPS_PROJECT)
+      SYSTEM_ACCESSTOKEN: $(System.AccessToken)
+`;
+}
+const GENERATED_BANNER = `# ============================================================
+# GENERATED FILE – do not edit by hand.
+# Source: pipelines/azure-pipelines.ts
+# Regenerate: cd pipelines && npm run build
+# ============================================================
+`;
+function readmeTemplate(org, project, syncPipelineName, defaultBranch) {
+    return `# pipelines/
+
+This directory is managed by [azpipe](https://github.com/mauve/releases).
+It contains TypeScript sources for Azure Pipelines CI and Classic Release definitions.
+
+## Contents
+
+| File | Description |
+|---|---|
+| \`azure-pipelines.ts\` | CI pipeline source (TypeScript) |
+| \`release.ts\` | Release definition source (TypeScript) |
+| \`release-sync.yml\` | Azure Pipelines YAML that diffs and pushes release definitions |
+| \`package.json\` | npm scripts to build, diff, and push |
+| \`tsconfig.json\` | TypeScript config (self-contained) |
+
+## Regenerate \`azure-pipelines.yml\`
+
+The root \`azure-pipelines.yml\` is **generated** from \`azure-pipelines.ts\`. Never edit it by hand.
+
+\`\`\`bash
+cd pipelines
+npm install
+npm run build        # writes ../azure-pipelines.yml
+\`\`\`
+
+Commit both \`azure-pipelines.ts\` and the regenerated \`azure-pipelines.yml\`.
+
+## Managing release definitions
+
+Release definitions are authored as TypeScript files and pushed to Azure DevOps via the CLI.
+
+\`\`\`bash
+cd pipelines
+npm run diff         # show drift between local and server
+npm run push:dry     # dry run – shows what would change
+npm run push         # interactive push
+\`\`\`
+
+## Adding a new release pipeline
+
+1. Create a new \`.ts\` file (e.g. \`release-backend.ts\`) using \`releasePipeline()\`.
+2. Add a \`diff\` and \`push\` step for it in \`release-sync.yml\`.
+3. Open a PR — the \`${syncPipelineName}\` pipeline will diff and report drift.
+4. On merge to \`${defaultBranch}\`, the pipeline pushes the definition automatically.
+
+## Credentials
+
+\`release-sync.yml\` uses the pipeline's built-in job token (\`SYSTEM_ACCESSTOKEN\`) to
+authenticate against the Azure DevOps Releases API — no service principal or client
+secret required.
+
+One-time setup after registering the pipeline:
+
+1. Go to **${org}** → **${project}** → Project Settings → **Permissions**.
+2. Search for **${project} Build Service (${org})**.
+3. Grant it the **Release Definition Contributor** role.
+`;
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+export async function runBootstrap(argv) {
+    const opts = parseArgs(argv);
+    if (opts.help) {
+        usage();
+        return;
+    }
+    // -- Detect git root -------------------------------------------------------
+    const gitRoot = findGitRoot(process.cwd());
+    console.log(`Detected repo root: ${gitRoot}`);
+    // -- Detect default branch -------------------------------------------------
+    const defaultBranch = detectDefaultBranch();
+    console.log(`Detected default branch: ${defaultBranch}`);
+    // -- Detect org / project --------------------------------------------------
+    const fromRemote = detectFromGitRemote();
+    const detectedOrg = process.env['AZURE_DEVOPS_ORG'] ?? fromRemote.org ?? '';
+    const detectedProject = process.env['AZURE_DEVOPS_PROJECT'] ?? fromRemote.project ?? '';
+    if (detectedOrg)
+        console.log(`Detected org: ${detectedOrg}`);
+    if (detectedProject)
+        console.log(`Detected project: ${detectedProject}`);
+    // -- Detect existing azure-pipelines.yml -----------------------------------
+    const rootYml = join(gitRoot, 'azure-pipelines.yml');
+    const hasRootYml = existsSync(rootYml);
+    if (hasRootYml)
+        console.log(`Detected existing azure-pipelines.yml at repo root.`);
+    // -- Interactive wizard ----------------------------------------------------
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const { prompt, yesNo } = makePrompter(rl);
+    let org = detectedOrg;
+    let project = detectedProject;
+    let releaseName = '';
+    let syncPipelineName = '';
+    let convertYml = hasRootYml;
+    if (!opts.yes) {
+        org = await prompt('Azure DevOps org', detectedOrg || undefined);
+        project = await prompt('Azure DevOps project', detectedProject || undefined);
+        const defaultSyncName = project
+            ? `${project.charAt(0).toUpperCase()}${project.slice(1)}ReleasesSync`
+            : 'ReleasesSync';
+        syncPipelineName = await prompt('Sync pipeline name (Azure DevOps display name)', defaultSyncName);
+        releaseName = await prompt('Release definition name (e.g. my-service-release)');
+        if (hasRootYml) {
+            convertYml = await yesNo('Convert existing azure-pipelines.yml to TypeScript?', true);
+        }
+        const proceed = await yesNo('Create/overwrite files in pipelines/?', true);
+        rl.close();
+        if (!proceed) {
+            console.log('Aborted.');
+            return;
+        }
+    }
+    else {
+        rl.close();
+        org = org || '';
+        project = project || '';
+        const defaultSyncName = project
+            ? `${project.charAt(0).toUpperCase()}${project.slice(1)}ReleasesSync`
+            : 'ReleasesSync';
+        syncPipelineName = defaultSyncName;
+        releaseName = `${project || 'my-service'}-release`;
+    }
+    if (!org) {
+        console.error('Org is required. Set AZURE_DEVOPS_ORG or pass it when prompted.\n' +
+            'You can also edit pipelines/release.ts and pipelines/release-sync.yml manually.');
+    }
+    if (!project) {
+        console.error('Project is required. Set AZURE_DEVOPS_PROJECT or pass it when prompted.\n' +
+            'You can also edit pipelines/release.ts and pipelines/release-sync.yml manually.');
+    }
+    // -- Prepare output directory ----------------------------------------------
+    const outDir = isAbsolute(opts.outDir)
+        ? opts.outDir
+        : join(gitRoot, opts.outDir);
+    mkdirSync(outDir, { recursive: true });
+    // -- Generate azure-pipelines.ts (convert or stub) -------------------------
+    let pipelineTs;
+    if (convertYml && hasRootYml) {
+        console.log('Converting azure-pipelines.yml → azure-pipelines.ts…');
+        const yamlText = readFileSync(rootYml, 'utf8');
+        const result = await yamlToTs(yamlText, {
+            prettier: true,
+            emitTemplates: false,
+            inlineTemplates: false,
+            entryFileName: 'azure-pipelines.ts',
+            outputDir: '.',
+            loadTemplate: () => undefined,
+        });
+        for (const w of result.warnings)
+            console.error(`  warning: ${w}`);
+        pipelineTs = result.files[0]?.contents ?? pipelineStubTemplate();
+    }
+    else {
+        pipelineTs = pipelineStubTemplate();
+    }
+    // -- Generate azure-pipelines.yml at repo root (stub pipeline serialized) --
+    // We do a best-effort in-process build using the stub as source.
+    // For the converted case, we don't re-emit from TS (that requires tsx at
+    // bootstrap time); instead we copy the original YAML with a banner prepended.
+    let rootYmlContent;
+    if (convertYml && hasRootYml) {
+        // Prepend the banner to the original YAML.
+        const originalYml = readFileSync(rootYml, 'utf8');
+        if (!originalYml.startsWith('# ===')) {
+            rootYmlContent = GENERATED_BANNER + originalYml;
+        }
+        else {
+            rootYmlContent = originalYml; // Already has the banner
+        }
+    }
+    else {
+        // Generate a minimal YAML for the stub pipeline.
+        rootYmlContent =
+            GENERATED_BANNER +
+                [
+                    'name: CI $(Date:yyyyMMdd).$(Rev:r)',
+                    'trigger:',
+                    '  branches:',
+                    '    include:',
+                    '      - main',
+                    'pr:',
+                    '  branches:',
+                    '    include:',
+                    '      - main',
+                    'pool:',
+                    "  vmImage: ubuntu-latest",
+                    'stages:',
+                    '  - stage: Build',
+                    '    jobs:',
+                    '      - job: build',
+                    '        steps:',
+                    "          - checkout: self",
+                    "          - script: echo \"Add your build steps here\"",
+                    '            displayName: Build',
+                ].join('\n') + '\n';
+    }
+    // -- Write all files -------------------------------------------------------
+    function write(filePath, content) {
+        writeFileSync(filePath, content, 'utf8');
+        console.log(`  Wrote ${filePath}`);
+    }
+    write(join(outDir, 'package.json'), packageJsonTemplate(org, project));
+    write(join(outDir, 'tsconfig.json'), tsconfigTemplate());
+    write(join(outDir, 'README.md'), readmeTemplate(org, project, syncPipelineName, defaultBranch));
+    write(join(outDir, 'azure-pipelines.ts'), pipelineTs);
+    write(join(outDir, 'release.ts'), releaseStubTemplate(org, project, releaseName));
+    write(join(outDir, 'release-sync.yml'), releaseSyncYmlTemplate(defaultBranch, syncPipelineName, org, project));
+    write(rootYml, rootYmlContent);
+    console.log(`
+Bootstrap complete!
+
+Next steps:
+  1. cd ${opts.outDir} && npm install
+  2. npm run build           # regenerate azure-pipelines.yml
+  3. Edit release.ts         # add your artifact source and environments
+  4. npm run diff            # check drift vs Azure DevOps
+  5. Register release-sync.yml in Azure DevOps as a new pipeline
+     (point it at: pipelines/release-sync.yml)
+  6. Grant the build service account permission to manage releases:
+     ${org ? `https://dev.azure.com/${org}/${project || '<project>'}/_settings/permissions` : '<org>/<project> → Project Settings → Permissions'}
+     Search for: "${project || '<project>'} Build Service (${org || '<org>'})"
+     Grant role: Release Definition Contributor
+
+See pipelines/README.md for full documentation.`);
+}
+//# sourceMappingURL=cmd-bootstrap.js.map

package/dist/cmd-bootstrap.js.map

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

package/dist/cmd-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cmd-build.d.ts","sourceRoot":"","sources":["../src/cmd-build.ts"],"names":[],"mappings":"AA6FA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC5D"}
+{"version":3,"file":"cmd-build.d.ts","sourceRoot":"","sources":["../src/cmd-build.ts"],"names":[],"mappings":"AAsHA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqD5D"}

package/dist/cmd-build.js

@@ -1,8 +1,9 @@
 import { writeFileSync, mkdirSync } from 'node:fs';
-import { dirname, isAbsolute, resolve } from 'node:path';
+import { basename, dirname, extname, isAbsolute, resolve } from 'node:path';
 import { stringify as yamlStringify } from 'yaml';
 import { toYaml, toJson, validatePipeline, formatValidationErrors } from '@mauvezero/azpipe-core';
 import { PipelineBuilder } from '@mauvezero/azpipe';
+import { WorkflowBuilder } from '@mauvezero/ghactions';
 import { renderTemplateFile, } from '@mauvezero/azpipe-utils';
 import { loadEntry } from './loader.js';
 function parseArgs(argv) {
@@ -13,14 +14,17 @@ function parseArgs(argv) {
         validate: true,
         templatesDir: '',
         help: false,
+        outExplicit: false,
     };
     const positional = [];
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
         if (a === '-h' || a === '--help')
             opts.help = true;
-        else if (a === '--out' || a === '-o')
+        else if (a === '--out' || a === '-o') {
             opts.out = argv[++i] ?? opts.out;
+            opts.outExplicit = true;
+        }
         else if (a === '--format' || a === '-f') {
             const v = argv[++i];
             if (v !== 'yaml' && v !== 'json')
@@ -44,14 +48,17 @@ function usage() {
     console.log(`azpipe build <entry.ts> [options]
 
 Compiles a TypeScript file that default-exports a PipelineBuilder (or plain
-pipeline object) into azure-pipelines.yml.
+pipeline object) into azure-pipelines.yml, or a WorkflowBuilder into a
+GitHub Actions workflow YAML file.
 
 Options:
-  -o, --out <file>         Output file (default: azure-pipelines.yml)
-  -f, --format yaml|json   Output format (default: yaml)
-      --no-validate        Skip schema validation
+  -o, --out <file>         Output file
+                           Azure Pipelines default: azure-pipelines.yml
+                           GitHub Actions default:  .github/workflows/<name>.yml
+  -f, --format yaml|json   Output format (default: yaml; Azure Pipelines only)
+      --no-validate        Skip schema validation (Azure Pipelines only)
       --templates-dir <d>  Override directory for emitted typed templates
-                           (default: dirname(--out)/templates)
+                           (default: dirname(--out)/templates; Azure Pipelines only)
   -h, --help               Show this help`);
 }
 function pipelineObject(value) {
@@ -59,6 +66,18 @@ function pipelineObject(value) {
         return value.toObject();
     return value;
 }
+/**
+ * Derive a default output path for a GitHub Actions workflow.
+ * If the builder has a name, slugify it; otherwise fall back to the entry
+ * file stem. Always resolves under `.github/workflows/`.
+ */
+function defaultWorkflowOut(workflowName, entry) {
+    const slug = (workflowName ?? basename(entry, extname(entry)))
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return `.github/workflows/${slug || 'workflow'}.yml`;
+}
 function ensureDir(filePath) {
     mkdirSync(dirname(filePath), { recursive: true });
 }
@@ -86,6 +105,19 @@ export async function runBuild(argv) {
     const mod = await loadEntry(opts.entry);
     if (!mod.default)
         throw new Error(`Entry ${opts.entry} must default-export a pipeline.`);
+    // ---------- GitHub Actions path ----------
+    if (mod.default instanceof WorkflowBuilder) {
+        const workflowObj = mod.default.toObject();
+        const outPath = opts.outExplicit
+            ? opts.out
+            : defaultWorkflowOut(workflowObj.name, opts.entry);
+        const outAbs = isAbsolute(outPath) ? outPath : resolve(process.cwd(), outPath);
+        ensureDir(outAbs);
+        writeFileSync(outAbs, mod.default.toYaml());
+        console.log(`Wrote ${outAbs}`);
+        return;
+    }
+    // ---------- Azure Pipelines path ----------
     const obj = pipelineObject(mod.default);
     if (opts.validate) {
         const result = validatePipeline(obj);