@hyperdrive.bot/gut 0.1.4 → 0.1.8

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

package/package.json

@@ -1,25 +1,26 @@
 {
   "name": "@hyperdrive.bot/gut",
-  "version": "0.1.4",
+  "version": "0.1.8",
   "description": "Git Unified Tooling - Enhanced git with workspace intelligence for entity-based organization",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "gut": "./bin/run"
+    "gut": "./bin/run.js"
   },
+  "type": "module",
   "files": [
     "/bin",
     "/dist",
     "/oclif.manifest.json"
   ],
   "scripts": {
-    "build": "shx rm -rf dist && tsc -b",
+    "build": "rm -rf dist && tsc -b",
     "dev": "node ./bin/dev",
-    "lint": "eslint . --ext .ts",
-    "postpack": "shx rm -f oclif.manifest.json",
-    "prepack": "npm run build && oclif manifest",
-    "test": "echo \"Error: no test specified\"",
-    "version": "oclif readme && git add README.md"
+    "lint": "eslint .",
+    "postpack": "rm -f oclif.manifest.json",
+    "prepack": "npm run build && npx oclif manifest || true",
+    "test": "npm run build",
+    "version": "npx oclif readme && git add README.md || true"
   },
   "keywords": [
     "git",
@@ -31,7 +32,7 @@
   "author": "DevSquad",
   "license": "MIT",
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=14.18.0"
   },
   "dependencies": {
     "@oclif/core": "^4.5.2",
@@ -51,7 +52,6 @@
     "eslint-config-oclif": "^6.0.101",
     "eslint-config-oclif-typescript": "^3.1.14",
     "oclif": "^4.22.16",
-    "shx": "^0.4.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.2"
   },

package/bin/run

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-
-const oclif = require('@oclif/core')
-
-oclif.run().then(require('@oclif/core/flush')).catch(require('@oclif/core/handle'))

package/dist/base-command.d.ts

@@ -1,21 +0,0 @@
-import { Command } from '@oclif/core';
-import { ConfigService } from './services/config.service';
-import { FocusService } from './services/focus.service';
-import { EntityService } from './services/entity.service';
-import { GitService } from './services/git.service';
-import { Entity } from './models/entity.model';
-export declare abstract class BaseCommand extends Command {
-    protected configService: ConfigService;
-    protected focusService: FocusService;
-    protected entityService: EntityService;
-    protected gitService: GitService;
-    init(): Promise<void>;
-    protected get requiresInit(): boolean;
-    protected withFocus<T>(callback: (entities: Entity[]) => Promise<T>): Promise<T>;
-    protected withSpinner<T>(text: string, callback: () => Promise<T>): Promise<T>;
-    protected printEntityList(entities: Entity[]): void;
-    protected getTypeEmoji(type: string): string;
-    protected getStatusIcon(hasChanges: boolean): string;
-    protected formatPath(path: string): string;
-}
-export default BaseCommand;

package/dist/base-command.js

