pi-harness-runtime 0.9.19 → 0.9.21

package/packages/intent-analyzer/dist/src/analyzer.js

@@ -0,0 +1,239 @@
+/**
+ * Intent Analyzer — Analyzer
+ *
+ * Keyword-based intent detection.
+ */
+const INTENT_RULES = [
+    {
+        kind: "bug_fix",
+        keywords: [
+            "fix",
+            "bug",
+            "error",
+            "crash",
+            "fail",
+            "broken",
+            "issue",
+            "defect",
+            "patch",
+            "hotfix",
+        ],
+        weight: 2,
+        confidence: "high",
+    },
+    {
+        kind: "feature",
+        keywords: ["add", "implement", "new", "create", "build", "introduce"],
+        weight: 2,
+        confidence: "high",
+    },
+    {
+        kind: "refactor",
+        keywords: [
+            "refactor",
+            "rename",
+            "move",
+            "extract",
+            "restructure",
+            "cleanup",
+            "simplify",
+            "rewrite",
+        ],
+        weight: 2,
+        confidence: "high",
+    },
+    {
+        kind: "code_review",
+        keywords: [
+            "review",
+            "check code",
+            "audit",
+            "critique",
+            "evaluate",
+            "assess",
+        ],
+        weight: 2,
+        confidence: "high",
+    },
+    {
+        kind: "deployment",
+        keywords: [
+            "deploy",
+            "release",
+            "publish",
+            "ship",
+            "launch",
+            "rollout",
+            "promote",
+        ],
+        weight: 2,
+        confidence: "high",
+    },
+    {
+        kind: "testing",
+        keywords: [
+            "test",
+            "spec",
+            "coverage",
+            "unit test",
+            "integration test",
+            "e2e",
+            "specify",
+        ],
+        weight: 2,
+        confidence: "high",
+    },
+    {
+        kind: "documentation",
+        keywords: [
+            "doc",
+            "readme",
+            "comment",
+            "document",
+            "guide",
+            "changelog",
+            "spec",
+        ],
+        weight: 1,
+        confidence: "medium",
+    },
+    {
+        kind: "migration",
+        keywords: [
+            "migrate",
+            "convert",
+            "port",
+            "upgrade",
+            "move to",
+            "transition",
+        ],
+        weight: 2,
+        confidence: "high",
+    },
+    {
+        kind: "security",
+        keywords: [
+            "security",
+            "vulnerability",
+            "exploit",
+            "auth",
+            "permission",
+            "cve",
+            "secret",
+            "token",
+        ],
+        weight: 2,
+        confidence: "high",
+    },
+    {
+        kind: "performance",
+        keywords: [
+            "performance",
+            "speed",
+            "optimize",
+            "fast",
+            "slow",
+            "latency",
+            "benchmark",
+        ],
+        weight: 2,
+        confidence: "high",
+    },
+    {
+        kind: "architecture",
+        keywords: [
+            "architecture",
+            "design",
+            "structure",
+            "system design",
+            "pattern",
+            "abstraction",
+            "component",
+        ],
+        weight: 2,
+        confidence: "medium",
+    },
+    {
+        kind: "research",
+        keywords: [
+            "research",
+            "investigate",
+            "explore",
+            "analyze",
+            "study",
+            "understand",
+        ],
+        weight: 1,
+        confidence: "medium",
+    },
+    {
+        kind: "learning",
+        keywords: [
+            "learn",
+            "teach",
+            "explain",
+            "how does",
+            "understand",
+            "what is",
+        ],
+        weight: 1,
+        confidence: "low",
+    },
+];
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, " ")
+        .split(/\s+/)
+        .filter(Boolean);
+}
+export class IntentAnalyzer {
+    rules;
+    constructor(rules = INTENT_RULES) {
+        this.rules = rules;
+    }
+    analyze(text) {
+        const lower = text.toLowerCase();
+        const tokens = tokenize(text);
+        const matchedSignals = [];
+        let topKind = "general";
+        let topScore = 0;
+        let topConfidence = "low";
+        for (const rule of this.rules) {
+            let ruleScore = 0;
+            const matchedKeywords = [];
+            for (const keyword of rule.keywords) {
+                if (lower.includes(keyword)) {
+                    ruleScore += rule.weight;
+                    matchedKeywords.push(keyword);
+                }
+            }
+            if (ruleScore > topScore) {
+                topScore = ruleScore;
+                topKind = rule.kind;
+                topConfidence = rule.confidence;
+            }
+            for (const kw of matchedKeywords) {
+                matchedSignals.push({
+                    keyword: kw,
+                    weight: rule.weight,
+                    matched: true,
+                });
+            }
+        }
+        if (topScore === 0) {
+            topKind = "general";
+            topConfidence = "low";
+        }
+        return {
+            kind: topKind,
+            confidence: topConfidence,
+            signals: matchedSignals,
+            originalText: text,
+        };
+    }
+    analyzeBatch(texts) {
+        return texts.map((t) => this.analyze(t));
+    }
+}
+//# sourceMappingURL=analyzer.js.map

