@icebreakers/monorepo 3.1.17 → 3.2.0

package/resources/skills/icebreakers-monorepo-cli/references/commands.md

@@ -0,0 +1,75 @@
+# Commands
+
+## upgrade (alias: up)
+
+Purpose: sync monorepo assets and scripts into the workspace.
+Usage:
+
+- npx monorepo up
+- npx monorepo upgrade
+  Options:
+- --interactive: prompt for overwrites
+- --core: sync core config only (skip GitHub assets)
+- --outDir <dir>: write to another directory
+- --skip-overwrite: never overwrite existing files
+
+## init
+
+Purpose: initialize package.json and README.md.
+Usage:
+
+- npx monorepo init
+
+## sync
+
+Purpose: sync workspace packages to npmmirror.
+Usage:
+
+- npx monorepo sync
+
+## clean
+
+Purpose: remove selected packages and update the @icebreakers/monorepo version.
+Usage:
+
+- npx monorepo clean
+  Options:
+- --yes: auto confirm
+- --include-private
+- --pinned-version <version>
+
+## mirror
+
+Purpose: set VSCode binary mirror env.
+Usage:
+
+- npx monorepo mirror
+
+## ai create (alias: ai new)
+
+Purpose: generate agentic prompt templates.
+Usage:
+
+- npx monorepo ai create
+- npx monorepo ai create --name checkout
+- npx monorepo ai create --tasks agentic/tasks.json --format md -f
+  Options:
+- --output <path>
+- --force
+- --format <md|json>
+- --dir <path>
+- --name <name>
+- --tasks <file>
+  Notes:
+- If no --output or --name is set, it prompts for a folder and writes to
+  agentic/prompts/<timestamp>/prompt.md.
+- If --tasks is used, it expects a JSON array of strings or objects.
+
+## new (alias: create)
+
+Purpose: create a new package from a template.
+Usage:
+
+- npx monorepo new [path]
+  Notes:
+- Prompts for a template choice unless defaults are set in monorepo.config.ts.

package/resources/skills/icebreakers-monorepo-cli/references/config.md

@@ -0,0 +1,63 @@
+# monorepo.config.ts
+
+Use `defineMonorepoConfig` to set default options for CLI commands.
+Only include the fields you need.
+
+Example:
+
+```ts
+import { defineMonorepoConfig } from '@icebreakers/monorepo'
+
+export default defineMonorepoConfig({
+  commands: {
+    ai: {
+      baseDir: 'agentic/prompts',
+      format: 'md',
+      force: false,
+      tasksFile: 'agentic/tasks.json',
+    },
+    create: {
+      defaultTemplate: 'tsdown',
+      renameJson: false,
+      templatesDir: 'packages/monorepo/templates',
+    },
+    clean: {
+      autoConfirm: false,
+      ignorePackages: ['docs'],
+      includePrivate: true,
+      pinnedVersion: 'latest',
+    },
+    sync: {
+      concurrency: 4,
+      command: 'cnpm sync {name}',
+      patterns: ['apps/*', 'packages/*', 'templates/*'],
+    },
+    upgrade: {
+      skipOverwrite: false,
+      targets: ['.github', 'monorepo.config.ts'],
+      mergeTargets: true,
+    },
+    init: {
+      skipReadme: false,
+      skipPkgJson: false,
+      skipChangeset: false,
+      skipIssueTemplateConfig: false,
+    },
+    mirror: {
+      env: {
+        VSCode_CLI_MIRROR: 'https://example.invalid',
+      },
+    },
+  },
+})
+```
+
+Key areas:
+
+- ai: default output, format, batch tasks
+- create: default template and template directory
+- clean: auto confirm and pinned version control
+- sync: workspace selection and concurrency
+- upgrade: overwrite behavior and extra targets
+- init: skip steps for README/package.json/changeset
+- mirror: add or override env mirrors

package/resources/skills/icebreakers-monorepo-cli/references/templates.md

@@ -0,0 +1,21 @@
+# Templates
+
+`monorepo new [path]` copies a template into the target path. If you want an app
+under `apps/`, pass the path explicitly, e.g. `apps/my-app`.
+
+Built-in template map:
+
+- tsup -> templates/tsup => packages/tsup
+- tsdown -> templates/tsdown => packages/tsdown
+- unbuild -> templates/unbuild => packages/unbuild
+- vue-lib -> templates/vue-lib => packages/vue-lib
+- hono-server -> templates/server => apps/server
+- vue-hono -> templates/client => apps/client
+- vitepress -> templates/vitepress => apps/website
+- cli -> templates/cli => apps/cli
+
+Notes:
+
+- The command prompts for template selection unless defaults are set in
+  monorepo.config.ts.
+- Override mappings with `commands.create.templateMap` and `commands.create.templatesDir`.

