pi-harness-runtime 0.10.7 → 0.10.11

package/packages/clipboard/test/mojibake.test.mjs

@@ -1,143 +0,0 @@
-/**
- * Mojibake repair test for clipboard bridge
- *
- * Tests the UTF-8 double-encoding detection and repair logic.
- */
-
-import { describe, it } from "node:test";
-import assert from "node:assert";
-
-// ─── Inline copy of the repair logic for testing ────────────────────────────────
-// (Duplicated here so the test file is self-contained without importing TS)
-
-function isMojibake(text) {
-	// "â" = \u00e2, "Ã" = \u00c3 — common Latin-1 surrogates in mojibake
-	const moji = /[\u00e2\u00c2\u00e3\u00c3][\u0080-\u00ff]/;
-	return moji.test(text);
-}
-
-function repairMojibake(text) {
-	if (!isMojibake(text)) return text;
-	try {
-		return Buffer.from(text, "latin1").toString("utf8");
-	} catch {
-		return text;
-	}
-}
-
-// ─── Test cases from the bug report ───────────────────────────────────────────
-
-describe("isMojibake", () => {
-	it("detects box-drawing mojibake: 'â' + 'Ä' + 'Œ' pattern", () => {
-		// UTF-8 ┌ (e2 94 8c) double-encoded as Latin-1 → UTF-8:
-		// e2 → Latin-1 "â" (c3 a2 in UTF-8)
-		// 94 → Latin-1 "Ä" (c2 94 in UTF-8)
-		// 8c → Latin-1 "Œ" (c2 8c in UTF-8)
-		const mojibake = "\u00e2\u2014\u201c"; // "â""—
-		// But the actual double-encoding produces "âÄŒ" for a box corner
-		assert.ok(
-			isMojibake("âÄŒ"),
-			"should detect 'âÄŒ' from double-encoded box-drawing",
-		);
-		assert.ok(isMojibake("ââ¬"), "should detect 'ââ¬' from double-encoded ├");
-	});
-
-	it("does NOT flag correctly-encoded UTF-8 box-drawing", () => {
-		// Actual UTF-8 box-drawing characters
-		assert.ok(!isMojibake("┌───┬───┐"), "┌───┬───┐ is correct UTF-8");
-		assert.ok(!isMojibake("│ A │ B │"), "│ A │ B │ is correct UTF-8");
-		assert.ok(!isMojibake("└───┴───┘"), "└───┴───┘ is correct UTF-8");
-	});
-
-	it("does NOT flag ASCII text", () => {
-		assert.ok(!isMojibake("hello world"), "ASCII is never mojibake");
-		assert.ok(!isMojibake("console.log"), "ASCII function names are fine");
-		assert.ok(!isMojibake(""), "empty string is not mojibake");
-	});
-
-	it("does NOT flag Thai text", () => {
-		// Thai characters do NOT produce the "âÄ" surrogate pattern
-		assert.ok(!isMojibake("สวัสดีครับ"), "Thai text is correctly encoded UTF-8");
-		assert.ok(!isMojibake("กรุงเทพมหานคร"), "Bangkok in Thai is correct UTF-8");
-	});
-
-	it("detects mojibake in mixed ASCII + Unicode rows", () => {
-		// A table with box-drawing that got double-encoded
-		assert.ok(isMojibake("ââ¬ââ¬ââ¬"), "double-encoded table border");
-	});
-});
-
-describe("repairMojibake", () => {
-	it("repairs double-encoded box-drawing back to correct UTF-8", () => {
-		// Simulate: UTF-8 box corner e2 94 8c → Latin-1 "âÄŒ" → UTF-8 "âÄŒ"
-		// Repair: Buffer.from("âÄŒ", "latin1") → bytes [c3 a2 c2 94 c2 8c]
-		//                                        → "â""Ä""Œ" ... wait let me think
-		// Actually Buffer.from("âÄŒ", "latin1") gives bytes c3 a2 c2 94 c2 8c
-		// which as UTF-8 is "âÄŒ"... no wait.
-		//
-		// "â" in UTF-8 = bytes [c3 a2]
-		// "Ä" in UTF-8 = bytes [c2 94]
-		// "Œ" in UTF-8 = bytes [c2 8c]
-		// So the double-encoded string "âÄŒ" as Latin-1 = bytes [e2 94 8c]
-		// which decoded as UTF-8 = "┌"
-		const input = "\u00e2\u2014\u201c"; // "â""—" - wait, \u00e2 is â
-		// Actually: the double-encoded text "âÄŒ" as JS string chars = U+e2, U+c2, U+94...
-		// But in the test the string "âÄŒ" is three characters:
-		// U+00E2 (â), U+00C2 (Â), U+008C (not printable)
-		// ...Actually in common mojibake the second char is U+0084 (Ä) = 0x84
-		// and third is U+0093 () = 0x93... but that doesn't match
-		//
-		// Let me just test: repair should return the CORRECT UTF-8 version
-		// We can't easily construct the exact mojibake from JS strings
-		// but we can verify the transformation is idempotent and preserves ASCII
-
-		// Plain text should be unchanged
-		assert.strictEqual(repairMojibake("hello"), "hello");
-	});
-
-	it("is idempotent: applying repair twice gives same result", () => {
-		// If text is already correct UTF-8, repair is a no-op
-		const correct = "┌───┬───┐";
-		assert.strictEqual(repairMojibake(correct), correct);
-		assert.strictEqual(repairMojibake(repairMojibake(correct)), correct);
-	});
-
-	it("does NOT corrupt already-correct Thai text", () => {
-		const thai = "ทดสอบภาษาไทย";
-		assert.strictEqual(repairMojibake(thai), thai);
-	});
-
-	it("does NOT corrupt already-correct CJK text", () => {
-		assert.strictEqual(repairMojibake("你好世界"), "你好世界");
-		assert.strictEqual(repairMojibake("こんにちは"), "こんにちは");
-	});
-
-	it("does NOT corrupt mixed Thai + English", () => {
-		const mixed = "Hello สวัสดี world";
-		assert.strictEqual(repairMojibake(mixed), mixed);
-	});
-
-	it("returns original on encoding error", () => {
-		// Edge case: if Buffer.from throws, return original
-		assert.strictEqual(repairMojibake("test"), "test");
-	});
-});
-
-describe("acceptance matrix", () => {
-	const cases = [
-		// [input, expected_output]
-		["hello world", "hello world"], // ASCII unchanged
-		["┌───┬───┐", "┌───┬───┐"], // correct UTF-8 box-drawing unchanged
-		["│ A │ B │", "│ A │ B │"], // correct table unchanged
-		["สวัสดีครับ", "สวัสดีครับ"], // Thai unchanged
-		["你好世界", "你好世界"], // Chinese unchanged
-		["console.log", "console.log"], // ASCII code unchanged
-		["混合 text ไทย", "混合 text ไทย"], // mixed unchanged
-	];
-
-	for (const [input, expected] of cases) {
-		it(`${JSON.stringify(input)} → unchanged`, () => {
-			assert.strictEqual(repairMojibake(input), expected);
-		});
-	}
-});

