putitoutthere 0.1.42 → 0.1.44

package/dist/templates.d.ts

@@ -1,43 +0,0 @@
-/**
- * Workflow templates emitted by `putitoutthere init`.
- *
- * Per plan.md §9.2 (immediate), §9.4 (scheduled), §9.5 (PR check).
- *
- * The `release.yml` templates follow the three-job shape
- * (plan → build → publish) so users can drop their build tooling into
- * the middle job without forking the orchestrator. Build steps are
- * keyed on `matrix.kind` (crates | pypi | npm) and `matrix.build`
- * (vanilla | maturin | napi | bundled-cli) so the right builder runs
- * per row.
- *
- * Issue #25. Plan: §9.
- */
-export type Cadence = 'immediate' | 'scheduled';
-/**
- * Seed values `tomlSkeleton` can bake into the emitted skeleton.
- * Today, the only one is a suggested `tag_format` for repos whose
- * existing tag history is `v*` — see `src/init.ts#detectTagFormatSuggestion`.
- */
-export interface SkeletonSeeds {
-    tag_format?: string;
-    /** Human-readable phrase explaining why the suggestion was made. */
-    tag_format_reason?: string;
-}
-/**
- * Emit the `putitoutthere.toml` skeleton. When `seeds.tag_format` is
- * set, prepend a short comment explaining why plus a commented
- * `# tag_format = "..."` hint inside the crates example block.
- *
- * Kept as a function (not a constant) so init can bake in
- * per-repo detection results (#204). Callers without seeds get the
- * plain skeleton.
- */
-export declare function tomlSkeleton(seeds?: SkeletonSeeds | null): string;
-/** @deprecated use {@link tomlSkeleton}; kept for external consumers of the constant. */
-export declare const TOML_SKELETON = "# Put It Out There \u2014 release orchestration config.\n# Docs: https://github.com/thekevinscott/put-it-out-there\n\n[putitoutthere]\nversion = 1\n\n# Declare one [[package]] block per releasable artifact. Examples:\n#\n# [[package]]\n# name = \"my-crate\"\n# kind = \"crates\"\n# path = \"crates/my-crate\"                 # dir containing Cargo.toml\n# paths = [\"crates/my-crate/**\", \"**/Cargo.toml\", \"**/Cargo.lock\"]\n# first_version = \"0.1.0\"\n# # tag_format defaults to \"{name}-v{version}\". Single-package repos\n# # often want \"v{version}\" to keep the existing v0.1.0-style timeline.\n# # tag_format = \"v{version}\"\n#\n# [[package]]\n# name = \"my-py\"\n# kind = \"pypi\"\n# path = \"py/my-py\"                        # dir containing pyproject.toml\n# paths = [\"py/my-py/**\"]\n# first_version = \"0.1.0\"\n#\n# [[package]]\n# name = \"my-pkg\"\n# kind = \"npm\"\n# path = \"packages/my-pkg\"                 # dir containing package.json\n# paths = [\"packages/my-pkg/**\"]\n# first_version = \"0.1.0\"\n";
-export declare const AGENTS_MD = "# Release signaling for Put It Out There\n\nWhen you finish a unit of work and are preparing a PR or commit, add a git\ntrailer to the commit message body to signal a release:\n\n    release: <patch|minor|major|skip>\n\nRules:\n- Omit the trailer for docs-only, CI-only, or internal-only changes.\n- `patch` for bug fixes or internal refactors that don't change public API.\n- `minor` for new features that are backwards-compatible.\n- `major` for breaking changes.\n- `skip` to suppress release when path filters would otherwise cascade.\n\nThe trailer on the merge commit determines the release. If merging via\n\"Squash and merge,\" include the trailer in the PR description so it ends up\nin the squashed commit body.\n\n## Scoping a release to specific packages\n\nTo release a subset of packages in a polyglot repo, append a bracketed list:\n\n    release: minor [my-crate, my-py]\n\nPackages named in the list are bumped with the specified version. Other\npackages cascaded by path filters still get a `patch`. Packages in the\nlist that *aren't* cascaded are force-included.\n";
-export declare const RELEASE_YML_IMMEDIATE: string;
-export declare const RELEASE_YML_SCHEDULED: string;
-export declare const CHECK_YML = "name: Putitoutthere check\n\non:\n  pull_request:\n    branches: [main]\n\npermissions:\n  contents: read\n  pull-requests: read\n\njobs:\n  dry-run:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n        with:\n          fetch-depth: 0\n      - uses: thekevinscott/put-it-out-there@v0\n        with:\n          command: plan\n          dry_run: true\n          fail_on_error: true\n";
-export declare function releaseYml(cadence: Cadence): string;
-//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAmCD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAE,aAAa,GAAG,IAAW,GAAG,MAAM,CAWvE;AAED,yFAAyF;AACzF,eAAO,MAAM,aAAa,ygCAAqB,CAAC;AAEhD,eAAO,MAAM,SAAS,ikCA2BrB,CAAC;AA+LF,eAAO,MAAM,qBAAqB,QAAsE,CAAC;AACzG,eAAO,MAAM,qBAAqB,QAAsE,CAAC;AAEzG,eAAO,MAAM,SAAS,iaAsBrB,CAAC;AAEF,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGnD"}

