@theholocron/cli 1.0.0 → 1.1.0

package/package.json

@@ -1,71 +1,64 @@
 {
   "name": "@theholocron/cli",
-  "version": "1.0.0",
-  "description": "The command-line client designed to support The Holocron.",
-  "homepage": "https://github.com/theholocron/holocron#readme",
+  "version": "1.1.0",
+  "description": "The Holocron CLI — a pluggable, capability-based orchestrator for spinning up and operating software projects.",
+  "homepage": "https://github.com/theholocron/holocron/tree/main/packages/cli#readme",
   "bugs": "https://github.com/theholocron/holocron/issues",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/theholocron/holocron.git"
+    "url": "git+https://github.com/theholocron/holocron.git",
+    "directory": "packages/cli"
   },
-  "license": "GPL-3.0",
+  "license": "MIT",
   "author": "Newton Koumantzelis",
   "type": "module",
-  "main": "src/cli.ts",
+  "main": "./dist/index.mjs",
   "bin": {
-    "holocron": "./src/cli.ts"
+    "holocron": "./dist/cli.mjs"
   },
-  "man": "./man/holocron.1",
-  "scripts": {
-    "lint": "docker run -e LOG_LEVEL=DEBUG -e RUN_LOCAL=true -v .:/tmp/lint --rm ghcr.io/super-linter/super-linter:latest",
-    "postbuild": "marked-man README.md > man/holocron.1",
-    "start": "tsx ./src/cli.ts"
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./capabilities": {
+      "types": "./dist/capabilities/index.d.mts",
+      "import": "./dist/capabilities/index.mjs",
+      "default": "./dist/capabilities/index.mjs"
+    }
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "dependencies": {
-    "@inquirer/prompts": "^7.0.1",
-    "@theholocron/utils-string": "^0.1.0",
-    "chalk": "^5.3.0",
-    "conf": "^13.0.1",
-    "default-browser": "^5.2.1",
-    "dotenv": "^16.4.5",
-    "inquirer-autocomplete-standalone": "^0.8.1",
-    "open": "^10.1.0",
-    "open-editor": "^4.1.1",
-    "ora": "^8.1.0",
-    "play-sound": "^1.1.6",
-    "update-notifier": "^7.3.1",
-    "winston": "^3.15.0",
-    "yargs": "^17.7.2"
+    "yargs": "^18.0.0",
+    "@theholocron/cli-utils": "0.0.0"
   },
   "devDependencies": {
-    "@theholocron/commitlint-config": "^3.4.4",
-    "@theholocron/eslint-config": "^3.4.4",
-    "@theholocron/jest-config": "^3.4.4",
-    "@theholocron/lint-staged-config": "^3.4.4",
-    "@theholocron/prettier-config": "^3.4.4",
-    "@theholocron/storybook-config": "^3.4.4",
-    "@theholocron/stylelint-config": "^3.4.4",
-    "@theholocron/tsconfig": "^3.4.4",
-    "@tsconfig/node-lts": "^20.1.3",
-    "@types/conf": "^2.1.0",
-    "@types/inquirer": "^9.0.7",
-    "@types/play-sound": "^1.1.2",
-    "@types/update-notifier": "^6.0.8",
-    "@types/winston": "^2.4.4",
-    "@types/yargs": "^17.0.33",
-    "alexjs": "^1.0.0",
-    "marked-man": "^2.1.0",
-    "tsx": "^4.19.2",
-    "typescript": "^5.6.3"
-  },
-  "packageManager": "npm@9.5.0",
-  "engines": {
-    "node": ">=23",
-    "npm": ">=10"
+    "@theholocron/eslint-config": "^4.1.0",
+    "@theholocron/tsconfig": "^4.1.0",
+    "@tsconfig/node-lts": "^24.0.0",
+    "@types/yargs": "^17.0.35",
+    "@vitest/coverage-v8": "^3.2.6",
+    "eslint": "^9.36.0",
+    "globals": "^16.5.0",
+    "tsdown": "^0.22.3",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.6"
   },
   "publishConfig": {
     "access": "public"
   },
-  "releases": "https://github.com/theholocron/holocron/releases",
-  "wiki": "https://github.com/theholocron/holocron/wiki"
-}
+  "scripts": {
+    "build": "tsdown",
+    "start": "tsx ./src/cli.ts",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "types": "./dist/index.d.mts"
+}