package/assets/.changeset/config.json

@@ -1,16 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@changesets/config@3.0.2/schema.json",
-  "changelog": [
-    "@icebreakers/changelog-github",
-    {
-      "repo": "sonofmagic/monorepo-template"
-    }
-  ],
-  "commit": false,
-  "fixed": [],
-  "linked": [],
-  "access": "public",
-  "baseBranch": "main",
-  "updateInternalDependencies": "patch",
-  "ignore": []
-}

package/assets/.dockerignore

@@ -1,44 +0,0 @@
-# Dependencies
-node_modules
-**/node_modules/
-
-# Build outputs
-dist
-**/dist/
-
-# Version control
-.git
-.gitignore
-.github
-
-# Documentation
-*.md
-README*
-
-# Testing
-coverage
-**/coverage/
-**/*.test.ts
-**/*.test.js
-**/*.spec.ts
-**/*.spec.js
-
-# Build caches
-.turbo
-**/.turbo/
-.vitepress/cache
-**/.vitepress/cache
-
-# Development
-.vscode
-.idea
-*.log
-.DS_Store
-
-# CI/CD
-.github/workflows
-
-# Environment
-.env
-.env.*
-!.env.example

package/assets/.editorconfig

@@ -1,12 +0,0 @@
-# EditorConfig is awesome: https://EditorConfig.org
-
-# top-most EditorConfig file
-root = true
-
-[*]
-indent_style = space
-indent_size = 2
-end_of_line = lf
-charset = utf-8
-trim_trailing_whitespace = false
-insert_final_newline = false

package/assets/.gitattributes