package/packages/intent-analyzer/dist/src/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","sourceRoot":"","sources":["../../src/analyzer.ts"],"names":[],"mappings":"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"}

package/packages/intent-analyzer/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+export { IntentAnalyzer } from "./analyzer.js";
+export type { Intent, IntentKind, IntentConfidence, IntentSignal, IntentRule, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/intent-analyzer/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EACX,MAAM,EACN,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,UAAU,GACV,MAAM,YAAY,CAAC"}

package/packages/intent-analyzer/dist/src/index.js

@@ -0,0 +1,2 @@
+export { IntentAnalyzer } from "./analyzer.js";
+//# sourceMappingURL=index.js.map

package/packages/intent-analyzer/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/packages/intent-analyzer/dist/src/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Intent Analyzer — Types
+ *
+ * Determines what the user is actually trying to accomplish.
+ */
+export type IntentKind = "bug_fix" | "feature" | "architecture" | "refactor" | "code_review" | "documentation" | "testing" | "deployment" | "research" | "learning" | "migration" | "security" | "performance" | "general";
+export type IntentConfidence = "high" | "medium" | "low";
+export interface IntentSignal {
+    keyword: string;
+    weight: number;
+    matched: boolean;
+}
+export interface Intent {
+    kind: IntentKind;
+    confidence: IntentConfidence;
+    signals: IntentSignal[];
+    originalText: string;
+    derivedTask?: string;
+}
+export interface IntentRule {
+    kind: IntentKind;
+    keywords: string[];
+    weight: number;
+    confidence: IntentConfidence;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/intent-analyzer/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GACnB,SAAS,GACT,SAAS,GACT,cAAc,GACd,UAAU,GACV,aAAa,GACb,eAAe,GACf,SAAS,GACT,YAAY,GACZ,UAAU,GACV,UAAU,GACV,WAAW,GACX,UAAU,GACV,aAAa,GACb,SAAS,CAAC;AAEb,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,gBAAgB,CAAC;CAC7B"}

package/packages/intent-analyzer/dist/src/types.js

@@ -0,0 +1,7 @@
+/**
+ * Intent Analyzer — Types
+ *
+ * Determines what the user is actually trying to accomplish.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/intent-analyzer/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/packages/intent-analyzer/dist/test/analyzer.test.js

@@ -0,0 +1,56 @@
+import { describe, it } from "node:test";
+import { IntentAnalyzer } from "../src/analyzer.js";
+import { equal } from "node:assert";
+describe("IntentAnalyzer", () => {
+    const analyzer = new IntentAnalyzer();
+    it("detects bug_fix from fix keyword", () => {
+        const result = analyzer.analyze("fix the login bug on line 42");
+        equal(result.kind, "bug_fix");
+    });
+    it("detects feature from add keyword", () => {
+        const result = analyzer.analyze("add dark mode support");
+        equal(result.kind, "feature");
+    });
+    it("detects refactor from refactor keyword", () => {
+        const result = analyzer.analyze("refactor the auth module");
+        equal(result.kind, "refactor");
+    });
+    it("detects testing from test keyword", () => {
+        const result = analyzer.analyze("write tests for the payment module");
+        equal(result.kind, "testing");
+    });
+    it("detects deployment from deploy keyword", () => {
+        const result = analyzer.analyze("deploy to production");
+        equal(result.kind, "deployment");
+    });
+    it("detects security from security keyword", () => {
+        const result = analyzer.analyze("fix the auth vulnerability");
+        equal(result.kind, "security");
+    });
+    it("detects performance from optimize keyword", () => {
+        const result = analyzer.analyze("optimize the database query");
+        equal(result.kind, "performance");
+    });
+    it("detects architecture from architecture keyword", () => {
+        const result = analyzer.analyze("review the architecture design");
+        equal(result.kind, "architecture");
+    });
+    it("detects migration from migrate keyword", () => {
+        const result = analyzer.analyze("migrate to TypeScript");
+        equal(result.kind, "migration");
+    });
+    it("falls back to general for unknown text", () => {
+        const result = analyzer.analyze("hello world");
+        equal(result.kind, "general");
+    });
+    it("returns matched signals", () => {
+        const result = analyzer.analyze("fix the authentication bug");
+        equal(result.signals.some(s => s.keyword === "fix"), true);
+    });
+    it("analyzeBatch returns multiple intents", () => {
+        const results = analyzer.analyzeBatch(["fix bug", "add feature"]);
+        equal(results.length, 2);
+        equal(results[0].kind, "bug_fix");
+        equal(results[1].kind, "feature");
+    });
+});

package/packages/intent-analyzer/dist/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Intent Analyzer — Types
+ *
+ * Determines what the user is actually trying to accomplish.
+ */
+export type IntentKind = "bug_fix" | "feature" | "architecture" | "refactor" | "code_review" | "documentation" | "testing" | "deployment" | "research" | "learning" | "migration" | "security" | "performance" | "general";
+export type IntentConfidence = "high" | "medium" | "low";
+export interface IntentSignal {
+    keyword: string;
+    weight: number;
+    matched: boolean;
+}
+export interface Intent {
+    kind: IntentKind;
+    confidence: IntentConfidence;
+    signals: IntentSignal[];
+    originalText: string;
+    derivedTask?: string;
+}
+export interface IntentRule {
+    kind: IntentKind;
+    keywords: string[];
+    weight: number;
+    confidence: IntentConfidence;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/intent-analyzer/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GACnB,SAAS,GACT,SAAS,GACT,cAAc,GACd,UAAU,GACV,aAAa,GACb,eAAe,GACf,SAAS,GACT,YAAY,GACZ,UAAU,GACV,UAAU,GACV,WAAW,GACX,UAAU,GACV,aAAa,GACb,SAAS,CAAC;AAEb,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,gBAAgB,CAAC;CAC7B"}

package/packages/intent-analyzer/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Intent Analyzer — Types
+ *
+ * Determines what the user is actually trying to accomplish.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/intent-analyzer/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/packages/intent-analyzer/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@pi/intent-analyzer",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "test": "node --test"
+  }
+}

package/packages/intent-analyzer/src/analyzer.ts

@@ -0,0 +1,259 @@
+/**
+ * Intent Analyzer — Analyzer
+ *
+ * Keyword-based intent detection.
+ */
+
+import type {
+	Intent,
+	IntentConfidence,
+	IntentKind,
+	IntentRule,
+	IntentSignal,
+} from "./types.js";
+
+const INTENT_RULES: IntentRule[] = [
+	{
+		kind: "bug_fix",
+		keywords: [
+			"fix",
+			"bug",
+			"error",
+			"crash",
+			"fail",
+			"broken",
+			"issue",
+			"defect",
+			"patch",
+			"hotfix",
+		],
+		weight: 2,
+		confidence: "high",
+	},
+	{
+		kind: "feature",
+		keywords: ["add", "implement", "new", "create", "build", "introduce"],
+		weight: 2,
+		confidence: "high",
+	},
+	{
+		kind: "refactor",
+		keywords: [
+			"refactor",
+			"rename",
+			"move",
+			"extract",
+			"restructure",
+			"cleanup",
+			"simplify",
+			"rewrite",
+		],
+		weight: 2,
+		confidence: "high",
+	},
+	{
+		kind: "code_review",
+		keywords: [
+			"review",
+			"check code",
+			"audit",
+			"critique",
+			"evaluate",
+			"assess",
+		],
+		weight: 2,
+		confidence: "high",
+	},
+	{
+		kind: "deployment",
+		keywords: [
+			"deploy",
+			"release",
+			"publish",
+			"ship",
+			"launch",
+			"rollout",
+			"promote",
+		],
+		weight: 2,
+		confidence: "high",
+	},
+	{
+		kind: "testing",
+		keywords: [
+			"test",
+			"spec",
+			"coverage",
+			"unit test",
+			"integration test",
+			"e2e",
+			"specify",
+		],
+		weight: 2,
+		confidence: "high",
+	},
+	{
+		kind: "documentation",
+		keywords: [
+			"doc",
+			"readme",
+			"comment",
+			"document",
+			"guide",
+			"changelog",
+			"spec",
+		],
+		weight: 1,
+		confidence: "medium",
+	},
+	{
+		kind: "migration",
+		keywords: [
+			"migrate",
+			"convert",
+			"port",
+			"upgrade",
+			"move to",
+			"transition",
+		],
+		weight: 2,
+		confidence: "high",
+	},
+	{
+		kind: "security",
+		keywords: [
+			"security",
+			"vulnerability",
+			"exploit",
+			"auth",
+			"permission",
+			"cve",
+			"secret",
+			"token",
+		],
+		weight: 2,
+		confidence: "high",
+	},
+	{
+		kind: "performance",
+		keywords: [
+			"performance",
+			"speed",
+			"optimize",
+			"fast",
+			"slow",
+			"latency",
+			"benchmark",
+		],
+		weight: 2,
+		confidence: "high",
+	},
+	{
+		kind: "architecture",
+		keywords: [
+			"architecture",
+			"design",
+			"structure",
+			"system design",
+			"pattern",
+			"abstraction",
+			"component",
+		],
+		weight: 2,
+		confidence: "medium",
+	},
+	{
+		kind: "research",
+		keywords: [
+			"research",
+			"investigate",
+			"explore",
+			"analyze",
+			"study",
+			"understand",
+		],
+		weight: 1,
+		confidence: "medium",
+	},
+	{
+		kind: "learning",
+		keywords: [
+			"learn",
+			"teach",
+			"explain",
+			"how does",
+			"understand",
+			"what is",
+		],
+		weight: 1,
+		confidence: "low",
+	},
+];
+
+function tokenize(text: string): string[] {
+	return text
+		.toLowerCase()
+		.replace(/[^a-z0-9\s]/g, " ")
+		.split(/\s+/)
+		.filter(Boolean);
+}
+
+export class IntentAnalyzer {
+	private rules: IntentRule[];
+
+	constructor(rules: IntentRule[] = INTENT_RULES) {
+		this.rules = rules;
+	}
+
+	analyze(text: string): Intent {
+		const lower = text.toLowerCase();
+		const tokens = tokenize(text);
+
+		const matchedSignals: IntentSignal[] = [];
+		let topKind: IntentKind = "general";
+		let topScore = 0;
+		let topConfidence: IntentConfidence = "low";
+
+		for (const rule of this.rules) {
+			let ruleScore = 0;
+			const matchedKeywords: string[] = [];
+
+			for (const keyword of rule.keywords) {
+				if (lower.includes(keyword)) {
+					ruleScore += rule.weight;
+					matchedKeywords.push(keyword);
+				}
+			}
+
+			if (ruleScore > topScore) {
+				topScore = ruleScore;
+				topKind = rule.kind;
+				topConfidence = rule.confidence;
+			}
+
+			for (const kw of matchedKeywords) {
+				matchedSignals.push({
+					keyword: kw,
+					weight: rule.weight,
+					matched: true,
+				});
+			}
+		}
+
+		if (topScore === 0) {
+			topKind = "general";
+			topConfidence = "low";
+		}
+
+		return {
+			kind: topKind,
+			confidence: topConfidence,
+			signals: matchedSignals,
+			originalText: text,
+		};
+	}
+
+	analyzeBatch(texts: string[]): Intent[] {
+		return texts.map((t) => this.analyze(t));
+	}
+}

package/packages/intent-analyzer/src/index.ts

@@ -0,0 +1,8 @@
+export { IntentAnalyzer } from "./analyzer.js";
+export type {
+	Intent,
+	IntentKind,
+	IntentConfidence,
+	IntentSignal,
+	IntentRule,
+} from "./types.js";