@@ -1,110 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseCommand = void 0;
-const core_1 = require("@oclif/core");
-const config_service_1 = require("./services/config.service");
-const focus_service_1 = require("./services/focus.service");
-const entity_service_1 = require("./services/entity.service");
-const git_service_1 = require("./services/git.service");
-class BaseCommand extends core_1.Command {
-    configService;
-    focusService;
-    entityService;
-    gitService;
-    async init() {
-        await super.init();
-        // Initialize services
-        this.configService = new config_service_1.ConfigService();
-        this.entityService = new entity_service_1.EntityService(this.configService);
-        this.focusService = new focus_service_1.FocusService(this.configService);
-        this.gitService = new git_service_1.GitService();
-        // Check workspace initialization for commands that require it
-        if (this.requiresInit && !this.configService.isInitialized()) {
-            this.error('Workspace not initialized. Run "gut init" first.');
-        }
-    }
-    get requiresInit() {
-        // Override in commands that don't require initialization
-        return true;
-    }
-    async withFocus(callback) {
-        const entities = await this.focusService.getFocusedEntities();
-        if (entities.length === 0) {
-            this.error('No entities focused. Use "gut focus <entity>" first.');
-        }
-        return callback(entities);
-    }
-    async withSpinner(text, callback) {
-        // Note: oclif doesn't have built-in spinner, we'll use ora later
-        this.log(text);
-        try {
-            const result = await callback();
-            this.log('✓ Done');
-            return result;
-        }
-        catch (error) {
-            this.log('✗ Failed');
-            throw error;
-        }
-    }
-    printEntityList(entities) {
-        if (entities.length === 0) {
-            this.log('No entities configured');
-            return;
-        }
-        // Group by type
-        const byType = entities.reduce((acc, entity) => {
-            if (!acc[entity.type]) {
-                acc[entity.type] = [];
-            }
-            acc[entity.type].push(entity);
-            return acc;
-        }, {});
-        // Display grouped
-        for (const [type, typeEntities] of Object.entries(byType)) {
-            this.log(`\n${this.getTypeEmoji(type)} ${type.charAt(0).toUpperCase() + type.slice(1)} entities:`);
-            for (const entity of typeEntities) {
-                this.log(`  • ${entity.name} (${entity.path})`);
-                if (entity.description) {
-                    this.log(`    ${entity.description}`);
-                }
-            }
-        }
-    }
-    getTypeEmoji(type) {
-        switch (type) {
-            case 'client':
-                return '🏢';
-            case 'prospect':
-                return '🎯';
-            case 'company':
-                return '🏛️';
-            case 'initiative':
-                return '🚀';
-            case 'system':
-                return '⚙️';
-            case 'delivery':
-                return '📦';
-            case 'module':
-                return '📚';
-            case 'service':
-                return '🔧';
-            case 'tool':
-                return '🛠️';
-            default:
-                return '📁';
-        }
-    }
-    getStatusIcon(hasChanges) {
-        return hasChanges ? '●' : '✓';
-    }
-    formatPath(path) {
-        const workspaceRoot = this.configService.getWorkspaceRoot();
-        if (path.startsWith(workspaceRoot)) {
-            return path.substring(workspaceRoot.length + 1);
-        }
-        return path;
-    }
-}
-exports.BaseCommand = BaseCommand;
-exports.default = BaseCommand;

package/dist/commands/add.d.ts

@@ -1,13 +0,0 @@
-import { BaseCommand } from '../base-command';
-export default class Add extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        all: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        patch: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    };
-    static args: {
-        path: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    run(): Promise<void>;
-}

package/dist/commands/add.js

@@ -1,73 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const core_1 = require("@oclif/core");
-const base_command_1 = require("../base-command");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
-const ora_1 = tslib_1.__importDefault(require("ora"));
-class Add extends base_command_1.BaseCommand {
-    static description = 'Stage changes in focused entities';
-    static examples = [
-        '<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %> .',
-        '<%= config.bin %> <%= command.id %> src/',
-        '<%= config.bin %> <%= command.id %> --all',
-    ];
-    static flags = {
-        all: core_1.Flags.boolean({
-            char: 'A',
-            description: 'Stage all changes (equivalent to git add -A)',
-            default: false,
-        }),
-        patch: core_1.Flags.boolean({
-            char: 'p',
-            description: 'Interactive staging',
-            default: false,
-        }),
-    };
-    static args = {
-        path: core_1.Args.string({
-            description: 'Path(s) to stage',
-            required: false,
-            default: '.',
-        }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(Add);
-        const focusedEntities = await this.focusService.getFocusedEntities();
-        if (focusedEntities.length === 0) {
-            this.error('No entities are focused. Use "gut focus <entity>" first.');
-        }
-        this.log(chalk_1.default.bold('\n📝 Staging changes in focused entities\n'));
-        for (const entity of focusedEntities) {
-            const spinner = (0, ora_1.default)(`Staging in ${chalk_1.default.cyan(entity.name)}`).start();
-            try {
-                let files;
-                if (flags.all) {
-                    files = ['-A'];
-                }
-                else if (flags.patch) {
-                    files = ['-p', args.path];
-                }
-                else {
-                    files = [args.path];
-                }
-                await this.gitService.add(entity.path, files);
-                // Get status to check what was staged
-                const status = await this.gitService.getStatus(entity.path);
-                const staged = status.changes.length;
-                if (staged > 0) {
-                    spinner.succeed(chalk_1.default.green(`✓ ${entity.name}: ${staged} file(s) staged`));
-                }
-                else {
-                    spinner.info(chalk_1.default.yellow(`${entity.name}: No changes to stage`));
-                }
-            }
-            catch (error) {
-                spinner.fail(chalk_1.default.red(`✗ ${entity.name}: ${error.message}`));
-            }
-        }
-        this.log(chalk_1.default.dim('\nTip: Use "gut commit" to commit staged changes'));
-    }
-}
-exports.default = Add;

package/dist/commands/affected.d.ts

@@ -1,23 +0,0 @@
-import BaseCommand from '../base-command';
-export default class Affected extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        since: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
-        'include-tests': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        'include-docs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        verbose: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    };
-    static args: {
-        entity: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
-    };
-    run(): Promise<void>;
-    private getChangedFiles;
-    private analyzeAffected;
-    private checkDependencies;
-    private checkAPIChanges;
-    private checkConfigChanges;
-    private checkSchemaChanges;
-    private getEntityFiles;
-    private printAffected;
-}