@@ -1,218 +0,0 @@
-# From https://github.com/gitattributes/gitattributes/blob/master/Web.gitattributes
-## GITATTRIBUTES FOR WEB PROJECTS
-#
-# These settings are for any web project.
-#
-# Details per file setting:
-#   text    These files should be normalized (i.e. convert CRLF to LF).
-#   binary  These files are binary and should be left untouched.
-#
-# Note that binary is a macro for -text -diff.
-######################################################################
-
-# Auto detect
-##   Handle line endings automatically for files detected as
-##   text and leave all files detected as binary untouched.
-##   This will handle all files NOT defined below.
-*                 text=auto
-
-# Source code
-*.bash            text eol=lf
-*.bat             text eol=crlf
-*.cmd             text eol=crlf
-*.coffee          text
-*.css             text diff=css
-*.htm             text diff=html
-*.html            text diff=html
-*.inc             text
-*.ini             text
-*.js              text
-*.mjs             text
-*.cjs             text
-*.json            text
-*.jsx             text
-*.less            text
-*.ls              text
-*.map             text -diff
-*.od              text
-*.onlydata        text
-*.php             text diff=php
-*.pl              text
-*.ps1             text eol=crlf
-*.py              text diff=python
-*.rb              text diff=ruby
-*.sass            text
-*.scm             text
-*.scss            text diff=css
-*.sh              text eol=lf
-.husky/*          text eol=lf
-*.sql             text
-*.styl            text
-*.tag             text
-*.ts              text
-*.tsx             text
-*.xml             text
-*.xhtml           text diff=html
-
-# Docker
-Dockerfile        text
-
-# Documentation
-*.ipynb           text eol=lf
-*.markdown        text diff=markdown
-*.md              text diff=markdown
-*.mdwn            text diff=markdown
-*.mdown           text diff=markdown
-*.mkd             text diff=markdown
-*.mkdn            text diff=markdown
-*.mdtxt           text
-*.mdtext          text
-*.txt             text
-AUTHORS           text
-CHANGELOG         text
-CHANGES           text
-CONTRIBUTING      text
-COPYING           text
-copyright         text
-*COPYRIGHT*       text
-INSTALL           text
-license           text
-LICENSE           text
-NEWS              text
-readme            text
-*README*          text
-TODO              text
-
-# Templates
-*.dot             text
-*.ejs             text
-*.erb             text
-*.haml            text
-*.handlebars      text
-*.hbs             text
-*.hbt             text
-*.jade            text
-*.latte           text
-*.mustache        text
-*.njk             text
-*.phtml           text
-*.svelte          text
-*.tmpl            text
-*.tpl             text
-*.twig            text
-*.vue             text
-
-# Configs
-*.cnf             text
-*.conf            text
-*.config          text
-.editorconfig     text
-.env              text
-.gitattributes    text
-.gitconfig        text
-.htaccess         text
-*.lock            text -diff
-package.json      text eol=lf
-package-lock.json text eol=lf -diff
-pnpm-lock.yaml    text eol=lf -diff
-.prettierrc       text
-yarn.lock         text -diff
-*.toml            text
-*.yaml            text
-*.yml             text
-browserslist      text
-Makefile          text
-makefile          text
-# Fixes syntax highlighting on GitHub to allow comments
-tsconfig.json     linguist-language=JSON-with-Comments
-
-# Heroku
-Procfile          text
-
-# Graphics
-*.ai              binary
-*.bmp             binary
-*.eps             binary
-*.gif             binary
-*.gifv            binary
-*.ico             binary
-*.jng             binary
-*.jp2             binary
-*.jpg             binary
-*.jpeg            binary
-*.jpx             binary
-*.jxr             binary
-*.pdf             binary
-*.png             binary
-*.psb             binary
-*.psd             binary
-# SVG treated as an asset (binary) by default.
-*.svg             text
-# If you want to treat it as binary,
-# use the following line instead.
-# *.svg           binary
-*.svgz            binary
-*.tif             binary
-*.tiff            binary
-*.wbmp            binary
-*.webp            binary
-
-# Audio
-*.kar             binary
-*.m4a             binary
-*.mid             binary
-*.midi            binary
-*.mp3             binary
-*.ogg             binary
-*.ra              binary
-
-# Video
-*.3gpp            binary
-*.3gp             binary
-*.as              binary
-*.asf             binary
-*.asx             binary
-*.avi             binary
-*.fla             binary
-*.flv             binary
-*.m4v             binary
-*.mng             binary
-*.mov             binary
-*.mp4             binary
-*.mpeg            binary
-*.mpg             binary
-*.ogv             binary
-*.swc             binary
-*.swf             binary
-*.webm            binary
-
-# Archives
-*.7z              binary
-*.gz              binary
-*.jar             binary
-*.rar             binary
-*.tar             binary
-*.zip             binary
-
-# Fonts
-*.ttf             binary
-*.eot             binary
-*.otf             binary
-*.woff            binary
-*.woff2           binary
-
-# Executables
-*.exe             binary
-*.pyc             binary
-# Prevents massive diffs caused by vendored, minified files
-**/.yarn/releases/**   binary
-**/.yarn/plugins/**    binary
-
-# RC files (like .babelrc or .eslintrc)
-*.*rc             text
-
-# Ignore files (like .npmignore or .gitignore)
-*.*ignore         text
-
-# Prevents massive diffs from built files
-dist/*            binary

package/assets/.github/FUNDING.yml

@@ -1,4 +0,0 @@
-# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository
-
-github: [sonofmagic]
-custom: ['https://github.com/sonofmagic/sponsors']

package/assets/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,71 +0,0 @@
-name: 🐞 Bug report
-description: Create a report to help us improve
-title: '[Bug]: '
-labels: [bug]
-assignees:
-  - sonofmagic
-body:
-  - type: markdown
-    attributes:
-      value: |
-        **Before You Start...**
-
-        This form is only for submitting bug reports. If you have a usage question
-        or are unsure if this is really a bug, make sure to:
-
-        Also try to search for your issue - it may have already been answered or even fixed in the development branch.
-        However, if you find that an old, closed issue still persists in the latest version,
-        you should open a new issue using the form below instead of commenting on the old issue.
-  - type: input
-    id: version
-    attributes:
-      label: version
-    validations:
-      required: true
-  - type: input
-    id: reproduction-link
-    attributes:
-      label: Link to minimal reproduction
-      description: |
-        You can always provide a GitHub repository.
-
-        The reproduction should be **minimal** - i.e. it should contain only the bare minimum amount of code needed
-        to show the bug.
-
-        Please do not just fill in a random link. The issue will be closed if no valid reproduction is provided.
-      placeholder: Reproduction Link
-    validations:
-      required: true
-  - type: textarea
-    id: steps-to-reproduce
-    attributes:
-      label: Steps to reproduce
-      description: |
-        What do we need to do after opening your repro in order to make the bug happen? Clear and concise reproduction instructions are important for us to be able to triage your issue in a timely manner. Note that you can use [Markdown](https://guides.github.com/features/mastering-markdown/) to format lists and code.
-      placeholder: Steps to reproduce
-    validations:
-      required: true
-  - type: textarea
-    id: expected
-    attributes:
-      label: What is expected?
-    validations:
-      required: true
-  - type: textarea
-    id: actually-happening
-    attributes:
-      label: What is actually happening?
-    validations:
-      required: true
-  - type: textarea
-    id: system-info
-    attributes:
-      label: System Info
-      description: Output of `npx -y envinfo@latest --system --npmPackages --binaries`
-      render: shell
-      placeholder: System, Binaries
-  - type: textarea
-    id: additional-comments
-    attributes:
-      label: Any additional comments?
-      description: e.g. some background/context of how you ran into this bug.

package/assets/.github/ISSUE_TEMPLATE/config.yml

@@ -1,17 +0,0 @@
-blank_issues_enabled: false
-contact_links:
-  - name: Feature Request
-    url: https://github.com/sonofmagic/monorepo-template/discussions
-    about: Suggest new features for consideration
-  # - name: Discord Chat
-  #   url: https://chat.vuejs.org
-  #   about: Ask questions and discuss with other Vue users in real time.
-  # - name: Questions & Discussions
-  #   url: https://github.com/vuejs/core/discussions
-  #   about: Use GitHub discussions for message-board style questions and discussions.
-  # - name: Patreon
-  #   url: https://www.patreon.com/evanyou
-  #   about: Love Vue.js? Please consider supporting us via Patreon.
-  # - name: Open Collective
-  #   url: https://opencollective.com/vuejs/donate
-  #   about: Love Vue.js? Please consider supporting us via Open Collective.

package/assets/.github/workflows/ci.yml

@@ -1,62 +0,0 @@
-name: CI
-
-on:
-  # push:
-  #   branches: ['main']
-  pull_request:
-    types: [opened, synchronize]
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-jobs:
-  build:
-    name: Build and Test
-    timeout-minutes: 15
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest]
-        node-version: [20, 22, 24]
-    runs-on: ${{ matrix.os }}
-    # Remote Caching enabled - configure TURBO_TOKEN and TURBO_TEAM in repository settings
-    env:
-      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
-      TURBO_TEAM: ${{ vars.TURBO_TEAM }}
-
-    steps:
-      - name: Check out code
-        uses: actions/checkout@v6
-        with:
-          fetch-depth: 2
-
-      - uses: pnpm/action-setup@v4
-
-      - name: Setup Node.js environment
-        uses: actions/setup-node@v6
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: pnpm
-          cache-dependency-path: pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Security Audit
-        run: pnpm audit --audit-level=moderate
-        continue-on-error: true
-
-      - name: Lint
-        run: pnpm lint
-
-      - name: Build
-        run: pnpm build
-
-      - name: Test
-        run: pnpm test
-
-      - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@v5
-        env:
-          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

package/assets/.github/workflows/release.yml

@@ -1,57 +0,0 @@
-name: Release
-
-on:
-  push:
-    branches:
-      - main
-  workflow_dispatch:
-
-concurrency: ${{ github.workflow }}-${{ github.ref }}
-env:
-  HUSKY: 0
-
-permissions:
-  contents: write # to create release (changesets/action)
-  issues: write # to post issue comments (changesets/action)
-  pull-requests: write # to create pull request (changesets/action)
-  id-token: write # to use OpenID Connect token for provenance (changesets/action)
-
-jobs:
-  release:
-    name: Release
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout Repo
-        uses: actions/checkout@v6
-
-      - uses: pnpm/action-setup@v4
-
-      - name: Setup Node.js environment
-        uses: actions/setup-node@v6
-        with:
-          node-version: 24
-          cache: pnpm
-
-      - name: Install Dependencies
-        run: pnpm i
-
-      - name: Create Release Pull Request or Publish to npm
-        id: changesets
-        uses: changesets/action@v1
-        with:
-          # This expects you to have a script called release which does a build for your packages and calls changeset publish
-          publish: pnpm publish-packages
-        env:
-          # this doesn't work but semantic-release works
-          # see https://github.com/sonofmagic/npm-lib-rollup-template/blob/main/.github/workflows/release.yml#L46
-          # NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          # NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-          npm_config_registry: https://registry.npmjs.org
-          # https://github.com/changesets/changesets/pull/1659
-          NPM_CONFIG_PROVENANCE: true
-
-      - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@v5
-        env:
-          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

package/assets/.husky/commit-msg

@@ -1,4 +0,0 @@
-#!/usr/bin/env sh
-set -e
-
-pnpm exec commitlint --edit "$1"

package/assets/.husky/pre-commit

@@ -1,4 +0,0 @@
-#!/usr/bin/env sh
-set -e
-
-pnpm exec lint-staged

package/assets/.vscode/extensions.json

@@ -1,6 +0,0 @@
-{
-  "recommendations": [
-    "dbaeumer.vscode-eslint",
-    "stylelint.vscode-stylelint"
-  ]
-}