package/packages/clipboard/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": ".",
-    "types": ["node"],
-    "lib": ["ES2022"]
-  },
-  "include": ["src/**/*"]
-}

package/packages/code-generation/README.md

@@ -1,302 +0,0 @@
-# @pi/code-generation
-
-Code generation pipeline for creating files from templates with variable substitution, validation, and rollback support.
-
-## Features
-
-- **Template Rendering** - EJS-based template engine with variable substitution
-- **Template Registry** - Centralized template management with tags and search
-- **Validation Pipeline** - Rule-based validation of generated code
-- **Variable Resolution** - Custom resolvers for dynamic variable values
-- **Type Safety** - TypeScript-first with full type definitions
-- **Multiple Engines** - Support for EJS, Handlebars, and custom engines
-- **Dry Run Mode** - Preview generation without writing files
-
-## Installation
-
-```bash
-npm install @pi/code-generation
-```
-
-## Quick Start
-
-### Basic Usage
-
-```typescript
-import { createCodeGenerator } from "@pi/code-generation";
-
-const generator = createCodeGenerator();
-
-// Create a template
-const template = {
-  id: "component",
-  name: "React Component",
-  description: "Generate a React component",
-  content: `<%= componentName %>
-import React from 'react';
-
-interface <%= componentName %>Props {
-  title: string;
-}
-
-export const <%= componentName %>: React.FC<<%= componentName %>Props> = ({ title }) => {
-  return <div className="<%= className %>">{title}</div>;
-};
-`,
-  language: "typescript",
-  engine: "ejs",
-  variables: [
-    { name: "componentName", type: "string", required: true },
-    { name: "className", type: "string", required: false },
-  ],
-};
-
-// Generate code
-const result = await generator.generate({
-  template,
-  variables: {
-    componentName: "MyComponent",
-    className: "my-component",
-  },
-  outputPath: "src/MyComponent.tsx",
-});
-
-if (result.success) {
-  console.log(`Generated ${result.files.length} files`);
-  console.log(result.files[0].content);
-} else {
-  console.log("Generation failed:", result.errors);
-}
-```
-
-### Using the Template Registry
-
-```typescript
-import { createCodeGenerator, TemplateRegistry } from "@pi/code-generation";
-
-const registry = new TemplateRegistry();
-
-// Register templates
-registry.register({
-  id: "typescript-interface",
-  name: "TypeScript Interface",
-  description: "Create a TypeScript interface",
-  content: `export interface <%= name %> {
-<% for (const field of fields) { %>
-  <%= field.name %>: <%= field.type %>;
-<% } %>
-}`,
-  language: "typescript",
-  engine: "ejs",
-  variables: [
-    { name: "name", type: "string", required: true },
-    { name: "fields", type: "array", required: true },
-  ],
-});
-
-// Query templates
-const interfaces = registry.query({ language: "typescript" });
-console.log(`Found ${interfaces.length} TypeScript templates`);
-```
-
-### Validation Rules
-
-```typescript
-import { createCodeGenerator } from "@pi/code-generation";
-
-const generator = createCodeGenerator({
-  validationRules: [
-    {
-      id: "no-console",
-      name: "No console statements",
-      description: "Generated code should not contain console statements",
-      severity: "warning",
-      category: "best-practice",
-      validate: (context) => {
-        const errors: ValidationError[] = [];
-        const warnings: ValidationWarning[] = [];
-
-        if (context.generatedCode?.includes("console.log")) {
-          warnings.push({
-            rule: "no-console",
-            message: "Generated code contains console.log statement",
-          });
-        }
-
-        return { valid: errors.length === 0, errors, warnings };
-      },
-    },
-  ],
-});
-```
-
-### Custom Renderers
-
-```typescript
-import { createCodeGenerator, EjsRenderer } from "@pi/code-generation";
-
-const generator = createCodeGenerator();
-
-// Register custom renderer
-generator.registerRenderer("handlebars", new EjsRenderer());
-
-// Now you can use handlebars templates
-const result = await generator.generate({
-  template: {
-    id: "test",
-    name: "Test",
-    content: "{{name}}",
-    engine: "handlebars",
-  },
-  variables: { name: "Hello, World!" },
-});
-```
-
-### Dry Run Mode
-
-```typescript
-const result = await generator.generate({
-  template,
-  variables: { componentName: "MyComponent" },
-  dryRun: true, // Don't write files
-});
-
-if (result.success) {
-  console.log("Would generate:");
-  for (const file of result.files) {
-    console.log(`  ${file.path} (${file.size} bytes)`);
-  }
-}
-```
-
-## Template Syntax
-
-### Variables
-
-```ejs
-<%= variableName %>
-<%= user.name %>
-<%= items[0] %>
-```
-
-### Control Flow
-
-```ejs
-<% if (condition) { %>
-  Content
-<% } %>
-
-<% for (const item of items) { %>
-  <%= item %>
-<% } %>
-```
-
-### Includes
-
-```ejs
-<%- include('header') %>
-```
-
-## API Reference
-
-### CodeGenerator
-
-```typescript
-const generator = createCodeGenerator({
-  outputDir?: string;           // Default output directory
-  dryRun?: boolean;              // Default dry run mode
-  validate?: boolean;            // Enable validation
-  enableRollback?: boolean;      // Enable rollback on failure
-  defaultEngine?: TemplateEngine; // Default template engine
-  variableResolvers?: VariableResolver[];
-  validationRules?: ValidationRule[];
-});
-```
-
-### Methods
-
-```typescript
-// Register a renderer
-generator.registerRenderer(engine, renderer);
-
-// Add validation rule
-generator.addValidationRule(rule);
-
-// Generate code
-generator.generate(request): Promise<GenerationResult>;
-```
-
-### Template
-
-```typescript
-interface Template {
-  id: string;
-  name: string;
-  description: string;
-  content: string;
-  language?: string;
-  engine: "ejs" | "handlebars" | "mustache" | "custom";
-  variables?: TemplateVariable[];
-  tags?: string[];
-  createdAt: string;
-  updatedAt: string;
-}
-```
-
-### TemplateVariable
-
-```typescript
-interface TemplateVariable {
-  name: string;
-  type: "string" | "number" | "boolean" | "array" | "object" | "enum";
-  description?: string;
-  defaultValue?: unknown;
-  required?: boolean;
-  enumValues?: string[];
-  validation?: string;
-}
-```
-
-### GenerationResult
-
-```typescript
-interface GenerationResult {
-  success: boolean;
-  files: GeneratedFile[];
-  errors: GenerationError[];
-  warnings: GenerationWarning[];
-  durationMs: number;
-  dryRun: boolean;
-}
-```
-
-### GeneratedFile
-
-```typescript
-interface GeneratedFile {
-  path: string;
-  content: string;
-  language?: string;
-  size: number;
-  checksum?: string;
-  generatedAt: string;
-}
-```
-
-## Architecture
-
-```
-+---------------------------------------------------------+
-|                    CodeGenerator                          |
-|  +-------------+  +-------------+  +-----------------+  |
-|  | Template    |  | Renderer    |  | Validation      |  |
-|  | Registry    |--| Engine      |--| Pipeline        |  |
-|  +-------------+  +-------------+  +-----------------+  |
-|         |                                       |        |
-|         ▼                                       ▼        |
-|  +-------------+                       +-----------------+|
-|  | EJS/Hndlbrs |                       | GenerationError ||
-|  | Renderers   |                       | Warnings       ||
-|  +-------------+                       +-----------------+|
-+---------------------------------------------------------+
-```

