@codifycli/plugin-core 1.0.0-beta1 → 1.0.0-beta3

package/.github/workflows/unit-test-ci.yaml

@@ -1,18 +1,24 @@
 # This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
 # For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs
 
-name: Unit tests
+name: Node.js CI
 
-on: [ push ]
+on: [ 'push' ]
 
 jobs:
   build-and-test:
-    runs-on: macos-latest
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      matrix:
+        os: [ ubuntu-latest, macos-latest ]
+
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - name: Use Node.js 22
+        uses: actions/setup-node@v4
         with:
-          node-version: '20.x'
+          node-version: '22.x'
           cache: 'npm'
       - run: npm ci
       - run: npm run test

package/CLAUDE.md

@@ -0,0 +1,183 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+`@codifycli/plugin-core` is a TypeScript library for building Codify plugins. Codify is an infrastructure-as-code tool
+that manages system resources (applications, CLI tools, settings) through a declarative JSON configuration. This library
+provides the core abstractions and runtime for implementing plugins that can create, modify, and destroy system
+resources.
+
+## Development Commands
+
+### Testing
+
+```bash
+# Run all tests with Vitest
+npm test
+
+# Note: `npm test` also runs TypeScript compilation as a posttest step
+```
+
+### Building
+
+```bash
+# Compile TypeScript to dist/
+npm run prepublishOnly
+
+# Or just compile directly
+npx tsc
+```
+
+### Linting
+
+```bash
+# Lint with ESLint (oclif + oclif-typescript + prettier configs)
+npx eslint src/
+```
+
+### CLI Tool
+
+The package includes a `codify-build` CLI tool (in `bin/build.js`) used by plugin implementations to generate
+documentation and validate schemas.
+
+## Architecture
+
+### Core Concepts
+
+**Plugin System Architecture:**
+
+- **Plugin** (`src/plugin/plugin.ts`): Top-level container that manages multiple resource types and handles IPC
+  communication with the Codify CLI via the MessageHandler
+- **Resource** (`src/resource/resource.ts`): Abstract base class representing a manageable system resource (e.g.,
+  homebrew, git config, applications). Each resource must implement:
+    - `refresh()`: Query current system state
+    - `create()`: Install/create the resource
+    - `destroy()`: Uninstall/remove the resource
+    - `modify()`: Update individual parameters (optional)
+- **Plan** (`src/plan/plan.ts`): Represents a set of changes to transform current state into desired state, similar to
+  Terraform plans. Contains a ChangeSet with parameter-level operations (ADD/REMOVE/MODIFY/NO-OP) and resource-level
+  operation (CREATE/DESTROY/MODIFY/RECREATE/NO-OP)
+- **ResourceController** (`src/resource/resource-controller.ts`): Orchestrates the full lifecycle: validation →
+  planning → application. Handles both stateful mode (tracks state between runs) and stateless mode (declarative only)
+
+**Stateful vs Stateless Modes:**
+
+- **Stateless**: Plans computed by comparing desired config against current system state. Only manages parameters
+  explicitly declared in config.
+- **Stateful**: Tracks previous state. Enables destroy operations and more granular change detection. Plans compare
+  desired vs state, then match state to current system state.
+
+**Stateful Parameters** (`src/stateful-parameter/stateful-parameter.ts`):
+
+- Parameters that have their own lifecycle tied to the parent resource (e.g., homebrew formulas, nvm node versions)
+- Implement their own `refresh()`, `add()`, `modify()`, `remove()` methods
+- Can be array-based (`ArrayStatefulParameter`) for managing collections
+
+**PTY Abstraction** (`src/pty/`):
+
+- `BackgroundPty`: Executes commands asynchronously during refresh/plan operations. Multiple commands can run in
+  parallel. Killed after planning completes.
+- `SequentialPty`: Executes commands synchronously during apply operations to ensure ordered execution and proper error
+  handling
+- `getPty()`: Access current PTY from async local storage context
+- All shell execution goes through this abstraction for consistent output handling and root privilege escalation
+
+**IPC Communication** (`src/messages/`):
+
+- `MessageHandler`: Processes messages from Codify CLI (initialize, plan, apply, validate, import, match)
+- `MessageSender`: Sends responses and requests (e.g., sudo password prompts) back to CLI
+- Messages validated against schemas from `@codifycli/schemas`
+
+### Directory Structure
+
+```
+src/
+├── plugin/          - Plugin class and main entry point
+├── resource/        - Resource base class, settings, controller
+├── plan/            - Plan calculation and change set logic
+├── stateful-parameter/ - Stateful parameter abstractions
+├── pty/             - Pseudo-terminal abstraction for shell commands
+├── messages/        - IPC message handlers and senders
+├── utils/           - File utilities, path resolution, debug logging
+└── common/          - Shared errors and types
+```
+
+### Key Files
+
+- `src/index.ts`: Main entry point with `runPlugin()` function
+- `src/plugin/plugin.ts`: Core plugin implementation (~290 lines)
+- `src/resource/resource.ts`: Abstract Resource class
+- `src/resource/resource-controller.ts`: Resource lifecycle orchestration
+- `src/resource/resource-settings.ts`: Configuration schema for resources (parameter settings, OS support, allow
+  multiple, etc.)
+- `src/plan/plan.ts`: Plan calculation logic (~500 lines)
+- `src/plan/change-set.ts`: Parameter-level diff algorithm
+- `bin/build.js`: Documentation/schema builder for plugin implementations
+
+### Resource Settings
+
+Resources are configured via `ResourceSettings<T>` returned by `getSettings()`:
+
+- `id`: Unique type identifier
+- `schema`: JSON Schema or Zod schema for validation
+- `operatingSystems`: Supported OS platforms (darwin/linux/win32)
+- `linuxDistros`: Supported Linux distributions (optional)
+- `allowMultiple`: Whether multiple instances can coexist (requires `matcher` function)
+- `parameterSettings`: Per-parameter configuration (equals functions, transformations, stateful types, sensitivity)
+- `isSensitive`: Marks resource as sensitive (prevents auto-import, hides values)
+- `dependencies`: Resource IDs this resource depends on
+- `canDestroy`: Whether resource can be destroyed (default: true)
+
+## Implementation Notes
+
+### Testing
+
+- Uses Vitest with `pool: 'forks'` configuration for isolated test execution
+- Test files use `.test.ts` suffix and are excluded from compilation
+- TypeScript compilation runs as a posttest step to catch type errors
+
+### Module System
+
+- Uses ES modules (`"type": "module"` in package.json)
+- Module resolution: `Node16` with `.js` extensions in imports (even for `.ts` files)
+- Target: ES2022
+- Requires Node.js >=22.0.0
+
+### Parameter Matching and Filtering
+
+Array parameters support custom matching logic:
+
+- `isElementEqual`: Function to compare array elements
+- `filterInStatelessMode`: Controls how current state is filtered against desired state in stateless mode
+- Default behavior: filters current arrays to only include elements matching desired config (prevents spurious deletes)
+
+### Path Handling
+
+Utility functions in `src/utils/functions.ts`:
+
+- `tildify()`: Convert absolute paths to use `~`
+- `untildify()`: Expand `~` to home directory
+- `resolvePathWithVariables()`: Resolve paths with variables like `$CODIFY_*`
+- Path transformations are commonly used in `InputTransformation` for file/directory parameters
+
+### CI/CD
+
+GitHub Actions workflow (`.github/workflows/unit-test-ci.yaml`):
+
+- Runs on push to any branch
+- Tests on: `ubuntu-latest`, `macos-latest`
+- Node.js version: 22.x
+- Commands: `npm ci` → `npm run test`
+
+### Dependencies
+
+Key dependencies:
+
+- `@codifycli/schemas`: Shared schema definitions and types
+- `@homebridge/node-pty-prebuilt-multiarch`: PTY for shell command execution
+- `ajv`: JSON Schema validation
+- `zod`: Alternative schema validation (v4)
+- `clean-deep`: Remove null/undefined from objects
+- `lodash.isequal`: Deep equality checks