package/dist/commands/affected.js

@@ -1,326 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const core_1 = require("@oclif/core");
-const base_command_1 = tslib_1.__importDefault(require("../base-command"));
-const fs = tslib_1.__importStar(require("fs"));
-const path = tslib_1.__importStar(require("path"));
-const child_process_1 = require("child_process");
-const chalk_1 = tslib_1.__importDefault(require("chalk"));
-const ora_1 = tslib_1.__importDefault(require("ora"));
-class Affected extends base_command_1.default {
-    static description = 'Detect entities potentially affected by changes in current focus';
-    static examples = [
-        '<%= config.bin %> <%= command.id %>',
-        '<%= config.bin %> <%= command.id %> my-app',
-        '<%= config.bin %> <%= command.id %> --since HEAD~5',
-        '<%= config.bin %> <%= command.id %> --include-tests',
-    ];
-    static flags = {
-        since: core_1.Flags.string({
-            char: 's',
-            description: 'Git reference to compare against',
-            default: 'HEAD~1',
-        }),
-        'include-tests': core_1.Flags.boolean({
-            description: 'Include test file changes in analysis',
-            default: false,
-        }),
-        'include-docs': core_1.Flags.boolean({
-            description: 'Include documentation changes in analysis',
-            default: false,
-        }),
-        verbose: core_1.Flags.boolean({
-            char: 'v',
-            description: 'Show detailed analysis',
-            default: false,
-        }),
-    };
-    static args = {
-        entity: core_1.Args.string({
-            name: 'entity',
-            required: false,
-            description: 'Entity to analyze (uses current focus if not provided)',
-        }),
-    };
-    async run() {
-        const { args, flags } = await this.parse(Affected);
-        const { since, 'include-tests': includeTests, 'include-docs': includeDocs, verbose } = flags;
-        const spinner = (0, ora_1.default)();
-        try {
-            let sourceEntities = [];
-            if (args.entity) {
-                const entity = await this.entityService.getEntity(args.entity);
-                if (!entity) {
-                    this.error(`Entity '${args.entity}' not found`);
-                }
-                sourceEntities = [entity];
-            }
-            else {
-                const focus = await this.focusService.getCurrentFocus();
-                if (!focus || !focus.entities || focus.entities.length === 0) {
-                    this.error('No entity specified and no current focus');
-                }
-                const entities = await Promise.all(focus.entities.map((e) => this.entityService.getEntity(e.name)));
-                sourceEntities = entities.filter(e => e !== null);
-            }
-            spinner.start('Analyzing changes and dependencies');
-            const changedFiles = await this.getChangedFiles(sourceEntities, since, includeTests, includeDocs);
-            if (changedFiles.length === 0) {
-                spinner.succeed('No changes detected');
-                this.log(chalk_1.default.yellow('No file changes found since ' + since));
-                return;
-            }
-            const allEntities = await this.entityService.listEntities();
-            const otherEntities = allEntities.filter(e => !sourceEntities.some(se => se.name === e.name));
-            const affected = await this.analyzeAffected(sourceEntities, otherEntities, changedFiles);
-            spinner.succeed(`Analysis complete: ${affected.length} entities potentially affected`);
-            if (affected.length === 0) {
-                this.log(chalk_1.default.green('No other entities appear to be affected by the changes'));
-                return;
-            }
-            this.printAffected(affected, changedFiles, verbose);
-        }
-        catch (error) {
-            spinner.fail();
-            this.error(error.message);
-        }
-    }
-    async getChangedFiles(entities, since, includeTests, includeDocs) {
-        const changedFiles = [];
-        for (const entity of entities) {
-            const entityPath = path.resolve(entity.path);
-            if (!fs.existsSync(path.join(entityPath, '.git'))) {
-                continue;
-            }
-            try {
-                const diff = (0, child_process_1.execSync)(`git diff ${since} --name-only`, {
-                    cwd: entityPath,
-                    encoding: 'utf-8',
-                    stdio: 'pipe',
-                }).toString();
-                const files = diff.split('\n')
-                    .filter(f => f.trim())
-                    .filter(f => {
-                    if (!includeTests && (f.includes('test') || f.includes('spec'))) {
-                        return false;
-                    }
-                    if (!includeDocs && (f.endsWith('.md') || f.includes('docs/'))) {
-                        return false;
-                    }
-                    return true;
-                })
-                    .map(f => path.join(entityPath, f));
-                changedFiles.push(...files);
-            }
-            catch (error) {
-                // Ignore git errors
-            }
-        }
-        return [...new Set(changedFiles)];
-    }
-    async analyzeAffected(sourceEntities, targetEntities, changedFiles) {
-        const affected = [];
-        for (const target of targetEntities) {
-            const reasons = [];
-            let confidence = 'low';
-            // Check direct dependencies
-            const depReason = await this.checkDependencies(sourceEntities, target);
-            if (depReason) {
-                reasons.push(depReason);
-                confidence = 'high';
-            }
-            // Check for API changes
-            const apiChanges = this.checkAPIChanges(changedFiles, target);
-            if (apiChanges) {
-                reasons.push(apiChanges);
-                if (confidence === 'low')
-                    confidence = 'medium';
-            }
-            // Check for shared configuration
-            const configChanges = this.checkConfigChanges(changedFiles, target);
-            if (configChanges) {
-                reasons.push(configChanges);
-                if (confidence === 'low')
-                    confidence = 'medium';
-            }
-            // Check for database/schema changes
-            const schemaChanges = this.checkSchemaChanges(changedFiles, target);
-            if (schemaChanges) {
-                reasons.push(schemaChanges);
-                confidence = 'high';
-            }
-            if (reasons.length > 0) {
-                affected.push({ entity: target, reason: reasons, confidence });
-            }
-        }
-        // Sort by confidence
-        affected.sort((a, b) => {
-            const confidenceOrder = { high: 3, medium: 2, low: 1 };
-            return confidenceOrder[b.confidence] - confidenceOrder[a.confidence];
-        });
-        return affected;
-    }
-    async checkDependencies(sources, target) {
-        const targetPkgPath = path.join(target.path, 'package.json');
-        if (!fs.existsSync(targetPkgPath)) {
-            return null;
-        }
-        try {
-            const targetPkg = JSON.parse(fs.readFileSync(targetPkgPath, 'utf-8'));
-            const dependencies = {
-                ...targetPkg.dependencies,
-                ...targetPkg.devDependencies,
-                ...targetPkg.peerDependencies,
-            };
-            for (const source of sources) {
-                const sourcePkgPath = path.join(source.path, 'package.json');
-                if (fs.existsSync(sourcePkgPath)) {
-                    const sourcePkg = JSON.parse(fs.readFileSync(sourcePkgPath, 'utf-8'));
-                    if (sourcePkg.name && dependencies[sourcePkg.name]) {
-                        return `Depends on ${sourcePkg.name}`;
-                    }
-                }
-            }
-        }
-        catch (error) {
-            // Ignore parsing errors
-        }
-        return null;
-    }
-    checkAPIChanges(changedFiles, target) {
-        const apiPatterns = [
-            /api\//i,
-            /routes\//i,
-            /controllers\//i,
-            /services\//i,
-            /endpoints\//i,
-            /graphql\//i,
-        ];
-        const apiFiles = changedFiles.filter(f => apiPatterns.some(pattern => pattern.test(f)));
-        if (apiFiles.length > 0) {
-            // Check if target might consume these APIs
-            const targetFiles = this.getEntityFiles(target.path);
-            const hasApiConsumption = targetFiles.some(f => f.includes('api') || f.includes('client') || f.includes('service'));
-            if (hasApiConsumption) {
-                return `API changes detected (${apiFiles.length} files)`;
-            }
-        }
-        return null;
-    }
-    checkConfigChanges(changedFiles, target) {
-        const configPatterns = [
-            /config\./i,
-            /\.env/,
-            /settings\./i,
-            /constants\./i,
-        ];
-        const configFiles = changedFiles.filter(f => configPatterns.some(pattern => pattern.test(path.basename(f))));
-        if (configFiles.length > 0) {
-            return `Configuration changes detected (${configFiles.length} files)`;
-        }
-        return null;
-    }
-    checkSchemaChanges(changedFiles, target) {
-        const schemaPatterns = [
-            /schema\./i,
-            /migration/i,
-            /\.sql$/,
-            /models?\//i,
-            /entities\//i,
-        ];
-        const schemaFiles = changedFiles.filter(f => schemaPatterns.some(pattern => pattern.test(f)));
-        if (schemaFiles.length > 0) {
-            // Check if target uses database
-            const targetFiles = this.getEntityFiles(target.path);
-            const hasDatabase = targetFiles.some(f => f.includes('model') || f.includes('entity') || f.includes('schema') || f.includes('database'));
-            if (hasDatabase) {
-                return `Database/Schema changes detected (${schemaFiles.length} files)`;
-            }
-        }
-        return null;
-    }
-    getEntityFiles(entityPath) {
-        const files = [];
-        if (!fs.existsSync(entityPath))
-            return files;
-        const walkDir = (dir) => {
-            try {
-                const entries = fs.readdirSync(dir, { withFileTypes: true });
-                for (const entry of entries) {
-                    if (entry.name === 'node_modules' || entry.name === '.git')
-                        continue;
-                    const fullPath = path.join(dir, entry.name);
-                    if (entry.isDirectory()) {
-                        walkDir(fullPath);
-                    }
-                    else {
-                        files.push(path.relative(entityPath, fullPath));
-                    }
-                }
-            }
-            catch (error) {
-                // Ignore permission errors
-            }
-        };
-        walkDir(entityPath);
-        return files;
-    }
-    printAffected(affected, changedFiles, verbose) {
-        this.log('');
-        this.log(chalk_1.default.bold(`Changed files: ${changedFiles.length}`));
-        if (verbose) {
-            this.log(chalk_1.default.dim('Changed:'));
-            changedFiles.slice(0, 5).forEach(f => {
-                this.log(chalk_1.default.dim(`  - ${path.basename(f)}`));
-            });
-            if (changedFiles.length > 5) {
-                this.log(chalk_1.default.dim(`  ... and ${changedFiles.length - 5} more`));
-            }
-        }
-        this.log('');
-        this.log(chalk_1.default.bold('Potentially affected entities:'));
-        this.log('');
-        const groupedByConfidence = {
-            high: affected.filter(a => a.confidence === 'high'),
-            medium: affected.filter(a => a.confidence === 'medium'),
-            low: affected.filter(a => a.confidence === 'low'),
-        };
-        if (groupedByConfidence.high.length > 0) {
-            this.log(chalk_1.default.red.bold('High confidence:'));
-            groupedByConfidence.high.forEach(a => {
-                this.log(`  ${chalk_1.default.red('●')} ${chalk_1.default.bold(a.entity.name)}`);
-                a.reason.forEach(r => {
-                    this.log(chalk_1.default.dim(`    - ${r}`));
-                });
-            });
-            this.log('');
-        }
-        if (groupedByConfidence.medium.length > 0) {
-            this.log(chalk_1.default.yellow.bold('Medium confidence:'));
-            groupedByConfidence.medium.forEach(a => {
-                this.log(`  ${chalk_1.default.yellow('●')} ${chalk_1.default.bold(a.entity.name)}`);
-                if (verbose) {
-                    a.reason.forEach(r => {
-                        this.log(chalk_1.default.dim(`    - ${r}`));
-                    });
-                }
-            });
-            this.log('');
-        }
-        if (groupedByConfidence.low.length > 0) {
-            this.log(chalk_1.default.dim('Low confidence:'));
-            groupedByConfidence.low.forEach(a => {
-                this.log(`  ${chalk_1.default.gray('●')} ${a.entity.name}`);
-                if (verbose) {
-                    a.reason.forEach(r => {
-                        this.log(chalk_1.default.dim(`    - ${r}`));
-                    });
-                }
-            });
-        }
-        this.log('');
-        this.log(chalk_1.default.dim('Tip: Use --verbose flag for detailed analysis'));
-    }
-}
-exports.default = Affected;

package/dist/commands/audit.d.ts

@@ -1,33 +0,0 @@
-import { BaseCommand } from '../base-command';
-export default class Audit extends BaseCommand {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        entity: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
-        security: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        compliance: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        access: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        changes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    };
-    run(): Promise<void>;
-    private performAudit;
-    private auditEntity;
-    private auditMetadata;
-    private auditGitRepository;
-    private auditFileStructure;
-    private performSecurityAudit;
-    private performComplianceAudit;
-    private performAccessAudit;
-    private displayAuditResults;
-    private displayEntityAudit;
-    private displayRecommendations;
-    private getAuditTypes;
-    private hasSpecificAuditType;
-    private calculateMetadataCompleteness;
-    private getRequiredMetadataFields;
-    private hasNestedField;
-    private getExpectedFiles;
-    private calculateStructureScore;
-    private getAllFiles;
-}