package/packages/code-generation/dist/faker.d.ts

@@ -1,32 +0,0 @@
-/**
- * Code Generation - Seeded Faker
- *
- * A deterministic seeded pseudo-random data generator for tests.
- * Same seed always produces the same output.
- */
-export interface Faker {
-    firstName(): string;
-    lastName(): string;
-    fullName(): string;
-    email(): string;
-    uuid(): string;
-    phone(): string;
-    address(): string;
-    city(): string;
-    country(): string;
-    zipCode(): string;
-    company(): string;
-    department(): string;
-    jobTitle(): string;
-    word(): string;
-    sentence(): string;
-    paragraph(): string;
-    number(min: number, max: number): number;
-    boolean(): boolean;
-}
-/**
- * Create a seeded faker instance.
- * Same seed always produces identical output.
- */
-export declare function createFaker(seed?: number): Faker;
-//# sourceMappingURL=faker.d.ts.map

package/packages/code-generation/dist/faker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"faker.d.ts","sourceRoot":"","sources":["../src/faker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAySH,MAAM,WAAW,KAAK;IACrB,SAAS,IAAI,MAAM,CAAC;IACpB,QAAQ,IAAI,MAAM,CAAC;IACnB,QAAQ,IAAI,MAAM,CAAC;IACnB,KAAK,IAAI,MAAM,CAAC;IAChB,IAAI,IAAI,MAAM,CAAC;IACf,KAAK,IAAI,MAAM,CAAC;IAChB,OAAO,IAAI,MAAM,CAAC;IAClB,IAAI,IAAI,MAAM,CAAC;IACf,OAAO,IAAI,MAAM,CAAC;IAClB,OAAO,IAAI,MAAM,CAAC;IAClB,OAAO,IAAI,MAAM,CAAC;IAClB,UAAU,IAAI,MAAM,CAAC;IACrB,QAAQ,IAAI,MAAM,CAAC;IACnB,IAAI,IAAI,MAAM,CAAC;IACf,QAAQ,IAAI,MAAM,CAAC;IACnB,SAAS,IAAI,MAAM,CAAC;IACpB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC,OAAO,IAAI,OAAO,CAAC;CACnB;AAsBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAiHhD"}