package/.alexignore

@@ -1,3 +0,0 @@
-.github/*
-CHANGELOG.md
-LICENSE

package/.editorconfig

@@ -1,24 +0,0 @@
-root = true
-
-[*]
-end_of_line = lf
-charset = utf-8
-trim_trailing_whitespace = true
-insert_final_newline = true
-indent_style = tab
-indent_size = 4
-
-[.gitattributes]
-indent_style = space
-indent_size = 2
-
-[*.{json,yml}]
-indent_style = space
-indent_size = 2
-
-[*.md]
-trim_trailing_whitespace = false
-
-[.*{rc,ignore}]
-indent_style = space
-indent_size = 2

package/.editorconfig-checker.json

@@ -1,20 +0,0 @@
-{
-  "Version": "v3.0.3",
-  "Verbose": false,
-  "Format": "",
-  "Debug": false,
-  "IgnoreDefaults": false,
-  "SpacesAftertabs": false,
-  "NoColor": false,
-  "Exclude": ["^LICENSE$", "^public/.*"],
-  "AllowedContentTypes": [],
-  "PassedFiles": [],
-  "Disable": {
-    "EndOfLine": false,
-    "Indentation": false,
-    "InsertFinalNewline": false,
-    "TrimTrailingWhitespace": false,
-    "IndentSize": false,
-    "MaxLineLength": false
-  }
-}

package/.env

@@ -1,3 +0,0 @@
-HOLOCRON_DEBUG=false
-HOLOCRON_SOUND=false
-HOLOCRON_VERBOSE=false

package/.gitattributes

@@ -1,12 +0,0 @@
-# Enforce Unix newlines
-*.css   text eol=lf
-*.html  text eol=lf
-*.js    text eol=lf
-*.json  text eol=lf
-*.scss  text eol=lf
-*.md    text eol=lf
-*.svg   text eol=lf
-*.yml   text eol=lf
-
-# Don't diff or textually merge source maps
-*.map   binary

package/.github/CODEOWNERS

@@ -1 +0,0 @@
-* @theholocron/gatekeepers

package/.github/dependabot.yml

@@ -1,6 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: "npm"
-    directory: "/"
-    schedule:
-      interval: "weekly"

package/.github/labeler.yml

@@ -1,21 +0,0 @@
-# Add "documentation" label to any changes within "docs" folder or any subfolders or .md files within the entire repository
-documentation:
-- any:
-  - changed-files:
-    - any-glob-to-any-file:
-      - docs/**
-      - "**/*.md"
-
-# Add "bug" label to any PR where the head branch name starts with `fix` with file changes to src directory
-bug:
-- all:
-  - changed-files:
-    - any-glob-to-any-file: src/**
-  - head-branch: "^fix-"
-
-# Add "enhancement" label to any PR where the head branch name starts with `feat` with file changes to src directory
-enhancement:
-- all:
-  - changed-files:
-    - any-glob-to-any-file: src/**
-  - head-branch: "^feat-"

package/.github/workflows/bookkeeping-pr.yml

@@ -1,32 +0,0 @@
-name: PR Bookkeeping
-
-# @TODO: add in more things like:
-# - [ ] auto-assigning,
-# - [ ] project assignments,
-# - [ ] milestone assignments
-# - [ ] cleans up language
-# - [ ] checks that template is filled out
-
-on: # yamllint disable-line rule:truthy
-  pull_request:
-    types:
-      - opened
-      - edited
-
-permissions:
-  contents: read
-  pull-requests: write
-
-jobs:
-  label-pr:
-    name: Add Labels to PRs
-    runs-on: ubuntu-latest
-    steps:
-      - uses: github/issue-labeler@v3.4
-        with:
-          include-title: 1
-          include-body: 0
-          sync-labels: 1
-          configuration-path: .github/labeler.yml
-          enable-versioned-regex: 0
-          repo-token: ${{ github.token }}

package/.github/workflows/greetings.yml

@@ -1,32 +0,0 @@
-name: Greetings
-
-on: # yamllint disable-line rule:truthy
-  - pull_request
-  - issues
-
-jobs:
-  greeting:
-    name: Greet new interactions
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/first-interaction@v1
-        with:
-          issue-message: >
-            Hey @${{ github.event.issue.user.login }}!
-            We really appreciate you taking the time to report an issue. The
-            collaborators on this project attempt to help as many people as
-            possible, but we are a limited number of volunteers, so it is
-            possible that this will not be addressed as swiftly.
-
-            Your patience is much appreciated and we will get back to you as
-            quickly as possible.
-          pr-message: >
-            Hey @${{ github.event.issue.user.login }}!
-            We really appreciate you taking the time to help out with this PR.
-            The collaborators on this project attempt to help as many people as
-            possible, but we are a limited number of volunteers, so it is
-            possible that this will not be addressed as swiftly.
-
-            Your patience is much appreciated and we will get back to you as
-            quickly as possible.
-          repo-token: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/lint.yml

@@ -1,96 +0,0 @@
-name: Lint
-
-on: # yamllint disable-line rule:truthy
-  - push
-  - pull_request
-
-permissions:
-  contents: read
-
-jobs:
-  super-lint:
-    name: "Lint entire codebase"
-    permissions:
-      contents: write # write linting fixes
-      statuses: write # write Super-linter status checks
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        name: Checkout repository
-        with:
-          fetch-depth: 0
-          token: ${{ secrets.GH_TOKEN }}
-
-      - uses: actions/setup-node@v4
-        name: Setup Node.js @v20
-        with:
-          cache: npm
-          node-version: 20.x
-
-      - run: npm ci
-        name: Install dependencies
-
-      - uses: super-linter/super-linter/slim@v7.1.0
-        name: Run Super Linter
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          ANNOTATE_ONLY: true  # Allow annotations in the PR
-          DISABLE_COMMENTS: false  # Enable comments in the PR
-          IGNORE_GITIGNORED_FILES: true
-          LINTER_RULES_PATH: /
-          # CSS_FILE_NAME: "stylelint.config.js"
-          EDITORCONFIG_FILE_NAME: ".editorconfig-checker.json"
-          # FIX_CSS_PRETTIER: true
-          FIX_ENV: true
-          FIX_GRAPHQL_PRETTIER: true
-          FIX_HTML_PRETTIER: true
-          FIX_JAVASCRIPT_PRETTIER: true
-          # FIX_JSON_PRETTIER: true => turning this off til i figure out why its not respecting config
-          FIX_JSX_PRETTIER: true
-          # FIX_MARKDOWN_PRETTIER: true
-          FIX_TSX: true
-          FIX_TYPESCRIPT_PRETTIER: true
-          # FIX_YAML_PRETTIER: true => turning this off til i figure out why its not respecting config
-          # GITHUB_ACTIONS_CONFIG_FILE: "actionlint.yml" => basically unneeded
-          # GITLEAKS_CONFIG: ".gitleaks.toml" # Path to your Gitleaks config if you have one
-          JAVASCRIPT_ES_CONFIG_FILE: "eslint.config.js"
-          # MARKDOWN_CONFIG_FILE: ".markdown-lint.yml"
-          # NATURAL_LANGUAGE_CONFIG_FILE: "textlint.config.js"
-          PRETTIER_CONFIG: "prettier.config.js"
-          TYPESCRIPT_ES_CONFIG_FILE: "eslint.config.js"
-          TYPESCRIPT_STANDARD_TSCONFIG_FILE: "tsconfig.json"
-          # VALIDATE_CSS_PRETTIER: true
-          VALIDATE_DOCKERFILE: true
-          VALIDATE_EDITORCONFIG: true
-          VALIDATE_ENV: true
-          VALIDATE_GIT_COMMITLINT: true
-          VALIDATE_GIT_MERGE_CONFLICT_MARKERS: true
-          VALIDATE_GITHUB_ACTIONS: true
-          VALIDATE_GITLEAKS: true
-          VALIDATE_GRAPHQL_PRETTIER: true
-          VALIDATE_HTML_PRETTIER: true
-          VALIDATE_JAVASCRIPT_PRETTIER: true
-          VALIDATE_JSON_PRETTIER: true
-          VALIDATE_JSX_PRETTIER: true
-          # VALIDATE_MARKDOWN_PRETTIER: true => disabling because its annoying and doesn't respect anything
-          # VALIDATE_NATURAL_LANGUAGE: true
-          VALIDATE_TSX: true
-          VALIDATE_TYPESCRIPT_PRETTIER: true
-          VALIDATE_YAML: true # turning on for now while prettier is broken
-          # VALIDATE_YAML_PRETTIER: true => turning it off because its writing 4 spaces instead of 2
-          YAML_CONFIG_FILE: "yamllint.config.yml"
-
-      - uses: stefanzweifel/git-auto-commit-action@v5
-        name: Commit and push linting fixes
-        # Run only on:
-        # - Pull requests
-        # - Not on the default branch
-        if: >
-          github.event_name == 'pull_request' &&
-          github.ref_name != github.event.repository.default_branch
-        with:
-          branch: ${{ github.event.pull_request.head.ref || github.head_ref || github.ref }}
-          commit_message: "chore: fix linting issues"
-          commit_options: "--no-verify --signoff"
-          commit_user_name: super-linter
-          commit_user_email: super-linter@super-linter.dev

package/.github/workflows/publish.yml

@@ -1,71 +0,0 @@
-name: Publish
-
-on: # yamllint disable-line rule:truthy
-  push:
-    branches:
-      - main
-
-permissions:
-  contents: write
-  packages: write
-  pull-requests: write
-
-jobs:
-  release:
-    name: Version using Semantic Versioning
-    runs-on: ubuntu-latest
-    steps:
-      - uses: googleapis/release-please-action@v4
-        id: release
-        with:
-          release-type: node
-          # The short ref name of the branch or tag that triggered
-          #  the workflow run. For example, `main` or `1.x`
-          target-branch: ${{ github.ref_name }}
-
-  publish-npm:
-    name: Publish to NPM
-    runs-on: ubuntu-latest
-    needs: release
-    steps:
-      - uses: actions/checkout@v4
-        name: Checkout repository
-
-      - uses: actions/setup-node@v4
-        name: Setup Node.js @v20
-        with:
-          cache: npm
-          node-version: 20.x
-          registry-url: 'https://registry.npmjs.org'
-
-      - run: npm ci
-        name: Install dependencies
-
-      - run: npm publish
-        name: Publish to GitHub
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
-
-  publish-gh:
-    name: Publish to GitHub
-    runs-on: ubuntu-latest
-    needs: release
-    steps:
-      - uses: actions/checkout@v4
-        name: Checkout repository
-
-      - uses: actions/setup-node@v4
-        name: Setup Node.js @v20
-        with:
-          cache: npm
-          node-version: 20.x
-          registry-url: 'https://npm.pkg.github.com'
-          scope: '@theholocron'
-
-      - run: npm ci
-        name: Install dependencies
-
-      - run: npm publish --access public
-        name: Publish to GitHub Packages
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}

package/.github/workflows/review.yml

@@ -1,72 +0,0 @@
-name: Review
-
-on: # yamllint disable-line rule:truthy
-  - push
-  - pull_request
-
-jobs:
-  reviewdog:
-    name: Review PRs
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        name: Checkout repository
-
-      - uses: actions/setup-node@v4
-        name: Setup Node.js @v20
-        with:
-          cache: npm
-          node-version: 20.x
-
-      - run: npm ci
-        name: Install dependencies
-
-      - uses: reviewdog/action-setup@v1
-        name: Install & setup ReviewDog
-        with:
-          reviewdog_version: latest # Optional. [latest,nightly,v.X.Y.Z]
-
-      - uses: reviewdog/action-gitleaks@v1
-        name: Detect secrets using Gitleaks
-        with:
-          reporter: github-pr-check
-
-      - uses: reviewdog/action-alex@v1
-        name: Check language using Alex
-        with:
-          reporter: github-pr-check # [github-pr-check,github-check,github-pr-review]
-          # GitHub Status Check won't become failure with warning.
-          # level: warning # [info,warning, error]
-
-      - uses: EPMatt/reviewdog-action-tsc@v1
-        name: Check types using TypeScript
-        with:
-          reporter: github-pr-check
-
-      # - uses: reviewdog/action-stylelint@v1
-      #   name: Check CSS using StyleLint
-      #   with:
-      #     reporter: github-pr-check
-      #     stylelint_input: '**/*.css'
-
-      # need to setup textlint in the repo for this
-      # - uses: tsuyoshicho/action-textlint@v3
-      #   name: Check text using TextLint
-      #   with:
-      #     reporter: github-pr-check
-
-      - uses: reviewdog/action-actionlint@v1
-        name: Check GitHub Actions using ActionLint
-        with:
-          reporter: github-pr-check
-
-      - uses: dotenv-linter/action-dotenv-linter@v2
-        name: Check environment variables using dotenv
-        with:
-          reporter: github-code-suggestions
-
-      - uses: reviewdog/action-yamllint@v1
-        name: Check YAML using YamlLint
-        with:
-          reporter: github-pr-check
-          yamllint_flags: "-c ${{ github.workspace }}/yamllint.config.yml ${{ github.workspace }}"

