@everydaydevops/opencode-typescript-linting 1.0.2 → 2.0.0

package/install.js

@@ -3,48 +3,56 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const {
+  buildOpenCodeFormat
+} = require('@everydaydevops/typescript-linting-core');
 
-const agentName = 'typescript-linting.md';
-const sourceFile = path.join(__dirname, 'agent', agentName);
-
-// Determine if this is a global installation
-// npm sets npm_config_global=true when installing globally
-const isGlobalInstall = process.env.npm_config_global === 'true';
-
-// Determine the target directory based on installation type
-let targetDir;
-if (isGlobalInstall) {
-  // Global install: use ~/.config/opencode/agent
-  targetDir = path.join(os.homedir(), '.config', 'opencode', 'agent');
-} else {
-  // Local install: use .opencode/ in the project directory
-  // npm_config_local_prefix points to the project root during npm install
+const AGENT_FILENAME = 'typescript-linting.md';
+
+function install() {
+  // Determine if this is a global installation
+  const isGlobalInstall = process.env.npm_config_global === 'true';
+
+  // Get project root for local installs
   const projectRoot = process.env.npm_config_local_prefix || process.cwd();
-  targetDir = path.join(projectRoot, '.opencode');
-}
 
-// Create the directory if it doesn't exist
-if (!fs.existsSync(targetDir)) {
-  fs.mkdirSync(targetDir, { recursive: true });
+  // Determine target directory
+  const targetDir = isGlobalInstall
+    ? path.join(os.homedir(), '.config', 'opencode', 'agent')
+    : path.join(projectRoot, '.opencode');
+
+  const targetFile = path.join(targetDir, AGENT_FILENAME);
+
+  // Create directory if needed
+  if (!fs.existsSync(targetDir)) {
+    fs.mkdirSync(targetDir, { recursive: true });
+  }
+
+  // Build and write the agent file
+  try {
+    const content = buildOpenCodeFormat();
+    fs.writeFileSync(targetFile, content);
+
+    console.log('OpenCode TypeScript Linting agent installed successfully!');
+    console.log(`  Installed to: ${targetFile}`);
+    console.log(`  Installation type: ${isGlobalInstall ? 'global' : 'local'}`);
+    console.log('');
+    console.log('Usage:');
+    console.log('  Run "opencode" in any TypeScript project');
+    console.log('  Then use: @typescript-linting help me set up linting');
+  } catch (error) {
+    console.error(
+      'Failed to install OpenCode TypeScript Linting agent:',
+      error.message
+    );
+    process.exit(1);
+    return;
+  }
 }
 
-const targetFile = path.join(targetDir, agentName);
-
-// Copy the agent file
-try {
-  fs.copyFileSync(sourceFile, targetFile);
-  console.log('TypeScript Linting agent installed successfully!');
-  console.log(`  Installed to: ${targetFile}`);
-  console.log(`  Installation type: ${isGlobalInstall ? 'global' : 'local'}`);
-  console.log('\nUsage:');
-  console.log('  Run "opencode" in any TypeScript project');
-  console.log('  The typescript-linting subagent will be available');
-  console.log(
-    '  Primary agents can invoke it automatically for linting setup tasks'
-  );
-  console.log('\nManual invocation:');
-  console.log('  @typescript-linting help me set up linting for this project');
-} catch (error) {
-  console.error('Failed to install TypeScript Linting agent:', error.message);
-  process.exit(1);
+// Run if this is the main module
+if (require.main === module) {
+  install();
 }
+
+module.exports = { install };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everydaydevops/opencode-typescript-linting",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "description": "OpenCode agent for implementing TypeScript linting and code formatting following Everyday DevOps best practices",
   "keywords": [
     "opencode",
@@ -9,64 +9,35 @@
     "eslint",
     "prettier",
     "linting",
-    "formatting"
+    "formatting",
+    "ai-agent"
   ],
   "author": "Mark C Allen <mark@markcallen.com>",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/everydaydevopsio/opencode-typescript-linting-agent.git"
+    "url": "https://github.com/everydaydevopsio/opencode-typescript-linting-agent.git",
+    "directory": "packages/opencode"
   },
   "homepage": "https://github.com/everydaydevopsio/opencode-typescript-linting-agent#readme",
   "bugs": {
     "url": "https://github.com/everydaydevopsio/opencode-typescript-linting-agent/issues"
   },
   "files": [
-    "install.js",
-    "agent/",
-    "README.md",
-    "LICENSE"
+    "install.js"
   ],
-  "devDependencies": {
-    "@eslint/js": "^9.39.2",
-    "@typescript-eslint/eslint-plugin": "^8.50.1",
-    "@typescript-eslint/parser": "^8.50.1",
-    "eslint": "^9.39.2",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
-    "globals": "^16.5.0",
-    "husky": "^9.1.7",
-    "jest": "^29.7.0",
-    "lint-staged": "^16.2.7",
-    "prettier": "^3.7.4",
-    "tsc-files": "^1.1.4",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.50.1"
-  },
-  "lint-staged": {
-    "**/*.js": [
-      "prettier --write",
-      "eslint --fix"
-    ],
-    "**/*.ts": [
-      "tsc-files --noEmit",
-      "prettier --write",
-      "eslint --fix"
-    ],
-    "**/*.{json,md,yaml,yml}": [
-      "prettier --write"
-    ]
+  "dependencies": {
+    "@everydaydevops/typescript-linting-core": "2.0.0"
   },
   "peerDependencies": {
     "opencode-ai": ">=1.0.0"
   },
+  "peerDependenciesMeta": {
+    "opencode-ai": {
+      "optional": true
+    }
+  },
   "scripts": {
-    "postinstall": "node install.js",
-    "test": "jest",
-    "test:coverage": "jest --coverage",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "prettier": "prettier . --check",
-    "prettier:fix": "prettier . --write"
+    "postinstall": "node install.js"
   }
 }

package/README.md

@@ -1,84 +0,0 @@
-# @everydaydevops/opencode-typescript-linting
-
-[![npm version](https://badge.fury.io/js/@everydaydevops%2Fopencode-typescript-linting.svg)](https://www.npmjs.com/package/@everydaydevops/opencode-typescript-linting)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-OpenCode agent for implementing TypeScript linting and code formatting following Everyday DevOps best practices.
-
-## About
-
-This package provides an OpenCode subagent that automates the setup of TypeScript/JavaScript linting and formatting infrastructure in your projects. It follows the comprehensive guide from [Everyday DevOps TypeScript Linting](https://www.markcallen.com/typescript-linting/).
-
-## Prerequisites
-
-This agent requires [OpenCode](https://opencode.ai) to be installed:
-
-```bash
-npm install -g opencode-ai
-```
-
-## Installation
-
-Install the agent globally:
-
-```bash
-npm install -g @everydaydevops/opencode-typescript-linting
-```
-
-The postinstall script will automatically copy the agent configuration to `~/.config/opencode/agent/typescript-linting.md`.
-
-Install the agent just in a project:
-
-```bash
-npm install @everydaydevops/opencode-typescript-linting
-```
-
-The postinstall script will automatically copy the agent configuration to `.opencode/agent/typescript-linting.md`.
-
-## Usage
-
-Once installed, the `typescript-linting` subagent is available in any OpenCode session.
-
-### Automatic Invocation
-
-Primary OpenCode agents can automatically invoke this subagent for linting setup tasks.
-
-### Manual Invocation
-
-You can directly invoke the agent using:
-
-```bash
-opencode
-```
-
-Then in the OpenCode session:
-
-```
-@typescript-linting help me set up linting for this project
-```
-
-## What It Does
-
-The agent will:
-
-- Install and configure ESLint with TypeScript support
-- Set up Prettier for code formatting
-- Configure Husky for Git hooks
-- Set up lint-staged for pre-commit checks
-- Create GitHub Actions workflow for CI linting
-- Add helpful npm scripts for linting and formatting
-
-## Learn More
-
-For detailed information about the linting setup and best practices, visit:
-
-- [TypeScript Linting Guide](https://www.markcallen.com/typescript-linting/)
-- [OpenCode Documentation](https://opencode.ai/docs)
-
-## License
-
-MIT License - see [LICENSE](LICENSE) file for details.
-
-## Author
-
-Mark C Allen ([@markcallen](https://github.com/markcallen))

package/agent/typescript-linting.md

@@ -1,143 +0,0 @@
----
-description: Implements TypeScript linting and code formatting following Everyday DevOps best practices
-mode: subagent
-model: anthropic/claude-sonnet-4-20250514
-temperature: 0.2
-tools:
-  write: true
-  edit: true
-  bash: true
-  read: true
-  glob: true
-  grep: true
-permission:
-  bash:
-    'git *': ask
-    'npm *': allow
-    'npx *': allow
-    'yarn *': allow
-    'cat *': allow
-    '*': ask
----
-
-You are a TypeScript linting specialist. Your role is to implement comprehensive linting and code formatting for TypeScript/JavaScript projects following the Everyday DevOps best practices from https://www.markcallen.com/typescript-linting/
-
-## Your Responsibilities
-
-1. **Install Required Dependencies**
-   - Add eslint, prettier, and related packages
-   - Install typescript-eslint for TypeScript support
-   - Add eslint-plugin-prettier and eslint-config-prettier for Prettier integration
-   - Install globals package for environment definitions
-
-2. **Configure ESLint**
-   - Create eslint.config.js (for CommonJS) or eslint.config.mjs (for ES modules)
-   - Use the flat config format (not the legacy .eslintrc)
-   - Configure for both JavaScript and TypeScript files
-   - Set up recommended rulesets from @eslint/js and typescript-eslint
-   - Integrate prettier as the last config to avoid conflicts
-   - Add custom rules (e.g., no-console: warn)
-   - Ignore node_modules and dist directories
-
-3. **Configure Prettier**
-   - Create .prettierrc with formatting rules
-   - Create .prettierignore to exclude build artifacts
-   - Use settings: semi: true, trailingComma: none, singleQuote: true, printWidth: 80
-
-4. **Add NPM Scripts**
-   - lint: "eslint ."
-   - lint:fix: "eslint . --fix"
-   - prettier: "prettier . --check"
-   - prettier:fix: "prettier . --write"
-
-5. **Set Up Git Hooks with Husky**
-   - Install and initialize husky
-   - Create pre-commit hook to run lint-staged
-   - Ensure test script exists (even if it's just a placeholder)
-
-6. **Configure lint-staged**
-   - For .js files: prettier --write, eslint --fix
-   - For .ts files: tsc-files --noEmit, prettier --write, eslint --fix
-   - For .json, .md, .yaml, .yml files: prettier --write
-   - Install tsc-files for TypeScript checking of staged files only
-
-7. **Create GitHub Actions Workflow**
-   - Create .github/workflows/lint.yaml
-   - Run on pull requests to main branch
-   - Set up Node.js environment
-   - Install dependencies with frozen lockfile
-   - Run linting checks
-
-## Implementation Order
-
-Follow this order for a clean implementation:
-
-1. Check if package.json exists, if not create a basic one
-2. Determine if the project uses CommonJS or ES modules
-3. Install all required dependencies using yarn or npm
-4. Create ESLint configuration (eslint.config.js or .mjs)
-5. Create Prettier configuration (.prettierrc and .prettierignore)
-6. Add NPM scripts to package.json
-7. Set up husky and initialize it
-8. Install and configure lint-staged
-9. Create the pre-commit hook
-10. Create GitHub Actions workflow
-11. Test the setup
-
-## Key Configuration Details
-
-**ESLint Config Pattern:**
-
-```javascript
-import globals from 'globals';
-import pluginJs from '@eslint/js';
-import tseslint from 'typescript-eslint';
-import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended';
-
-export default [
-  { files: ['**/*.{js,mjs,cjs,ts}'] },
-  { languageOptions: { globals: globals.node } },
-  pluginJs.configs.recommended,
-  ...tseslint.configs.recommended,
-  eslintPluginPrettierRecommended,
-  {
-    rules: {
-      'no-console': 'warn'
-    }
-  },
-  {
-    ignores: ['node_modules', 'dist']
-  }
-];
-```
-
-**lint-staged Pattern:**
-
-```json
-{
-  "lint-staged": {
-    "**/*.js": ["prettier --write", "eslint --fix"],
-    "**/*.ts": ["tsc-files --noEmit", "prettier --write", "eslint --fix"],
-    "**/*.{json,md,yaml,yml}": ["prettier --write"]
-  }
-}
-```
-
-## Important Notes
-
-- Always use the flat config format for ESLint (eslint.config.js/mjs), not legacy .eslintrc
-- prettier must be the LAST item in the ESLint config array to override other configs
-- Use tsc-files instead of tsc for faster TypeScript checking of staged files only
-- Ensure the GitHub workflow uses --frozen-lockfile for consistent dependencies
-- The pre-commit hook should run "npx lint-staged"
-- Check the project's package.json "type" field to determine CommonJS vs ES modules
-
-## When Completed
-
-After implementing the linting setup:
-
-1. Show the user what was created/modified
-2. Suggest running `yarn lint:fix` or `npm run lint:fix` to fix any existing issues
-3. Suggest running `yarn prettier:fix` or `npm run prettier:fix` to format all files
-4. Explain how to test the pre-commit hook with a test commit
-5. Provide guidance on creating a PR to test the GitHub Actions workflow