@git.zone/tstest 1.5.0 → 1.8.0

package/dist_ts_tapbundle_node/ts_tapbundle_node/classes.testfileprovider.js

@@ -0,0 +1,16 @@
+import * as plugins from './plugins.js';
+import * as paths from './paths.js';
+export const fileUrls = {
+    dockerAlpineImage: 'https://code.foss.global/testassets/docker/raw/branch/main/alpine.tar',
+};
+export class TestFileProvider {
+    async getDockerAlpineImageAsLocalTarball() {
+        const filePath = plugins.path.join(paths.testFilesDir, 'alpine.tar');
+        // fetch the docker alpine image
+        const response = await plugins.smartrequest.getBinary(fileUrls.dockerAlpineImage);
+        await plugins.smartfile.fs.ensureDir(paths.testFilesDir);
+        await plugins.smartfile.memory.toFs(response.body, filePath);
+        return filePath;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy50ZXN0ZmlsZXByb3ZpZGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHNfdGFwYnVuZGxlX25vZGUvY2xhc3Nlcy50ZXN0ZmlsZXByb3ZpZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sS0FBSyxLQUFLLE1BQU0sWUFBWSxDQUFDO0FBRXBDLE1BQU0sQ0FBQyxNQUFNLFFBQVEsR0FBRztJQUN0QixpQkFBaUIsRUFBRSx1RUFBdUU7Q0FDM0YsQ0FBQTtBQUVELE1BQU0sT0FBTyxnQkFBZ0I7SUFDcEIsS0FBSyxDQUFDLGtDQUFrQztRQUM3QyxNQUFNLFFBQVEsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsWUFBWSxFQUFFLFlBQVksQ0FBQyxDQUFBO1FBQ3BFLGdDQUFnQztRQUNoQyxNQUFNLFFBQVEsR0FBRyxNQUFNLE9BQU8sQ0FBQyxZQUFZLENBQUMsU0FBUyxDQUFDLFFBQVEsQ0FBQyxpQkFBaUIsQ0FBQyxDQUFDO1FBQ2xGLE1BQU0sT0FBTyxDQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUMsU0FBUyxDQUFDLEtBQUssQ0FBQyxZQUFZLENBQUMsQ0FBQztRQUN6RCxNQUFNLE9BQU8sQ0FBQyxTQUFTLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsSUFBSSxFQUFFLFFBQVEsQ0FBQyxDQUFDO1FBQzdELE9BQU8sUUFBUSxDQUFDO0lBQ2xCLENBQUM7Q0FDRiJ9

package/dist_ts_tapbundle_node/ts_tapbundle_node/index.d.ts

@@ -0,0 +1,2 @@
+export * from './classes.tapnodetools.js';
+export * from './classes.pathinject.js';

package/dist_ts_tapbundle_node/ts_tapbundle_node/index.js

@@ -0,0 +1,3 @@
+export * from './classes.tapnodetools.js';
+export * from './classes.pathinject.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c190YXBidW5kbGVfbm9kZS9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLDJCQUEyQixDQUFDO0FBQzFDLGNBQWMseUJBQXlCLENBQUMifQ==

package/dist_ts_tapbundle_node/ts_tapbundle_node/paths.d.ts

@@ -0,0 +1,2 @@
+export declare const cwd: string;
+export declare const testFilesDir: string;

package/dist_ts_tapbundle_node/ts_tapbundle_node/paths.js

@@ -0,0 +1,4 @@
+import * as plugins from './plugins.js';
+export const cwd = process.cwd();
+export const testFilesDir = plugins.path.join(cwd, './.nogit/testfiles/');
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGF0aHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c190YXBidW5kbGVfbm9kZS9wYXRocy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUV4QyxNQUFNLENBQUMsTUFBTSxHQUFHLEdBQUcsT0FBTyxDQUFDLEdBQUcsRUFBRSxDQUFDO0FBQ2pDLE1BQU0sQ0FBQyxNQUFNLFlBQVksR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUUscUJBQXFCLENBQUMsQ0FBQyJ9

package/dist_ts_tapbundle_node/ts_tapbundle_node/plugins.d.ts

@@ -0,0 +1,11 @@
+import * as crypto from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+export { crypto, fs, path, };
+import * as qenv from '@push.rocks/qenv';
+import * as smartcrypto from '@push.rocks/smartcrypto';
+import * as smartfile from '@push.rocks/smartfile';
+import * as smartpath from '@push.rocks/smartpath';
+import * as smartrequest from '@push.rocks/smartrequest';
+import * as smartshell from '@push.rocks/smartshell';
+export { qenv, smartcrypto, smartfile, smartpath, smartrequest, smartshell, };

package/dist_ts_tapbundle_node/ts_tapbundle_node/plugins.js

@@ -0,0 +1,14 @@
+// node native
+import * as crypto from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+export { crypto, fs, path, };
+// @push.rocks scope
+import * as qenv from '@push.rocks/qenv';
+import * as smartcrypto from '@push.rocks/smartcrypto';
+import * as smartfile from '@push.rocks/smartfile';
+import * as smartpath from '@push.rocks/smartpath';
+import * as smartrequest from '@push.rocks/smartrequest';
+import * as smartshell from '@push.rocks/smartshell';
+export { qenv, smartcrypto, smartfile, smartpath, smartrequest, smartshell, };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzX3RhcGJ1bmRsZV9ub2RlL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYztBQUNkLE9BQU8sS0FBSyxNQUFNLE1BQU0sUUFBUSxDQUFDO0FBQ2pDLE9BQU8sS0FBSyxFQUFFLE1BQU0sSUFBSSxDQUFDO0FBQ3pCLE9BQU8sS0FBSyxJQUFJLE1BQU0sTUFBTSxDQUFDO0FBRTdCLE9BQU8sRUFBRSxNQUFNLEVBQUMsRUFBRSxFQUFFLElBQUksR0FBRyxDQUFDO0FBRTVCLG9CQUFvQjtBQUNwQixPQUFPLEtBQUssSUFBSSxNQUFNLGtCQUFrQixDQUFDO0FBQ3pDLE9BQU8sS0FBSyxXQUFXLE1BQU0seUJBQXlCLENBQUM7QUFDdkQsT0FBTyxLQUFLLFNBQVMsTUFBTSx1QkFBdUIsQ0FBQztBQUNuRCxPQUFPLEtBQUssU0FBUyxNQUFNLHVCQUF1QixDQUFDO0FBQ25ELE9BQU8sS0FBSyxZQUFZLE1BQU0sMEJBQTBCLENBQUM7QUFDekQsT0FBTyxLQUFLLFVBQVUsTUFBTSx3QkFBd0IsQ0FBQztBQUVyRCxPQUFPLEVBQUUsSUFBSSxFQUFFLFdBQVcsRUFBRSxTQUFTLEVBQUUsU0FBUyxFQUFFLFlBQVksRUFBRSxVQUFVLEdBQUcsQ0FBQyJ9

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@git.zone/tstest",
-  "version": "1.5.0",
+  "version": "1.8.0",
   "private": false,
   "description": "a test utility to run tests that match test/**/*.ts",
-  "main": "dist_ts/index.js",
-  "typings": "dist_ts/index.d.ts",
+  "exports": {
+    ".": "./dist_ts/index.js",
+    "./tapbundle": "./dist_ts_tapbundle/index.js",
+    "./tapbundle_node": "./dist_ts_tapbundle_node/index.js"
+  },
   "type": "module",
   "author": "Lossless GmbH",
   "license": "MIT",
@@ -56,11 +59,11 @@
     "last 1 chrome versions"
   ],
   "scripts": {
-    "test": "pnpm run build && pnpm run test:tapbundle && pnpm run test:tstest",
-    "test:tapbundle": "tsx ./cli.child.ts test/tapbundle/**/*.ts",
-    "test:tapbundle:verbose": "tsx ./cli.child.ts test/tapbundle/**/*.ts --verbose",
-    "test:tstest": "tsx ./cli.child.ts test/tstest/**/*.ts",
-    "test:tstest:verbose": "tsx ./cli.child.ts test/tstest/**/*.ts --verbose",
+    "test": "pnpm run build && pnpm run test:tapbundle:verbose && pnpm run test:tstest:verbose",
+    "test:tapbundle": "tsx ./cli.child.ts \"test/tapbundle/**/*.ts\"",
+    "test:tapbundle:verbose": "tsx ./cli.child.ts \"test/tapbundle/**/*.ts\" --verbose",
+    "test:tstest": "tsx ./cli.child.ts \"test/tstest/**/*.ts\"",
+    "test:tstest:verbose": "tsx ./cli.child.ts \"test/tstest/**/*.ts\" --verbose",
     "build": "(tsbuild tsfolders)",
     "buildDocs": "tsdoc"
   }

package/readme.md

@@ -19,6 +19,14 @@
 - 📝 **Detailed Logging** - Optional file logging for debugging
 - ⚡ **Performance Metrics** - See which tests are slow
 - 🤖 **CI/CD Ready** - JSON output mode for automation
+- 🏷️ **Tag-based Filtering** - Run only tests with specific tags
+- 🎯 **Parallel Test Execution** - Run tests in parallel groups
+- 🔧 **Test Lifecycle Hooks** - beforeEach/afterEach support
+- 📸 **Snapshot Testing** - Compare test outputs with saved snapshots
+- ⏳ **Timeout Control** - Set custom timeouts for tests
+- 🔁 **Retry Logic** - Automatically retry failing tests
+- 🛠️ **Test Fixtures** - Create reusable test data
+- 📦 **Browser-Compatible** - Full browser support for tapbundle
 
 ## Installation
 
@@ -61,6 +69,7 @@ tstest "test/unit/*.ts"
 | `--no-color` | Disable colored output |
 | `--json` | Output results as JSON |
 | `--logfile` | Save detailed logs to `.nogit/testlogs/[testname].log` |
+| `--tags <tags>` | Run only tests with specific tags (comma-separated) |
 
 ### Example Outputs
 
@@ -147,6 +156,103 @@ tap.test('my awesome test', async () => {
 tap.start();
 ```
 
+#### Test Features
+
+**Tag-based Test Filtering**
+```typescript
+tap.tags('unit', 'api')
+  .test('should handle API requests', async () => {
+    // Test code
+  });
+
+// Run with: tstest test/ --tags unit,api
+```
+
+**Test Lifecycle Hooks**
+```typescript
+tap.describe('User API Tests', () => {
+  let testUser;
+  
+  tap.beforeEach(async () => {
+    testUser = await createTestUser();
+  });
+  
+  tap.afterEach(async () => {
+    await deleteTestUser(testUser.id);
+  });
+  
+  tap.test('should update user profile', async () => {
+    // Test code using testUser
+  });
+});
+```
+
+**Parallel Test Execution**
+```typescript
+// Files with matching parallel group names run concurrently
+// test.auth.para__1.ts
+tap.test('authentication test', async () => { /* ... */ });
+
+// test.user.para__1.ts  
+tap.test('user operations test', async () => { /* ... */ });
+```
+
+**Test Timeouts and Retries**
+```typescript
+tap.timeout(5000)
+  .retry(3)
+  .test('flaky network test', async (tools) => {
+    // This test has 5 seconds to complete and will retry up to 3 times
+  });
+```
+
+**Snapshot Testing**
+```typescript
+tap.test('should match snapshot', async (tools) => {
+  const result = await generateReport();
+  await tools.matchSnapshot(result);
+});
+```
+
+**Test Fixtures**
+```typescript
+// Define a reusable fixture
+tap.defineFixture('testUser', async () => ({
+  id: 1,
+  name: 'Test User',
+  email: 'test@example.com'
+}));
+
+tap.test('user test', async (tools) => {
+  const user = tools.fixture('testUser');
+  expect(user.name).toEqual('Test User');
+});
+```
+
+**Skipping and Todo Tests**
+```typescript
+tap.skip.test('work in progress', async () => {
+  // This test will be skipped
+});
+
+tap.todo('implement user deletion', async () => {
+  // This marks a test as todo
+});
+```
+
+**Browser Testing**
+```typescript
+// test.browser.ts
+import { tap, webhelpers } from '@push.rocks/tapbundle';
+
+tap.test('DOM manipulation', async () => {
+  const element = await webhelpers.fixture(webhelpers.html`
+    <div>Hello World</div>
+  `);
+  expect(element).toBeInstanceOf(HTMLElement);
+});
+```
+
 ## Advanced Features
 
 ### Glob Pattern Support
@@ -163,6 +269,8 @@ tstest "test/integration/*.test.ts"
 tstest "test/**/*.spec.ts" "test/**/*.test.ts"
 ```
 
+**Important**: Always quote glob patterns to prevent shell expansion. Without quotes, the shell will expand the pattern and only pass the first matching file to tstest.
+
 ### Automatic Logging
 
 Use `--logfile` to automatically save test output:
@@ -181,6 +289,26 @@ In verbose mode, see performance metrics:
    Slowest test: api integration test (486ms)
 ```
 
+### Parallel Test Groups
+
+Tests can be organized into parallel groups for concurrent execution:
+
+```
+━━━ Parallel Group: para__1 ━━━
+▶️  test/auth.para__1.ts
+▶️  test/user.para__1.ts
+   ... tests run concurrently ...
+──────────────────────────────────
+
+━━━ Parallel Group: para__2 ━━━
+▶️  test/db.para__2.ts
+▶️  test/api.para__2.ts
+   ... tests run concurrently ...
+──────────────────────────────────
+```
+
+Files with the same parallel group suffix (e.g., `para__1`) run simultaneously, while different groups run sequentially.
+
 ### CI/CD Integration
 
 For continuous integration, combine quiet and JSON modes:
@@ -192,6 +320,19 @@ tstest test/ --json > test-results.json
 tstest test/ --quiet
 ```
 
+## Changelog
+
+### Version 1.7.0
+- 🎉 Made `@push.rocks/tapbundle` fully browser-compatible
+- 📸 Added snapshot testing with base64-encoded communication protocol
+- 🏷️ Introduced tag-based test filtering
+- 🔧 Enhanced test lifecycle hooks (beforeEach/afterEach)
+- 🎯 Fixed parallel test execution and grouping
+- ⏳ Improved timeout and retry mechanisms
+- 🛠️ Added test fixtures for reusable test data
+- 📊 Enhanced TAP parser for better test reporting
+- 🐛 Fixed glob pattern handling in shell scripts
+
 ## Contribution
 
 We are always happy for code contributions. If you are not the code contributing type that is ok. Still, maintaining Open Source repositories takes considerable time and thought. If you like the quality of what we do and our modules are useful to you we would appreciate a little monthly contribution: You can [contribute one time](https://lossless.link/contribute-onetime) or [contribute monthly](https://lossless.link/contribute). :)

package/readme.plan.md

@@ -1,41 +1,264 @@
-# Plan for showing logs for failed tests
+# Improvement Plan for tstest and tapbundle
 
 !! FIRST: Reread /home/philkunz/.claude/CLAUDE.md to ensure following all guidelines !!
 
-## Goal
-When a test fails, we want to display all the console logs from that failed test in the terminal, even without the --verbose flag. This makes debugging failed tests much easier.
+## 1. Enhanced Communication Between tapbundle and tstest
 
-## Current Behavior
-- Default mode: Only shows test results, no console logs
-- Verbose mode: Shows all console logs from all tests
-- When a test fails: Only shows the error message
+### 1.1 Real-time Test Progress API
+- Create a bidirectional communication channel between tapbundle and tstest
+- Emit events for test lifecycle stages (start, progress, completion)
+- Allow tstest to subscribe to tapbundle events for better progress reporting
+- Implement a standardized message format for test metadata
 
-## Desired Behavior
-- Default mode: Shows test results, and IF a test fails, shows all console logs from that failed test
-- Verbose mode: Shows all console logs from all tests (unchanged)
-- When a test fails: Shows all console logs from that test plus the error
+### 1.2 Rich Error Reporting
+- Pass structured error objects from tapbundle to tstest
+- Include stack traces, code snippets, and contextual information
+- Support for error categorization (assertion failures, timeouts, uncaught exceptions)
+- Visual diff output for failed assertions
 
-## Implementation Plan
+## 2. Enhanced toolsArg Functionality
 
-### 1. Update TapParser
-- Store console logs for each test temporarily
-- When a test fails, mark that its logs should be shown
+### 2.1 Test Flow Control ✅
+```typescript
+tap.test('conditional test', async (toolsArg) => {
+  const result = await someOperation();
+  
+  // Skip the rest of the test
+  if (!result) {
+    return toolsArg.skip('Precondition not met');
+  }
+  
+  // Conditional skipping
+  await toolsArg.skipIf(condition, 'Reason for skipping');
+  
+  // Mark test as todo
+  await toolsArg.todo('Not implemented yet');
+});
+```
 
-### 2. Update TsTestLogger
-- Add a new method to handle failed test logs
-- Modify testConsoleOutput to buffer logs when not in verbose mode
-- When a test fails, flush the buffered logs for that test
+### 2.2 Test Metadata and Configuration ✅
+```typescript
+// Fluent syntax ✅
+tap.tags('slow', 'integration')
+  .priority('high')
+  .timeout(5000)
+  .retry(3)
+  .test('configurable test', async (toolsArg) => {
+    // Test implementation
+  });
+```
 
-### 3. Update test result handling
-- When a test fails, trigger display of all buffered logs for that test
-- Clear logs after each test completes successfully
+### 2.3 Test Data and Context Sharing ✅
+```typescript
+tap.test('data-driven test', async (toolsArg) => {
+  // Access shared context ✅
+  const sharedData = toolsArg.context.get('sharedData');
+  
+  // Set data for other tests ✅
+  toolsArg.context.set('resultData', computedValue);
+  
+  // Parameterized test data (not yet implemented)
+  const testData = toolsArg.data<TestInput>();
+  expect(processData(testData)).toEqual(expected);
+});
+```
 
-## Code Changes Needed
-1. Add log buffering to TapParser
-2. Update TsTestLogger to handle failed test logs
-3. Modify test result processing to show logs on failure
+## 3. Nested Tests and Test Suites
 
-## Files to Modify
-- `ts/tstest.classes.tap.parser.ts` - Add log buffering
-- `ts/tstest.logging.ts` - Add failed test log handling
-- `ts/tstest.classes.tap.testresult.ts` - May need to store logs
+### 3.1 Test Grouping with describe() ✅
+```typescript
+tap.describe('User Authentication', () => {
+  tap.beforeEach(async (toolsArg) => {
+    // Setup for each test in this suite
+    await toolsArg.context.set('db', await createTestDatabase());
+  });
+  
+  tap.afterEach(async (toolsArg) => {
+    // Cleanup after each test
+    await toolsArg.context.get('db').cleanup();
+  });
+  
+  tap.test('should login with valid credentials', async (toolsArg) => {
+    // Test implementation
+  });
+  
+  tap.describe('Password Reset', () => {
+    tap.test('should send reset email', async (toolsArg) => {
+      // Nested test
+    });
+  });
+});
+```
+
+### 3.2 Hierarchical Test Organization
+- Support for multiple levels of nesting
+- Inherited context and configuration from parent suites
+- Aggregated reporting for test suites
+- Suite-level lifecycle hooks
+
+## 4. Advanced Test Features
+
+### 4.1 Snapshot Testing
+```typescript
+tap.test('component render', async (toolsArg) => {
+  const output = renderComponent(props);
+  
+  // Compare with stored snapshot
+  await toolsArg.matchSnapshot(output, 'component-output');
+});
+```
+
+### 4.2 Performance Benchmarking
+```typescript
+tap.test('performance test', async (toolsArg) => {
+  const benchmark = toolsArg.benchmark();
+  
+  // Run operation
+  await expensiveOperation();
+  
+  // Assert performance constraints
+  benchmark.expect({
+    maxDuration: 1000,
+    maxMemory: '100MB'
+  });
+});
+```
+
+### 4.3 Test Fixtures and Factories ✅
+```typescript
+tap.test('with fixtures', async (toolsArg) => {
+  // Create test fixtures
+  const user = await toolsArg.fixture('user', { name: 'Test User' });
+  const post = await toolsArg.fixture('post', { author: user });
+  
+  // Use factory functions
+  const users = await toolsArg.factory('user').createMany(5);
+});
+```
+
+## 5. Test Execution Improvements
+
+### 5.1 Parallel Test Execution ✅
+- Run independent tests concurrently ✅
+- Configurable concurrency limits (via file naming convention)
+- Resource pooling for shared resources
+- Proper isolation between parallel tests ✅
+
+Implementation:
+- Tests with `para__<groupNumber>` in filename run in parallel
+- Different groups run sequentially
+- Tests without `para__` run serially
+
+### 5.2 Watch Mode
+- Automatically re-run tests on file changes
+- Intelligent test selection based on changed files
+- Fast feedback loop for development
+- Integration with IDE/editor plugins
+
+### 5.3 Advanced Test Filtering ✅ (partially)
+```typescript
+// Run tests by tags ✅
+tstest --tags "unit,fast"
+
+// Exclude tests by pattern (not yet implemented)
+tstest --exclude "**/slow/**"
+
+// Run only failed tests from last run (not yet implemented)
+tstest --failed
+
+// Run tests modified in git (not yet implemented)
+tstest --changed
+```
+
+## 6. Reporting and Analytics
+
+### 6.1 Custom Reporters
+- Plugin architecture for custom reporters
+- Built-in reporters: JSON, JUnit, HTML, Markdown
+- Real-time streaming reporters
+- Aggregated test metrics and trends
+
+### 6.2 Coverage Integration
+- Built-in code coverage collection
+- Coverage thresholds and enforcement
+- Coverage trending over time
+- Integration with CI/CD pipelines
+
+### 6.3 Test Analytics Dashboard
+- Web-based dashboard for test results
+- Historical test performance data
+- Flaky test detection
+- Test impact analysis
+
+## 7. Developer Experience
+
+### 7.1 Better Error Messages
+- Clear, actionable error messages
+- Suggestions for common issues
+- Links to documentation
+- Code examples in error output
+
+### 7.2 Interactive Mode (Needs Detailed Specification)
+- REPL for exploring test failures
+  - Need to define: How to enter interactive mode? When tests fail?
+  - What commands/features should be available in the REPL?
+- Debugging integration  
+  - Node.js inspector protocol integration?
+  - Breakpoint support?
+- Step-through test execution
+  - Pause between tests? 
+  - Step into/over/out functionality?
+- Interactive test data manipulation
+  - Modify test inputs on the fly?
+  - Inspect intermediate values?
+
+### 7.3 ~~VS Code Extension~~ (Scratched)
+- ~~Test explorer integration~~
+- ~~Inline test results~~
+- ~~CodeLens for running individual tests~~
+- ~~Debugging support~~
+
+## Implementation Phases
+
+### Phase 1: Core Enhancements (Priority: High) ✅
+1. Implement enhanced toolsArg methods (skip, skipIf, timeout, retry) ✅
+2. Add basic test grouping with describe() ✅
+3. Improve error reporting between tapbundle and tstest ✅
+
+### Phase 2: Advanced Features (Priority: Medium)
+1. Implement nested test suites ✅ (basic describe support)
+2. Add snapshot testing ✅
+3. Create test fixture system ✅
+4. Implement parallel test execution ✅
+
+### Phase 3: Developer Experience (Priority: Medium)
+1. Add watch mode
+2. Implement custom reporters
+3. ~~Create VS Code extension~~ (Scratched)
+4. Add interactive debugging (Needs detailed spec first)
+
+### Phase 4: Analytics and Performance (Priority: Low)
+1. Build test analytics dashboard
+2. Add performance benchmarking
+3. Implement coverage integration
+4. Create trend analysis tools
+
+## Technical Considerations
+
+### API Design Principles
+- Maintain backward compatibility
+- Progressive enhancement approach
+- Opt-in features to avoid breaking changes
+- Clear migration paths for new features
+
+### Performance Goals
+- Minimal overhead for test execution
+- Efficient parallel execution
+- Fast test discovery
+- Optimized browser test bundling
+
+### Integration Points
+- Clean interfaces between tstest and tapbundle
+- Extensible plugin architecture
+- Standard test result format
+- Compatible with existing CI/CD tools

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@git.zone/tstest',
-  version: '1.5.0',
+  version: '1.8.0',
   description: 'a test utility to run tests that match test/**/*.ts'
 }

package/ts/index.ts

@@ -12,6 +12,7 @@ export const runCli = async () => {
   const args = process.argv.slice(2);
   const logOptions: LogOptions = {};
   let testPath: string | null = null;
+  let tags: string[] = [];
   
   // Parse options
   for (let i = 0; i < args.length; i++) {
@@ -36,6 +37,11 @@ export const runCli = async () => {
       case '--logfile':
         logOptions.logFile = true; // Set this as a flag, not a value
         break;
+      case '--tags':
+        if (i + 1 < args.length) {
+          tags = args[++i].split(',');
+        }
+        break;
       default:
         if (!arg.startsWith('-')) {
           testPath = arg;
@@ -52,6 +58,7 @@ export const runCli = async () => {
     console.error('  --no-color      Disable colored output');
     console.error('  --json          Output results as JSON');
     console.error('  --logfile       Write logs to .nogit/testlogs/[testfile].log');
+    console.error('  --tags          Run only tests with specified tags (comma-separated)');
     process.exit(1);
   }
   
@@ -66,6 +73,6 @@ export const runCli = async () => {
     executionMode = TestExecutionMode.DIRECTORY;
   }
   
-  const tsTestInstance = new TsTest(process.cwd(), testPath, executionMode, logOptions);
+  const tsTestInstance = new TsTest(process.cwd(), testPath, executionMode, logOptions, tags);
   await tsTestInstance.run();
 };