package/README.md

@@ -0,0 +1,427 @@
+# @codifycli/plugin-core
+
+Core library for building [Codify](https://github.com/codifycli) plugins. Codify is an infrastructure-as-code tool that
+manages system resources (applications, CLI tools, and settings) through declarative JSON configuration files.
+
+## Overview
+
+This library provides the foundational abstractions and runtime for creating Codify plugins. Plugins extend Codify's
+capabilities by implementing resources that can be created, modified, and destroyed on a system. Examples of resources
+include:
+
+- **CLI Tools**: Homebrew, Docker, Git
+- **Applications**: Google Chrome, VS Code, Zoom
+- **Settings**: Git configs, AWS profiles, system preferences
+
+## Installation
+
+```bash
+npm install @codifycli/plugin-core
+```
+
+**Requirements:**
+
+- Node.js >= 22.0.0
+- TypeScript 5.x (for development)
+
+## Quick Start
+
+Here's a minimal example of creating a plugin with a single resource:
+
+```typescript
+import { Resource, ResourceSettings, Plugin, runPlugin, getPty } from '@codifycli/plugin-core';
+import { StringIndexedObject } from '@codifycli/schemas';
+
+// Define the resource configuration type
+interface GitConfig extends StringIndexedObject {
+  userName?: string;
+  userEmail?: string;
+}
+
+// Implement the Resource abstract class
+class GitConfigResource extends Resource<GitConfig> {
+  getSettings(): ResourceSettings<GitConfig> {
+    return {
+      id: 'git-config',
+      operatingSystems: ['darwin', 'linux'],
+      schema: {
+        type: 'object',
+        properties: {
+          userName: { type: 'string' },
+          userEmail: { type: 'string' }
+        }
+      }
+    };
+  }
+
+  async refresh(parameters: Partial<GitConfig>) {
+    const pty = getPty();
+
+    const nameResult = await pty.spawnSafe('git config --global user.name');
+    const emailResult = await pty.spawnSafe('git config --global user.email');
+
+    return {
+      userName: nameResult.status === 'success' ? nameResult.data.trim() : undefined,
+      userEmail: emailResult.status === 'success' ? emailResult.data.trim() : undefined
+    };
+  }
+
+  async create(plan) {
+    const pty = getPty();
+    const config = plan.desiredConfig!;
+
+    if (config.userName) {
+      await pty.spawn(`git config --global user.name "${config.userName}"`);
+    }
+    if (config.userEmail) {
+      await pty.spawn(`git config --global user.email "${config.userEmail}"`);
+    }
+  }
+
+  async destroy(plan) {
+    const pty = getPty();
+
+    await pty.spawn('git config --global --unset user.name');
+    await pty.spawn('git config --global --unset user.email');
+  }
+}
+
+// Create and run the plugin
+const plugin = Plugin.create('my-plugin', [new GitConfigResource()]);
+runPlugin(plugin);
+```
+
+## Core Concepts
+
+### Plugin
+
+The top-level container that manages multiple resource types. Handles IPC communication with the Codify CLI.
+
+```typescript
+const plugin = Plugin.create('plugin-name', [
+  new Resource1(),
+  new Resource2(),
+  // ... more resources
+]);
+
+runPlugin(plugin);
+```
+
+### Resource
+
+The fundamental building block representing a manageable system entity. Resources must implement:
+
+- **`getSettings()`**: Return resource configuration (id, schema, OS support, etc.)
+- **`refresh(parameters, context)`**: Query the current system state
+- **`create(plan)`**: Install/create the resource
+- **`destroy(plan)`**: Uninstall/remove the resource
+- **`modify(parameterChange, plan)`**: Update individual parameters (optional)
+
+### Plan
+
+Represents a set of changes needed to transform the current state into the desired state. Plans contain:
+
+- **Resource Operation**: CREATE, DESTROY, MODIFY, RECREATE, or NOOP
+- **Parameter Changes**: Individual parameter-level operations (ADD, REMOVE, MODIFY, NOOP)
+
+The planning workflow:
+
+1. **Validate**: Check user configuration against schema
+2. **Plan**: Compare desired vs. current state, generate change set
+3. **Apply**: Execute the plan to make changes
+
+### Stateful vs Stateless Modes
+
+**Stateless Mode** (default):
+
+- Plans computed by comparing desired config against current system state
+- Only manages parameters explicitly declared in config
+- No destroy operations (removing from config = ignored by Codify)
+
+**Stateful Mode**:
+
+- Tracks previous state between runs
+- Supports destroy operations
+- Plans compare desired vs. state, then match state to current system
+- Enables granular change detection
+
+### Stateful Parameters
+
+Parameters with their own lifecycle, tied to the parent resource. Examples:
+
+- Homebrew formulas (can be installed/uninstalled within Homebrew)
+- NVM Node versions (managed within NVM)
+
+```typescript
+import { StatefulParameter } from '@codifycli/plugin-core';
+
+class BrewFormulaParameter extends StatefulParameter<BrewConfig, string[]> {
+  async refresh(desired, config) {
+    const pty = getPty();
+    const result = await pty.spawn('brew list --formula');
+    return result.data.split('\n').filter(Boolean);
+  }
+
+  async add(formulas, plan) {
+    const pty = getPty();
+    await pty.spawn(`brew install --formula ${formulas.join(' ')}`);
+  }
+
+  async remove(formulas, plan) {
+    const pty = getPty();
+    await pty.spawn(`brew uninstall --formula ${formulas.join(' ')}`);
+  }
+
+  async modify(newValue, previousValue, plan) {
+    // Handle formula updates
+  }
+}
+```
+
+Register in resource settings:
+
+```typescript
+getSettings()
+:
+ResourceSettings < BrewConfig > {
+  return {
+    id: 'homebrew',
+    parameterSettings: {
+      formulas: {
+        type: 'stateful',
+        implementation: new BrewFormulaParameter()
+      }
+    }
+  };
+}
+```
+
+### PTY Abstraction
+
+Execute shell commands through the PTY abstraction:
+
+```typescript
+import { getPty } from '@codifycli/plugin-core';
+
+const pty = getPty();
+
+// Spawn command (throws on non-zero exit)
+const result = await pty.spawn('brew install jq');
+
+// Spawn safely (returns result with status)
+const safeResult = await pty.spawnSafe('which jq');
+if (safeResult.status === 'success') {
+  console.log(safeResult.data);
+}
+
+// With options
+await pty.spawn('npm install', {
+  cwd: '/path/to/project',
+  env: { NODE_ENV: 'production' },
+  interactive: true,
+  requiresRoot: false
+});
+```
+
+Two PTY implementations:
+
+- **BackgroundPty**: Async execution during refresh/plan (killed after planning)
+- **SequentialPty**: Sync execution during apply operations
+
+## Resource Settings
+
+Configure resource behavior via `ResourceSettings<T>`:
+
+```typescript
+getSettings()
+:
+ResourceSettings < MyConfig > {
+  return {
+    // Required: unique type identifier
+    id: 'my-resource',
+
+    // Required: supported operating systems
+    operatingSystems: ['darwin', 'linux', 'win32'],
+
+    // Optional: supported Linux distributions
+    linuxDistros: ['ubuntu', 'debian', 'fedora'],
+
+    // Schema for validation (JSON Schema or Zod)
+    schema: {
+      type: 'object',
+      properties: {
+        version: { type: 'string' },
+        path: { type: 'string' }
+      },
+      required: ['version']
+    },
+
+    // Allow multiple instances
+    allowMultiple: {
+      identifyingParameters: ['name', 'path'],
+      matcher: (desired, current) => desired.name === current.name
+    },
+
+    // Prevent resource from being destroyed
+    canDestroy: false,
+
+    // Mark as sensitive (prevents auto-import)
+    isSensitive: true,
+
+    // Resource dependencies
+    dependencies: ['other-resource-id'],
+
+    // Per-parameter settings
+    parameterSettings: {
+      path: {
+        inputTransformation: {
+          to: (input) => untildify(input),    // Expand ~
+          from: (current) => tildify(current)  // Convert to ~
+        }
+      },
+      apiKey: {
+        isSensitive: true  // Hide in plan output
+      },
+      tags: {
+        type: 'array',
+        isElementEqual: (a, b) => a.name === b.name
+      }
+    }
+  };
+}
+```
+
+## API Reference
+
+### Core Classes
+
+#### `Plugin`
+
+- `static create(name: string, resources: Resource[]): Plugin`
+- `async initialize(data): Promise<InitializeResponseData>`
+- `async plan(data): Promise<PlanResponseData>`
+- `async apply(data): Promise<void>`
+- `async validate(data): Promise<ValidateResponseData>`
+- `async import(data): Promise<ImportResponseData>`
+- `async match(data): Promise<MatchResponseData>`
+
+#### `Resource<T>`
+
+- `abstract getSettings(): ResourceSettings<T>`
+- `async initialize(): Promise<void>`
+- `async validate(parameters): Promise<void>`
+- `abstract refresh(parameters, context): Promise<T | T[] | null>`
+- `abstract create(plan: CreatePlan<T>): Promise<void>`
+- `abstract destroy(plan: DestroyPlan<T>): Promise<void>`
+- `async modify(change: ParameterChange<T>, plan: ModifyPlan<T>): Promise<void>`
+
+#### `Plan<T>`
+
+- `id: string`
+- `changeSet: ChangeSet<T>`
+- `coreParameters: ResourceConfig`
+- `isStateful: boolean`
+- `desiredConfig: T | null`
+- `currentConfig: T | null`
+- `requiresChanges(): boolean`
+- `toResponse(): PlanResponseData`
+
+#### `StatefulParameter<T, V>`
+
+- `getSettings(): ParameterSetting`
+- `abstract refresh(desired, config): Promise<V | null>`
+- `abstract add(value, plan): Promise<void>`
+- `abstract modify(newValue, previousValue, plan): Promise<void>`
+- `abstract remove(value, plan): Promise<void>`
+
+### Utility Functions
+
+```typescript
+// PTY access
+getPty()
+:
+IPty
+
+// Path utilities
+tildify(absolutePath
+:
+string
+):
+string
+untildify(pathWithTilde
+:
+string
+):
+string
+resolvePathWithVariables(path
+:
+string
+):
+string
+addVariablesToPath(absolutePath
+:
+string
+):
+string
+
+// File utilities
+fileExists(path
+:
+string
+):
+Promise<boolean>
+directoryExists(path
+:
+string
+):
+Promise<boolean>
+
+// Array utilities
+areArraysEqual<T>(a
+:
+T[], b
+:
+T[], isEqual ? : (a: T, b: T) => boolean
+):
+boolean
+```
+
+## Building Plugins
+
+The library includes a `codify-build` CLI tool for plugin development:
+
+```bash
+# Generate plugin documentation and validate schemas
+npx codify-build
+```
+
+This tool expects a plugin implementation with a `src/resources/` directory structure.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Build
+npx tsc
+
+# Lint
+npx eslint src/
+```
+
+## Examples
+
+See the `@codifycli/plugin-core` tests for more examples:
+
+- `src/plugin/plugin.test.ts` - Plugin lifecycle
+- `src/resource/resource-controller.test.ts` - Resource operations
+- `src/plan/plan.test.ts` - Plan calculation
+- `src/stateful-parameter/stateful-parameter-controller.test.ts` - Stateful parameters
+
+## License
+
+ISC

package/bin/build.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
+import { IpcMessageSchema, MessageStatus, ResourceSchema } from '@codifycli/schemas';
 import { Ajv } from 'ajv';
-import { IpcMessageSchema, MessageStatus, ResourceSchema } from 'codify-schemas';
 import mergeJsonSchemas from 'merge-json-schemas';
 import { fork } from 'node:child_process';
 import fs from 'node:fs';

package/dist/messages/handlers.js

@@ -1,6 +1,6 @@
+import { ApplyRequestDataSchema, EmptyResponseDataSchema, GetResourceInfoRequestDataSchema, GetResourceInfoResponseDataSchema, ImportRequestDataSchema, ImportResponseDataSchema, InitializeRequestDataSchema, InitializeResponseDataSchema, IpcMessageSchema, IpcMessageV2Schema, MatchRequestDataSchema, MatchResponseDataSchema, MessageStatus, PlanRequestDataSchema, PlanResponseDataSchema, ResourceSchema, SetVerbosityRequestDataSchema, ValidateRequestDataSchema, ValidateResponseDataSchema } from '@codifycli/schemas';
 import { Ajv } from 'ajv';
 import addFormats from 'ajv-formats';
-import { ApplyRequestDataSchema, EmptyResponseDataSchema, GetResourceInfoRequestDataSchema, GetResourceInfoResponseDataSchema, ImportRequestDataSchema, ImportResponseDataSchema, InitializeRequestDataSchema, InitializeResponseDataSchema, IpcMessageSchema, IpcMessageV2Schema, MatchRequestDataSchema, MatchResponseDataSchema, MessageStatus, PlanRequestDataSchema, PlanResponseDataSchema, ResourceSchema, SetVerbosityRequestDataSchema, ValidateRequestDataSchema, ValidateResponseDataSchema } from 'codify-schemas';
 import { SudoError } from '../errors.js';
 const SupportedRequests = {
     'initialize': {

package/dist/messages/sender.js

@@ -1,5 +1,5 @@
+import { IpcMessageV2Schema, MessageCmd } from '@codifycli/schemas';
 import { Ajv } from 'ajv';
-import { IpcMessageV2Schema, MessageCmd } from 'codify-schemas';
 import { nanoid } from 'nanoid';
 const ajv = new Ajv({
     strict: true,

package/dist/plan/change-set.d.ts

@@ -1,4 +1,4 @@
-import { ParameterOperation, ResourceOperation, StringIndexedObject } from 'codify-schemas';
+import { ParameterOperation, ResourceOperation, StringIndexedObject } from '@codifycli/schemas';
 import { ParsedParameterSetting } from '../resource/parsed-resource-settings.js';
 import { ResourceSettings } from '../resource/resource-settings.js';
 /**

package/dist/plan/change-set.js

@@ -1,4 +1,4 @@
-import { ParameterOperation, ResourceOperation } from 'codify-schemas';
+import { ParameterOperation, ResourceOperation } from '@codifycli/schemas';
 // Change set will coerce undefined values to null because undefined is not valid JSON
 export class ChangeSet {
     operation;

package/dist/plan/plan-types.d.ts

@@ -1,4 +1,4 @@
-import { StringIndexedObject } from 'codify-schemas';
+import { StringIndexedObject } from '@codifycli/schemas';
 import { Plan } from './plan.js';
 /**
  * A narrower type for plans for CREATE operations. Only desiredConfig is not null.

package/dist/plan/plan.d.ts

@@ -1,4 +1,4 @@
-import { ApplyRequestData, PlanResponseData, ResourceConfig, StringIndexedObject } from 'codify-schemas';
+import { ApplyRequestData, PlanResponseData, ResourceConfig, StringIndexedObject } from '@codifycli/schemas';
 import { ParsedResourceSettings } from '../resource/parsed-resource-settings.js';
 import { ChangeSet } from './change-set.js';
 /**

package/dist/plan/plan.js

@@ -1,4 +1,4 @@
-import { ParameterOperation, ResourceOperation, } from 'codify-schemas';
+import { ParameterOperation, ResourceOperation, } from '@codifycli/schemas';
 import { v4 as uuidV4 } from 'uuid';
 import { ChangeSet } from './change-set.js';
 /**

package/dist/plugin/plugin.d.ts

@@ -1,4 +1,4 @@
-import { ApplyRequestData, GetResourceInfoRequestData, GetResourceInfoResponseData, ImportRequestData, ImportResponseData, InitializeRequestData, InitializeResponseData, MatchRequestData, MatchResponseData, PlanRequestData, PlanResponseData, ResourceConfig, ResourceJson, SetVerbosityRequestData, ValidateRequestData, ValidateResponseData } from 'codify-schemas';
+import { ApplyRequestData, GetResourceInfoRequestData, GetResourceInfoResponseData, ImportRequestData, ImportResponseData, InitializeRequestData, InitializeResponseData, MatchRequestData, MatchResponseData, PlanRequestData, PlanResponseData, ResourceConfig, ResourceJson, SetVerbosityRequestData, ValidateRequestData, ValidateResponseData } from '@codifycli/schemas';
 import { Plan } from '../plan/plan.js';
 import { BackgroundPty } from '../pty/background-pty.js';
 import { Resource } from '../resource/resource.js';

package/dist/pty/seqeuntial-pty.js

@@ -1,6 +1,6 @@
+import { CommandRequestResponseDataSchema, MessageCmd } from '@codifycli/schemas';
 import pty from '@homebridge/node-pty-prebuilt-multiarch';
 import { Ajv } from 'ajv';
-import { CommandRequestResponseDataSchema, MessageCmd } from 'codify-schemas';
 import { nanoid } from 'nanoid';
 import { EventEmitter } from 'node:events';
 import stripAnsi from 'strip-ansi';

package/dist/resource/config-parser.d.ts

@@ -1,4 +1,4 @@
-import { StringIndexedObject } from 'codify-schemas';
+import { StringIndexedObject } from '@codifycli/schemas';
 import { StatefulParameterController } from '../stateful-parameter/stateful-parameter-controller.js';
 export declare class ConfigParser<T extends StringIndexedObject> {
     private readonly desiredConfig;

package/dist/resource/parsed-resource-settings.d.ts

@@ -1,5 +1,5 @@
+import { LinuxDistro, OS, StringIndexedObject } from '@codifycli/schemas';
 import { JSONSchemaType } from 'ajv';
-import { LinuxDistro, OS, StringIndexedObject } from 'codify-schemas';
 import { StatefulParameterController } from '../stateful-parameter/stateful-parameter-controller.js';
 import { ArrayParameterSetting, DefaultParameterSetting, InputTransformation, ResourceSettings } from './resource-settings.js';
 export interface ParsedStatefulParameterSetting extends DefaultParameterSetting {

package/dist/resource/resource-controller.d.ts

@@ -1,5 +1,5 @@
+import { ResourceConfig, ResourceJson, StringIndexedObject, ValidateResponseData } from '@codifycli/schemas';
 import { Ajv, ValidateFunction } from 'ajv';
-import { ResourceConfig, ResourceJson, StringIndexedObject, ValidateResponseData } from 'codify-schemas';
 import { Plan } from '../plan/plan.js';
 import { ParsedResourceSettings } from './parsed-resource-settings.js';
 import { Resource } from './resource.js';

package/dist/resource/resource-controller.js

@@ -1,6 +1,6 @@
+import { ParameterOperation, ResourceOperation } from '@codifycli/schemas';
 import { Ajv } from 'ajv';
 import cleanDeep from 'clean-deep';
-import { ParameterOperation, ResourceOperation } from 'codify-schemas';
 import { Plan } from '../plan/plan.js';
 import { ConfigParser } from './config-parser.js';
 import { ParsedResourceSettings } from './parsed-resource-settings.js';

package/dist/resource/resource-settings.d.ts

@@ -1,5 +1,5 @@
+import { LinuxDistro, OS, StringIndexedObject } from '@codifycli/schemas';
 import { JSONSchemaType } from 'ajv';
-import { LinuxDistro, OS, StringIndexedObject } from 'codify-schemas';
 import { ZodObject } from 'zod';
 import { ArrayStatefulParameter, StatefulParameter } from '../stateful-parameter/stateful-parameter.js';
 import { ParsedResourceSettings } from './parsed-resource-settings.js';

package/dist/resource/resource.d.ts

@@ -1,4 +1,4 @@
-import { StringIndexedObject } from 'codify-schemas';
+import { StringIndexedObject } from '@codifycli/schemas';
 import { ParameterChange } from '../plan/change-set.js';
 import { CreatePlan, DestroyPlan, ModifyPlan } from '../plan/plan-types.js';
 import { ResourceSettings } from './resource-settings.js';

package/dist/stateful-parameter/stateful-parameter-controller.d.ts

@@ -1,4 +1,4 @@
-import { StringIndexedObject } from 'codify-schemas';
+import { StringIndexedObject } from '@codifycli/schemas';
 import { Plan } from '../plan/plan.js';
 import { ParsedParameterSetting } from '../resource/parsed-resource-settings.js';
 import { ParameterSetting } from '../resource/resource-settings.js';

package/dist/stateful-parameter/stateful-parameter.d.ts

@@ -1,4 +1,4 @@
-import { StringIndexedObject } from 'codify-schemas';
+import { StringIndexedObject } from '@codifycli/schemas';
 import { Plan } from '../plan/plan.js';
 import { ArrayParameterSetting, ParameterSetting } from '../resource/resource-settings.js';
 /**

package/dist/utils/functions.d.ts

@@ -1,4 +1,4 @@
-import { ResourceConfig, StringIndexedObject } from 'codify-schemas';
+import { ResourceConfig, StringIndexedObject } from '@codifycli/schemas';
 export declare function splitUserConfig<T extends StringIndexedObject>(config: ResourceConfig & T): {
     parameters: T;
     coreParameters: ResourceConfig;

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-import { LinuxDistro, OS } from 'codify-schemas';
+import { LinuxDistro, OS } from '@codifycli/schemas';
 export declare function isDebug(): boolean;
 export declare enum Shell {
     ZSH = "zsh",

package/dist/utils/index.js

@@ -1,4 +1,4 @@
-import { LinuxDistro } from 'codify-schemas';
+import { LinuxDistro } from '@codifycli/schemas';
 import * as fsSync from 'node:fs';
 import * as fs from 'node:fs/promises';
 import os from 'node:os';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codifycli/plugin-core",
-  "version": "1.0.0-beta1",
-  "description": "Core library for implementing a plugin for Codify",
+  "version": "1.0.0-beta3",
+  "description": "TypeScript library for building Codify plugins to manage system resources (applications, CLI tools, settings) through infrastructure-as-code",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
   "type": "module",
@@ -13,16 +13,33 @@
   "bin": {
     "codify-build": "./bin/build.js"
   },
-  "keywords": [],
-  "author": "",
+  "keywords": [
+    "codify",
+    "plugin",
+    "infrastructure-as-code",
+    "iac",
+    "system-management",
+    "resource-management",
+    "configuration-management",
+    "typescript",
+    "cli-tools",
+    "applications",
+    "system-resources",
+    "declarative",
+    "automation"
+  ],
+  "author": "Kevin Wang <team@codifycli.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codifycli/codify-plugin-core.git"
+  },
   "license": "ISC",
   "dependencies": {
+    "@codifycli/schemas": "1.0.0",
     "@homebridge/node-pty-prebuilt-multiarch": "^0.13.1",
-    "@npmcli/promise-spawn": "^7.0.1",
-    "ajv": "^8.12.0",
+    "ajv": "^8.18.0",
     "ajv-formats": "^2.1.1",
     "clean-deep": "^3.4.0",
-    "codify-schemas": "1.0.86-beta11",
     "lodash.isequal": "^4.5.0",
     "nanoid": "^5.0.9",
     "strip-ansi": "^7.1.0",
@@ -54,6 +71,6 @@
     "vitest-mock-extended": "^1.3.1"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   }
 }

package/src/messages/handlers.test.ts

@@ -3,7 +3,7 @@ import { Plugin } from '../plugin/plugin.js';
 import { describe, expect, it } from 'vitest';
 import { mock } from 'vitest-mock-extended'
 import { Resource } from '../resource/resource.js';
-import { MessageStatus, ResourceOperation } from 'codify-schemas';
+import { MessageStatus, ResourceOperation } from '@codifycli/schemas';
 import { TestResource } from '../utils/test-utils.test.js';
 
 describe('Message handler tests', () => {

package/src/messages/handlers.ts

@@ -1,5 +1,3 @@
-import { Ajv, SchemaObject, ValidateFunction } from 'ajv';
-import addFormats from 'ajv-formats';
 import {
   ApplyRequestDataSchema,
   EmptyResponseDataSchema,
@@ -22,7 +20,9 @@ import {
   SetVerbosityRequestDataSchema,
   ValidateRequestDataSchema,
   ValidateResponseDataSchema
-} from 'codify-schemas';
+} from '@codifycli/schemas';
+import { Ajv, SchemaObject, ValidateFunction } from 'ajv';
+import addFormats from 'ajv-formats';
 
 import { SudoError } from '../errors.js';
 import { Plugin } from '../plugin/plugin.js';

package/src/messages/sender.ts

@@ -1,5 +1,5 @@
+import { IpcMessageV2, IpcMessageV2Schema, MessageCmd, PressKeyToContinueRequestData } from '@codifycli/schemas';
 import { Ajv } from 'ajv';
-import { IpcMessageV2, IpcMessageV2Schema, MessageCmd, PressKeyToContinueRequestData } from 'codify-schemas';
 import { nanoid } from 'nanoid';
 
 const ajv = new Ajv({

package/src/plan/change-set.test.ts

@@ -1,5 +1,5 @@
 import { ChangeSet } from './change-set.js';
-import { ParameterOperation, ResourceOperation } from 'codify-schemas';
+import { ParameterOperation, ResourceOperation } from '@codifycli/schemas';
 import { describe, expect, it } from 'vitest';
 import { ParsedResourceSettings } from '../resource/parsed-resource-settings.js';
 

package/src/plan/change-set.ts

@@ -1,4 +1,4 @@
-import { ParameterOperation, ResourceOperation, StringIndexedObject } from 'codify-schemas';
+import { ParameterOperation, ResourceOperation, StringIndexedObject } from '@codifycli/schemas';
 
 import { ParsedParameterSetting } from '../resource/parsed-resource-settings.js';
 import { ResourceSettings } from '../resource/resource-settings.js';

package/src/plan/plan-types.ts

@@ -1,4 +1,4 @@
-import { StringIndexedObject } from 'codify-schemas';
+import { StringIndexedObject } from '@codifycli/schemas';
 
 import { Plan } from './plan.js';
 

package/src/plan/plan.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
 import { Plan } from './plan.js';
-import { OS, ParameterOperation, ResourceOperation } from 'codify-schemas';
+import { OS, ParameterOperation, ResourceOperation } from '@codifycli/schemas';
 import { TestConfig, TestResource } from '../utils/test-utils.test.js';
 import { ResourceController } from '../resource/resource-controller.js';
 import { ParsedResourceSettings } from '../resource/parsed-resource-settings.js';

package/src/plan/plan.ts

@@ -5,7 +5,7 @@ import {
   ResourceConfig,
   ResourceOperation,
   StringIndexedObject,
-} from 'codify-schemas';
+} from '@codifycli/schemas';
 import { v4 as uuidV4 } from 'uuid';
 
 import {

package/src/plugin/plugin.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
 import { Plugin } from './plugin.js';
-import { ApplyRequestData, OS, ParameterOperation, ResourceOperation, StringIndexedObject } from 'codify-schemas';
+import { ApplyRequestData, OS, ParameterOperation, ResourceOperation, StringIndexedObject } from '@codifycli/schemas';
 import { Resource } from '../resource/resource.js';
 import { Plan } from '../plan/plan.js';
 import { spy } from 'sinon';

package/src/plugin/plugin.ts

@@ -1,4 +1,3 @@
-import { JSONSchemaType } from 'ajv';
 import {
   ApplyRequestData,
   GetResourceInfoRequestData,
@@ -15,7 +14,8 @@ import {
   ResourceJson, SetVerbosityRequestData,
   ValidateRequestData,
   ValidateResponseData
-} from 'codify-schemas';
+} from '@codifycli/schemas';
+import { JSONSchemaType } from 'ajv';
 
 import { ApplyValidationError } from '../common/errors.js';
 import { Plan } from '../plan/plan.js';

package/src/pty/background-pty.test.ts

@@ -48,7 +48,6 @@ describe('BackgroundPty tests', () => {
     expect(resultFailed).toMatchObject({
       status: 'error',
       exitCode: 1,
-      data: 'sjkdhsakjdhjkash not found' // This might change on different os or shells. Keep for now.
     })
 
     await pty.kill();

package/src/pty/index.test.ts

@@ -3,7 +3,7 @@ import { TestConfig, TestResource } from '../utils/test-utils.test.js';
 import { getPty, IPty } from './index.js';
 import { Plugin } from '../plugin/plugin.js'
 import { CreatePlan } from '../plan/plan-types.js';
-import { OS, ResourceOperation } from 'codify-schemas';
+import { OS, ResourceOperation } from '@codifycli/schemas';
 import { ResourceSettings } from '../resource/resource-settings.js';
 import { SequentialPty } from './seqeuntial-pty.js';
 

package/src/pty/seqeuntial-pty.ts

@@ -1,6 +1,11 @@
+import {
+  CommandRequestResponseData,
+  CommandRequestResponseDataSchema,
+  IpcMessageV2,
+  MessageCmd
+} from '@codifycli/schemas';
 import pty from '@homebridge/node-pty-prebuilt-multiarch';
 import { Ajv } from 'ajv';
-import { CommandRequestResponseData, CommandRequestResponseDataSchema, IpcMessageV2, MessageCmd } from 'codify-schemas';
 import { nanoid } from 'nanoid';
 import { EventEmitter } from 'node:events';
 import stripAnsi from 'strip-ansi';

package/src/pty/sequential-pty.test.ts

@@ -1,8 +1,8 @@
 import { describe, expect, it } from 'vitest';
 import { SequentialPty } from './seqeuntial-pty.js';
 import { VerbosityLevel } from '../utils/verbosity-level.js';
-import { MessageStatus, SpawnStatus } from 'codify-schemas/src/types/index.js';
-import { IpcMessageV2, MessageCmd } from 'codify-schemas';
+import { MessageStatus, SpawnStatus } from '@codifycli/schemas/src/types/index.js';
+import { IpcMessageV2, MessageCmd } from '@codifycli/schemas';
 
 describe('SequentialPty tests', () => {
   it('Can launch a simple command', async () => {
@@ -36,7 +36,6 @@ describe('SequentialPty tests', () => {
     expect(resultFailed).toMatchObject({
       status: 'error',
       exitCode: 1,
-      data: 'sjkdhsakjdhjkash not found' // This might change on different os or shells. Keep for now.
     })
   });
 

package/src/resource/config-parser.ts

@@ -1,4 +1,4 @@
-import { StringIndexedObject } from 'codify-schemas';
+import { StringIndexedObject } from '@codifycli/schemas';
 
 import { StatefulParameterController } from '../stateful-parameter/stateful-parameter-controller.js';
 

package/src/resource/parsed-resource-settings.test.ts

@@ -3,7 +3,7 @@ import { ResourceSettings } from './resource-settings.js';
 import { ParsedResourceSettings } from './parsed-resource-settings.js';
 import { TestConfig } from '../utils/test-utils.test.js';
 import { z } from 'zod';
-import { OS } from 'codify-schemas';
+import { OS } from '@codifycli/schemas';
 
 describe('Resource options parser tests', () => {
   it('Parses default values from options', () => {

package/src/resource/parsed-resource-settings.ts

@@ -1,5 +1,5 @@
+import { LinuxDistro, OS, StringIndexedObject } from '@codifycli/schemas';
 import { JSONSchemaType } from 'ajv';
-import { LinuxDistro, OS, StringIndexedObject } from 'codify-schemas';
 import { ZodObject, z } from 'zod';
 
 import { StatefulParameterController } from '../stateful-parameter/stateful-parameter-controller.js';

package/src/resource/resource-controller-stateful-mode.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { OS, ParameterOperation, ResourceOperation } from 'codify-schemas';
+import { OS, ParameterOperation, ResourceOperation } from '@codifycli/schemas';
 import { TestConfig, TestResource, TestStatefulParameter } from '../utils/test-utils.test.js';
 import { ResourceSettings } from './resource-settings.js';
 import { ResourceController } from './resource-controller.js';

package/src/resource/resource-controller.test.ts

@@ -1,5 +1,5 @@
 import { Resource } from './resource.js';
-import { OS, ResourceOperation } from 'codify-schemas';
+import { OS, ResourceOperation } from '@codifycli/schemas';
 import { spy } from 'sinon';
 import { describe, expect, it } from 'vitest'
 import { ArrayParameterSetting, ParameterSetting, ResourceSettings } from './resource-settings.js';

package/src/resource/resource-controller.ts

@@ -1,5 +1,3 @@
-import { Ajv, ValidateFunction } from 'ajv';
-import cleanDeep from 'clean-deep';
 import {
   ParameterOperation,
   ResourceConfig,
@@ -7,7 +5,9 @@ import {
   ResourceOperation,
   StringIndexedObject,
   ValidateResponseData
-} from 'codify-schemas';
+} from '@codifycli/schemas';
+import { Ajv, ValidateFunction } from 'ajv';
+import cleanDeep from 'clean-deep';
 
 import { ParameterChange } from '../plan/change-set.js';
 import { Plan } from '../plan/plan.js';

package/src/resource/resource-settings.test.ts

@@ -1,7 +1,7 @@
 import { describe, expect, it } from 'vitest';
 import { Plan } from '../plan/plan.js';
 import { spy } from 'sinon';
-import { OS, ParameterOperation, ResourceOperation } from 'codify-schemas';
+import { OS, ParameterOperation, ResourceOperation } from '@codifycli/schemas';
 import {
   TestArrayStatefulParameter,
   TestConfig,

package/src/resource/resource-settings.ts

@@ -1,5 +1,5 @@
+import { LinuxDistro, OS, StringIndexedObject } from '@codifycli/schemas';
 import { JSONSchemaType } from 'ajv';
-import { LinuxDistro, OS, StringIndexedObject } from 'codify-schemas';
 import isObjectsEqual from 'lodash.isequal'
 import path from 'node:path';
 import { ZodObject } from 'zod';

package/src/resource/resource.ts

@@ -1,4 +1,4 @@
-import { StringIndexedObject, } from 'codify-schemas';
+import { StringIndexedObject, } from '@codifycli/schemas';
 
 import { ParameterChange } from '../plan/change-set.js';
 import { CreatePlan, DestroyPlan, ModifyPlan } from '../plan/plan-types.js';

package/src/stateful-parameter/stateful-parameter-controller.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest';
 import { spy } from 'sinon';
-import { ParameterOperation, ResourceOperation } from 'codify-schemas';
+import { ParameterOperation, ResourceOperation } from '@codifycli/schemas';
 import {
   TestArrayStatefulParameter,
   TestConfig,

package/src/stateful-parameter/stateful-parameter-controller.ts

@@ -1,4 +1,4 @@
-import { StringIndexedObject } from 'codify-schemas';
+import { StringIndexedObject } from '@codifycli/schemas';
 
 import { Plan } from '../plan/plan.js';
 import { ParsedArrayParameterSetting, ParsedParameterSetting, } from '../resource/parsed-resource-settings.js';

package/src/stateful-parameter/stateful-parameter.ts

@@ -1,4 +1,4 @@
-import { StringIndexedObject } from 'codify-schemas';
+import { StringIndexedObject } from '@codifycli/schemas';
 
 import { Plan } from '../plan/plan.js';
 import { ArrayParameterSetting, ParameterSetting } from '../resource/resource-settings.js';

package/src/utils/functions.ts

@@ -1,4 +1,4 @@
-import { ResourceConfig, StringIndexedObject } from 'codify-schemas';
+import { ResourceConfig, StringIndexedObject } from '@codifycli/schemas';
 import os from 'node:os';
 import path from 'node:path';
 

package/src/utils/index.ts

@@ -1,4 +1,4 @@
-import { LinuxDistro, OS } from 'codify-schemas';
+import { LinuxDistro, OS } from '@codifycli/schemas';
 import * as fsSync from 'node:fs';
 import * as fs from 'node:fs/promises';
 import os from 'node:os';

package/src/utils/test-utils.test.ts

@@ -1,4 +1,4 @@
-import { OS, ResourceConfig, StringIndexedObject } from 'codify-schemas';
+import { OS, ResourceConfig, StringIndexedObject } from '@codifycli/schemas';
 import { ResourceSettings } from '../resource/resource-settings.js';
 import { Plan } from '../plan/plan.js';
 import { Resource } from '../resource/resource.js';

package/.github/workflows/release.yaml

@@ -1,19 +0,0 @@
-# This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
-# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs
-
-name: Release
-
-on: workflow_dispatch
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-          cache: 'npm'
-      - run: npm ci
-      - run: tsc
-      - run: npm publish