package/dist/templates.js

@@ -1,310 +0,0 @@
-/**
- * Workflow templates emitted by `putitoutthere init`.
- *
- * Per plan.md §9.2 (immediate), §9.4 (scheduled), §9.5 (PR check).
- *
- * The `release.yml` templates follow the three-job shape
- * (plan → build → publish) so users can drop their build tooling into
- * the middle job without forking the orchestrator. Build steps are
- * keyed on `matrix.kind` (crates | pypi | npm) and `matrix.build`
- * (vanilla | maturin | napi | bundled-cli) so the right builder runs
- * per row.
- *
- * Issue #25. Plan: §9.
- */
-const TOML_SKELETON_BODY = `# Put It Out There — release orchestration config.
-# Docs: https://github.com/thekevinscott/put-it-out-there
-
-[putitoutthere]
-version = 1
-
-# Declare one [[package]] block per releasable artifact. Examples:
-#
-# [[package]]
-# name = "my-crate"
-# kind = "crates"
-# path = "crates/my-crate"                 # dir containing Cargo.toml
-# paths = ["crates/my-crate/**", "**/Cargo.toml", "**/Cargo.lock"]
-# first_version = "0.1.0"
-# # tag_format defaults to "{name}-v{version}". Single-package repos
-# # often want "v{version}" to keep the existing v0.1.0-style timeline.
-# # tag_format = "v{version}"
-#
-# [[package]]
-# name = "my-py"
-# kind = "pypi"
-# path = "py/my-py"                        # dir containing pyproject.toml
-# paths = ["py/my-py/**"]
-# first_version = "0.1.0"
-#
-# [[package]]
-# name = "my-pkg"
-# kind = "npm"
-# path = "packages/my-pkg"                 # dir containing package.json
-# paths = ["packages/my-pkg/**"]
-# first_version = "0.1.0"
-`;
-/**
- * Emit the `putitoutthere.toml` skeleton. When `seeds.tag_format` is
- * set, prepend a short comment explaining why plus a commented
- * `# tag_format = "..."` hint inside the crates example block.
- *
- * Kept as a function (not a constant) so init can bake in
- * per-repo detection results (#204). Callers without seeds get the
- * plain skeleton.
- */
-export function tomlSkeleton(seeds = null) {
-    if (seeds === null || seeds.tag_format === undefined) {
-        return TOML_SKELETON_BODY;
-    }
-    const reason = seeds.tag_format_reason ?? 'single-package repo';
-    const banner = `# piot init detected ${reason}; set tag_format = "${seeds.tag_format}" on\n` +
-        `# each [[package]] block below to keep that timeline, or remove this comment\n` +
-        `# to use the default "{name}-v{version}".\n` +
-        `# See https://thekevinscott.github.io/put-it-out-there/guide/configuration\n\n`;
-    return banner + TOML_SKELETON_BODY;
-}
-/** @deprecated use {@link tomlSkeleton}; kept for external consumers of the constant. */
-export const TOML_SKELETON = TOML_SKELETON_BODY;
-export const AGENTS_MD = `# Release signaling for Put It Out There
-
-When you finish a unit of work and are preparing a PR or commit, add a git
-trailer to the commit message body to signal a release:
-
-    release: <patch|minor|major|skip>
-
-Rules:
-- Omit the trailer for docs-only, CI-only, or internal-only changes.
-- \`patch\` for bug fixes or internal refactors that don't change public API.
-- \`minor\` for new features that are backwards-compatible.
-- \`major\` for breaking changes.
-- \`skip\` to suppress release when path filters would otherwise cascade.
-
-The trailer on the merge commit determines the release. If merging via
-"Squash and merge," include the trailer in the PR description so it ends up
-in the squashed commit body.
-
-## Scoping a release to specific packages
-
-To release a subset of packages in a polyglot repo, append a bracketed list:
-
-    release: minor [my-crate, my-py]
-
-Packages named in the list are bumped with the specified version. Other
-packages cascaded by path filters still get a \`patch\`. Packages in the
-list that *aren't* cascaded are force-included.
-`;
-const BUILD_JOB = `  build:
-    needs: plan
-    if: fromJSON(needs.plan.outputs.matrix || '[]')[0] != null
-    strategy:
-      fail-fast: false
-      matrix:
-        include: \${{ fromJSON(needs.plan.outputs.matrix) }}
-    runs-on: \${{ matrix.runs_on }}
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Setup Rust (if crates)
-        if: matrix.kind == 'crates'
-        uses: dtolnay/rust-toolchain@stable
-      - name: Build crate
-        if: matrix.kind == 'crates'
-        run: cargo package --manifest-path \${{ matrix.path }}/Cargo.toml --target-dir \${{ matrix.path }}/target
-      - name: Setup Python (if pypi)
-        if: matrix.kind == 'pypi'
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
-      # #217: when [package.bundle_cli] is declared, compile the CLI
-      # for this target and stage it into the package source tree so
-      # maturin includes it in the wheel that's built next.
-      - name: Setup Rust (if pypi bundle_cli)
-        if: matrix.kind == 'pypi' && matrix.bundle_cli.bin != '' && matrix.target != 'sdist'
-        uses: dtolnay/rust-toolchain@stable
-        with:
-          targets: \${{ matrix.target }}
-      - name: Build + stage bundled CLI
-        if: matrix.kind == 'pypi' && matrix.bundle_cli.bin != '' && matrix.target != 'sdist'
-        shell: bash
-        run: |
-          set -euo pipefail
-          cd "\${{ matrix.bundle_cli.crate_path }}"
-          cargo build --release --bin "\${{ matrix.bundle_cli.bin }}" --target "\${{ matrix.target }}"
-          cd "\${{ github.workspace }}"
-          dest="\${{ matrix.path }}/\${{ matrix.bundle_cli.stage_to }}"
-          mkdir -p "$dest"
-          # Windows targets produce .exe; Unix don't. Copy whatever's
-          # there matching the bin name.
-          src_dir="\${{ matrix.bundle_cli.crate_path }}/target/\${{ matrix.target }}/release"
-          if [[ -f "$src_dir/\${{ matrix.bundle_cli.bin }}.exe" ]]; then
-            cp "$src_dir/\${{ matrix.bundle_cli.bin }}.exe" "$dest/"
-          elif [[ -f "$src_dir/\${{ matrix.bundle_cli.bin }}" ]]; then
-            cp "$src_dir/\${{ matrix.bundle_cli.bin }}" "$dest/"
-          else
-            echo "bundle_cli: built binary not found at $src_dir/\${{ matrix.bundle_cli.bin }}[.exe]" >&2
-            exit 1
-          fi
-      - name: Build wheel (maturin)
-        if: matrix.kind == 'pypi' && matrix.build == 'maturin'
-        uses: PyO3/maturin-action@v1
-        with:
-          command: build
-          args: --release --out \${{ matrix.path }}/dist \${{ matrix.target == 'sdist' && '--sdist' || format('--target {0}', matrix.target) }}
-          working-directory: \${{ matrix.path }}
-      - name: Build sdist (setuptools/hatch)
-        if: matrix.kind == 'pypi' && matrix.build != 'maturin' && matrix.target == 'sdist'
-        run: |
-          cd \${{ matrix.path }}
-          python -m pip install build
-          python -m build --sdist --outdir dist
-      - name: Setup Node (if npm)
-        if: matrix.kind == 'npm'
-        uses: actions/setup-node@v4
-        with:
-          node-version: '24'
-      - name: Build npm package
-        if: matrix.kind == 'npm'
-        run: |
-          cd \${{ matrix.path }}
-          npm ci
-          npm run build --if-present
-      - uses: actions/upload-artifact@v4
-        with:
-          name: \${{ matrix.artifact_name }}
-          path: \${{ matrix.artifact_path }}
-`;
-const PUBLISH_JOB = `  publish:
-    needs: [plan, build]
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      id-token: write
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '24'
-          registry-url: 'https://registry.npmjs.org'
-      # PyPI publish shells out to \`twine\`. Hosted runners don't ship it;
-      # install it here so the publish job has twine on PATH regardless of
-      # whether the config has a pypi package today.
-      - uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
-      - name: Install twine
-        run: pip install twine
-      # piot cuts an annotated tag per publish (\`git tag -a\`). Hosted
-      # runners have no committer identity set; configure one before the
-      # piot step or tag creation fails with "Please tell me who you are."
-      - name: Configure git identity
-        run: |
-          git config --global user.name "github-actions[bot]"
-          git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
-      - uses: actions/download-artifact@v4
-        with:
-          path: artifacts
-      - uses: thekevinscott/put-it-out-there@v0
-        with:
-          command: publish
-          dry_run: \${{ inputs.dry_run || 'false' }}
-        env:
-          # NODE_AUTH_TOKEN (not NPM_TOKEN) matches the .npmrc template that
-          # actions/setup-node writes when registry-url is set. putitoutthere's
-          # preflight also accepts NPM_TOKEN as a fallback, but npm itself
-          # reads this name. Store your npm secret under any name — we map it
-          # here.
-          NODE_AUTH_TOKEN: \${{ secrets.NPM_TOKEN }}
-          CARGO_REGISTRY_TOKEN: \${{ secrets.CARGO_TOKEN }}
-          PYPI_API_TOKEN: \${{ secrets.PYPI_API_TOKEN }}
-`;
-const PLAN_JOB = `  plan:
-    runs-on: ubuntu-latest
-    outputs:
-      matrix: \${{ steps.plan.outputs.matrix }}
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - id: plan
-        uses: thekevinscott/put-it-out-there@v0
-        with:
-          command: plan
-`;
-const IMMEDIATE_HEADER = `name: Release
-
-on:
-  push:
-    branches: [main]
-  workflow_dispatch:
-    inputs:
-      dry_run:
-        description: 'Dry-run: compute plan, skip publish + tag'
-        type: boolean
-        default: false
-
-concurrency:
-  group: release
-  cancel-in-progress: false
-
-permissions:
-  contents: read
-  id-token: write
-
-jobs:
-`;
-const SCHEDULED_HEADER = `name: Release (scheduled)
-
-on:
-  schedule:
-    - cron: '0 2 * * *'
-  workflow_dispatch:
-    inputs:
-      dry_run:
-        description: 'Dry-run: compute plan, skip publish + tag'
-        type: boolean
-        default: false
-
-concurrency:
-  group: release
-  cancel-in-progress: false
-
-permissions:
-  contents: read
-  id-token: write
-
-jobs:
-`;
-export const RELEASE_YML_IMMEDIATE = IMMEDIATE_HEADER + PLAN_JOB + '\n' + BUILD_JOB + '\n' + PUBLISH_JOB;
-export const RELEASE_YML_SCHEDULED = SCHEDULED_HEADER + PLAN_JOB + '\n' + BUILD_JOB + '\n' + PUBLISH_JOB;
-export const CHECK_YML = `name: Putitoutthere check
-
-on:
-  pull_request:
-    branches: [main]
-
-permissions:
-  contents: read
-  pull-requests: read
-
-jobs:
-  dry-run:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - uses: thekevinscott/put-it-out-there@v0
-        with:
-          command: plan
-          dry_run: true
-          fail_on_error: true
-`;
-export function releaseYml(cadence) {
-    /* v8 ignore next -- exhaustive switch */
-    return cadence === 'scheduled' ? RELEASE_YML_SCHEDULED : RELEASE_YML_IMMEDIATE;
-}
-//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAeH,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B1B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,QAA8B,IAAI;IAC7D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,iBAAiB,IAAI,qBAAqB,CAAC;IAChE,MAAM,MAAM,GACV,wBAAwB,MAAM,uBAAuB,KAAK,CAAC,UAAU,QAAQ;QAC7E,gFAAgF;QAChF,6CAA6C;QAC7C,gFAAgF,CAAC;IACnF,OAAO,MAAM,GAAG,kBAAkB,CAAC;AACrC,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAEhD,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BxB,CAAC;AAEF,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFjB,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CnB,CAAC;AAEF,MAAM,QAAQ,GAAG;;;;;;;;;;;;CAYhB,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBxB,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBxB,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,WAAW,CAAC;AACzG,MAAM,CAAC,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,WAAW,CAAC;AAEzG,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsBxB,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,yCAAyC;IACzC,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,qBAAqB,CAAC;AACjF,CAAC"}