package/.github/workflows/stale.yml

@@ -1,25 +0,0 @@
-name: Stale
-
-on: # yamllint disable-line rule:truthy
-  schedule:
-    - cron: "30 1 * * *"
-
-jobs:
-  stale:
-    name: Mark stale issues and pull requests
-    permissions:
-      contents: write # only for delete-branch option
-      issues: write
-      pull-requests: write
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/stale@v9
-        with:
-          close-issue-message: "This issue was closed because it has been stalled for 5 days with no activity."
-          days-before-close: 5
-          days-before-stale: 30
-          exempt-all-pr-milestones: true
-          stale-issue-label: "wontfix"
-          stale-issue-message: "This issue is stale because it has been open 30 days with no activity. Remove stale label or comment or this will be closed in 5 days."
-          stale-pr-label: "wontfix"
-          stale-pr-message: "This PR is stale because it has been open 45 days with no activity. Remove stale label or comment or this will be closed in 10 days."

package/.husky/commit-msg

@@ -1 +0,0 @@
-npx --no -- commitlint --edit $1

package/.husky/pre-commit

@@ -1,13 +0,0 @@
-#!/bin/sh
-
-# Run GitLeaks to detect secrets
-gitleaks git --no-banner
-
-# Exit with non-zero if secrets are detected by GitLeaks
-if [ $? -ne 0 ]; then
-	echo "Secrets detected by GitLeaks, aborting commit!"
-	exit 1
-fi
-
-# Run lint-staged with a custom config
-npx lint-staged --config @theholocron/lint-staged-config

package/.husky/prepare-commit-msg

@@ -1,18 +0,0 @@
-#!/bin/sh
-
-NAME=$(git config user.name)
-EMAIL=$(git config user.email)
-
-if [ -z "$NAME" ]; then
-	echo "empty git config user.name"
-	exit 1
-fi
-
-if [ -z "$EMAIL" ]; then
-	echo "empty git config user.email"
-	exit 1
-fi
-
-git interpret-trailers --if-exists doNothing --trailer \
-	"Signed-off-by: $NAME <$EMAIL>" \
-	--in-place "$1"

package/commitlint.config.js

@@ -1,9 +0,0 @@
-/**
- * @see https://commitlint.js.org/reference/configuration.html
- * @type {import("@commitlint/types").UserConfig}
- */
-const config = {
-	extends: ["@theholocron"],
-};
-
-export default config;

package/eslint.config.js

@@ -1,9 +0,0 @@
-import theHolocron from "@theholocron/eslint-config";
-
-/**
- * @see https://eslint.org/docs/latest/use/configure/
- * @type {import("eslint").Linter.Config}
- */
-const config = [...theHolocron];
-
-export default config;

package/media/README.md

@@ -1,11 +0,0 @@
-# Media
-
-The following is a storage place for all of the media used within `holocron`.
-
-## What's Available
-
-### MP3s
-
--   error.mp3 - used for when a command errs, and the `--sound` flag is enabled
--   warning.mp3 - used for when a command has a warning, and the `--sound` flag is enabled
--   success.mp3 - used for when a command is successful, and the `--sound` flag is enabled

package/prettier.config.js

@@ -1,11 +0,0 @@
-import theholocron from "@theholocron/prettier-config";
-
-/**
- * @see https://prettier.io/docs/en/configuration
- * @type {import("prettier").Config}
- */
-const config = {
-	...theholocron,
-};
-
-export default config;