@wanshi-kg/wanshi 0.1.0

package/dist/core/llm/prompts/PromptTemplateEngine.js.map

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

package/dist/core/llm/prompts/templates/partials/examples/EXAMPLE_STYLE_GUIDE.md

@@ -0,0 +1,84 @@
+# Example partial style guide (v5)
+
+Every file in `partials/examples/*.md` is training signal, not decoration. The
+model imitates whatever the gold examples do. These rules make the examples teach
+the behavior the merged graph needs.
+
+## Status of the existing files
+
+**Already close to v5 style — light touch only:** `article.md`, `transcript.md`,
+`code.md`, `notes.md`, `tabular.md`. These use lowercase reusable types and rich
+observations. The only fix they need: collapse the few two-synonym `relationType`
+arrays (e.g. `["contains", "uses"]`, `["used_to_create"]` is fine; `["develops",
+"announces"]` should split into the single most accurate predicate) and remove the
+one self-loop in `notes.md` (`Cursor-based Pagination → Cursor-based Pagination`).
+
+**Need a full rewrite (rebuilt in v5 form):** `financial.md` ✅ done, `medical.md`
+✅ done, `legal.md` ✅ done, `logs.md` ✅ done.
+
+**Dedicated examples (replaced the shared `generic.md` fallback):** `research.md`,
+`communication.md`, `documentation.md` ✅ done. Every `ContentClass` now routes to
+its own example file (`CLASS_TO_PARTIAL`); there is no generic catch-all — the
+KG-05 test in `vocabulary.test.ts` requires every example file to be reachable.
+
+## The seven rules
+
+1. **Reuse types.** Across an entire example file, the distinct `entityType` count
+   should be small. If every entity has a unique bespoke type, the example is
+   teaching sprawl. Lowercase `snake_case` only.
+
+2. **One canonical predicate per relation.** `relationType` is a one-element array.
+   Never stack near-synonyms (`["uses", "depends_on"]` → pick one). This is the
+   single biggest fix; the old examples taught the 500-relation-type explosion.
+
+3. **No type-pair predicates.** A relation label is a verb-like predicate
+   (`depends_on`, `targets`), never the two endpoint types restated
+   (`["SOURCE_IP", "REQUEST_METHOD"]` is not a relation — it's two node types).
+   This was the core defect in `logs.md`.
+
+4. **No self-loops.** `from` and `to` always differ.
+
+5. **Literals are observations, not entities.** Dollar amounts, timestamps, raw
+   counts, single values — fold them into an observation on a real entity. Don't
+   make `$5,000` or `2022-10-15 14:30:00` a node. (This guts most of the old
+   `financial.md` and de-hubs `logs.md`.)
+
+6. **Observations add information beyond the type.** `entityType: medication` +
+   observation `"a medication"` is circular. State dosage, route, indication,
+   measured value — something the type doesn't already say.
+
+7. **Consistent direction.** actor → object, specific → general, caller → callee.
+   Don't emit both `A → B` and `B → A` for one relationship.
+
+## Domain-specific notes for the three rewrites
+
+**medical.md** — real entities are patients, conditions, medications, procedures,
+providers. Suggested type set: `person, condition, medication, procedure, test,
+result, allergy, provider, metric`. Vitals and dosages are observations
+(`"BP 120/80 mmHg"` on the patient or the reading), not nodes. Predicates:
+`diagnosed_with`, `prescribed`, `underwent`, `has_result`, `allergic_to`,
+`treated_by`, `related_to`. Drop the `entityType: "Patient Name"` pattern — the
+type is `person`, the name is the patient's name.
+
+**legal.md** — types: `person, organization, document, court, statute, term, date,
+duration`. Predicates: `party_to`, `signed`, `governs`, `references`, `defines`,
+`filed_in`, `related_to`. Effective dates are observations on the document, not
+their own `date` nodes unless the date genuinely anchors multiple entities.
+
+**logs.md** — this one needs the most rethinking. A log line's real entities are
+the actors and resources: an IP, a user, a service, a process, a file, an error.
+The timestamp is an observation on the event, not a hub node every edge points at.
+Types: `ip_address, user, service, process, file, request, error, event`.
+Predicates: `requests`, `authenticates_as`, `accesses`, `triggers`, `targets`,
+`reports`, `related_to`. Each relation is one real interaction
+(`ip_address → request : requests`), never `["CLIENT_IP", "REQUEST_METHOD"]`.
+
+## Quick self-check before committing an example file
+
+- Distinct entityType count across the file: small? (If > ~10 for a short file,
+  you're sprawling.)
+- Every `relationType` array length 1?
+- Any predicate that is just two node types concatenated? (Must be zero.)
+- Any `from == to`? (Must be zero.)
+- Any standalone literal-value entity? (Must be zero.)
+- Does every observation say something the type doesn't?

package/dist/core/llm/prompts/templates/partials/examples/article.md

@@ -0,0 +1,187 @@
+### Example 1
+
+Input:
+
+## File Information
+
+Path: `articles/veritas-labs-edge-launch.md`
+
+## Content to Analyze
+
+```
+Veritas Labs Unveils EdgeMind 2.0, Targeting Industrial IoT Market
+
+San Francisco, CA — Veritas Labs today announced EdgeMind 2.0, an on-device inference
+platform designed for industrial sensor networks. The release marks the company's first
+major product push into the manufacturing sector after two years focused on consumer
+wearables.
+
+"EdgeMind 2.0 can run our largest vision model in under 12 ms on a $30 microcontroller,"
+said Dr. Priya Nair, Veritas Labs' Chief Technology Officer. "That changes the economics
+of predictive maintenance dramatically."
+
+The platform targets process manufacturers and heavy equipment operators who require
+real-time anomaly detection without continuous cloud connectivity. Early adopters include
+Helix Manufacturing, which piloted the system across its stamping lines in Detroit.
+
+Veritas Labs raised a $45M Series B in January 2024, led by Meridian Capital, which it
+says will fund a 60-person engineering expansion over the next 18 months.
+
+Competitors in the edge inference space include Arm's Ethos NPU ecosystem and Qualcomm's
+AI Hub, though Veritas claims superior latency on thermal and vibration sensor workloads.
+```
+
+Output:
+
+```json
+{
+  "entities": [
+    {
+      "name": "Veritas Labs",
+      "entityType": "organization",
+      "observations": [
+        "AI company pivoting from consumer wearables to industrial IoT",
+        "Raised $45M Series B in January 2024",
+        "Plans 60-person engineering expansion over 18 months"
+      ]
+    },
+    {
+      "name": "EdgeMind 2.0",
+      "entityType": "product",
+      "observations": [
+        "On-device inference platform for industrial sensor networks",
+        "Runs vision models in under 12 ms on a $30 microcontroller",
+        "Targets real-time anomaly detection without cloud connectivity"
+      ]
+    },
+    {
+      "name": "Dr. Priya Nair",
+      "entityType": "person",
+      "observations": ["Chief Technology Officer at Veritas Labs"]
+    },
+    {
+      "name": "Helix Manufacturing",
+      "entityType": "organization",
+      "observations": [
+        "Early adopter of EdgeMind 2.0",
+        "Piloted the system on stamping lines in Detroit"
+      ]
+    },
+    {
+      "name": "Meridian Capital",
+      "entityType": "organization",
+      "observations": ["Led Veritas Labs' $45M Series B round in January 2024"]
+    },
+    {
+      "name": "Industrial IoT",
+      "entityType": "market_segment",
+      "observations": [
+        "Target market for EdgeMind 2.0",
+        "Includes process manufacturers and heavy equipment operators"
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "Veritas Labs",    "to": "EdgeMind 2.0",       "relationType": ["develops"] },
+    { "from": "Dr. Priya Nair", "to": "Veritas Labs",        "relationType": ["works_at"] },
+    { "from": "EdgeMind 2.0",   "to": "Industrial IoT",      "relationType": ["targets"] },
+    { "from": "Helix Manufacturing", "to": "EdgeMind 2.0",   "relationType": ["pilots"] },
+    { "from": "Meridian Capital", "to": "Veritas Labs",       "relationType": ["invests_in"] }
+  ]
+}
+```
+
+---
+
+### Example 2
+
+Input:
+
+## File Information
+
+Path: `articles/crispr-drought-wheat.md`
+
+## Content to Analyze
+
+```
+Scientists Engineer Drought-Tolerant Wheat Using CRISPR
+
+Researchers at the Global Crop Institute have developed a wheat variety, designated GCI-W7,
+that maintains 85% of normal yield under severe drought conditions — roughly double the
+resilience of current commercial strains.
+
+The team, led by geneticist Dr. Amara Diallo, used CRISPR-Cas9 to silence the DREB2A
+transcription factor gene, triggering the plant's drought-stress response pathway earlier
+and more strongly than in wild-type wheat. The work, published in Nature Plants, builds on
+earlier research by Monsanto and CSIRO that identified DREB2A as a key regulator.
+
+"We're not adding foreign genes. We're editing an existing switch," said Dr. Diallo. The
+distinction matters for regulatory pathways in the EU, where gene editing without foreign
+DNA insertion faces a less restrictive approval process than traditional GMOs.
+
+Field trials are planned for 2025 in Kenya and Pakistan, in collaboration with the CGIAR
+network. If approved, GCI-W7 could reach farmers in drought-prone regions by 2028.
+```
+
+Output:
+
+```json
+{
+  "entities": [
+    {
+      "name": "GCI-W7",
+      "entityType": "research_subject",
+      "observations": [
+        "Drought-tolerant wheat variety developed by Global Crop Institute",
+        "Maintains 85% yield under severe drought — ~2× resilience of commercial strains",
+        "Targets farmers in drought-prone regions; projected availability 2028"
+      ]
+    },
+    {
+      "name": "Dr. Amara Diallo",
+      "entityType": "person",
+      "observations": [
+        "Lead geneticist at Global Crop Institute",
+        "Led the CRISPR-Cas9 editing work on GCI-W7"
+      ]
+    },
+    {
+      "name": "Global Crop Institute",
+      "entityType": "organization",
+      "observations": [
+        "Research institution that developed GCI-W7",
+        "Planning field trials in Kenya and Pakistan in 2025"
+      ]
+    },
+    {
+      "name": "CRISPR-Cas9",
+      "entityType": "methodology",
+      "observations": [
+        "Gene editing tool used to silence DREB2A transcription factor",
+        "No foreign DNA inserted — activates existing drought-stress pathway"
+      ]
+    },
+    {
+      "name": "DREB2A",
+      "entityType": "concept",
+      "observations": [
+        "Transcription factor gene silenced to enhance drought tolerance",
+        "Key regulator identified in prior research by Monsanto and CSIRO"
+      ]
+    },
+    {
+      "name": "CGIAR network",
+      "entityType": "organization",
+      "observations": ["Collaborating on 2025 field trials in Kenya and Pakistan"]
+    }
+  ],
+  "relations": [
+    { "from": "Dr. Amara Diallo",    "to": "Global Crop Institute", "relationType": ["works_at"] },
+    { "from": "Global Crop Institute","to": "GCI-W7",               "relationType": ["develops"] },
+    { "from": "CRISPR-Cas9",         "to": "GCI-W7",               "relationType": ["used_to_create"] },
+    { "from": "CRISPR-Cas9",         "to": "DREB2A",               "relationType": ["targets"] },
+    { "from": "GCI-W7",              "to": "DREB2A",               "relationType": ["silences"] },
+    { "from": "Global Crop Institute","to": "CGIAR network",        "relationType": ["collaborates_with"] }
+  ]
+}
+```

package/dist/core/llm/prompts/templates/partials/examples/code.md

@@ -0,0 +1,229 @@
+### Example 1
+
+Input:
+
+## File Information
+
+Path: `src/auth/AuthService.ts`
+
+## Content to Analyze
+
+```typescript
+import { Injectable } from '@di/decorators';
+import { IAuthService } from './IAuthService';
+import { UserRepository } from '../user/UserRepository';
+import { JwtTokenService } from '../token/JwtTokenService';
+import { HashService } from '../crypto/HashService';
+
+@Injectable()
+export class AuthService implements IAuthService {
+  constructor(
+    private readonly userRepo: UserRepository,
+    private readonly jwtService: JwtTokenService,
+    private readonly hashService: HashService,
+  ) {}
+
+  async login(email: string, password: string): Promise<string> {
+    const user = await this.userRepo.findByEmail(email);
+    if (!user) throw new Error('User not found');
+    const valid = await this.hashService.compare(password, user.passwordHash);
+    if (!valid) throw new Error('Invalid credentials');
+    return this.jwtService.sign({ sub: user.id, email: user.email });
+  }
+
+  async refresh(token: string): Promise<string> {
+    const payload = this.jwtService.verify(token);
+    return this.jwtService.sign({ sub: payload.sub, email: payload.email });
+  }
+
+  async logout(userId: string): Promise<void> {
+    await this.jwtService.revoke(userId);
+  }
+}
+```
+
+Output:
+
+```json
+{
+  "entities": [
+    {
+      "name": "AuthService",
+      "entityType": "class",
+      "observations": [
+        "Implements IAuthService interface",
+        "Decorated with @Injectable for dependency injection",
+        "Handles login, token refresh, and logout operations"
+      ]
+    },
+    {
+      "name": "IAuthService",
+      "entityType": "interface",
+      "observations": [
+        "Contract implemented by AuthService",
+        "Defines authentication operations"
+      ]
+    },
+    {
+      "name": "UserRepository",
+      "entityType": "dependency",
+      "observations": [
+        "Injected via constructor",
+        "Used to look up users by email"
+      ]
+    },
+    {
+      "name": "JwtTokenService",
+      "entityType": "dependency",
+      "observations": [
+        "Injected via constructor",
+        "Signs, verifies, and revokes JWT tokens"
+      ]
+    },
+    {
+      "name": "HashService",
+      "entityType": "dependency",
+      "observations": [
+        "Injected via constructor",
+        "Compares plain-text passwords against stored hashes"
+      ]
+    },
+    {
+      "name": "login",
+      "entityType": "function",
+      "observations": [
+        "Accepts email and password, returns signed JWT string",
+        "Throws on unknown user or wrong password"
+      ]
+    },
+    {
+      "name": "refresh",
+      "entityType": "function",
+      "observations": ["Verifies existing token and issues a new one"]
+    },
+    {
+      "name": "logout",
+      "entityType": "function",
+      "observations": ["Revokes all tokens for the given user ID"]
+    }
+  ],
+  "relations": [
+    { "from": "AuthService", "to": "IAuthService",     "relationType": ["implements"] },
+    { "from": "AuthService", "to": "UserRepository",   "relationType": ["depends_on"] },
+    { "from": "AuthService", "to": "JwtTokenService",  "relationType": ["depends_on"] },
+    { "from": "AuthService", "to": "HashService",      "relationType": ["depends_on"] },
+    { "from": "login",       "to": "UserRepository",   "relationType": ["calls"] },
+    { "from": "login",       "to": "HashService",      "relationType": ["calls"] },
+    { "from": "login",       "to": "JwtTokenService",  "relationType": ["calls"] },
+    { "from": "refresh",     "to": "JwtTokenService",  "relationType": ["calls"] },
+    { "from": "logout",      "to": "JwtTokenService",  "relationType": ["calls"] }
+  ]
+}
+```
+
+---
+
+### Example 2
+
+Input:
+
+## File Information
+
+Path: `pipelines/ingest.py`
+
+## Content to Analyze
+
+```python
+import csv
+import json
+from dataclasses import dataclass
+from typing import List
+
+@dataclass
+class SalesRecord:
+    sku: str
+    region: str
+    quantity: int
+    revenue: float
+
+def read_csv(file_path: str) -> List[SalesRecord]:
+    records = []
+    with open(file_path, newline='') as f:
+        for row in csv.DictReader(f):
+            records.append(SalesRecord(
+                sku=row['SKU'],
+                region=row['Region'],
+                quantity=int(row['Quantity']),
+                revenue=float(row['Revenue']),
+            ))
+    return records
+
+def filter_by_region(records: List[SalesRecord], region: str) -> List[SalesRecord]:
+    return [r for r in records if r.region == region]
+
+def export_json(records: List[SalesRecord], out_path: str) -> None:
+    with open(out_path, 'w') as f:
+        json.dump([vars(r) for r in records], f, indent=2)
+
+def ingest_pipeline(src: str, region: str, dest: str) -> None:
+    records = read_csv(src)
+    filtered = filter_by_region(records, region)
+    export_json(filtered, dest)
+```
+
+Output:
+
+```json
+{
+  "entities": [
+    {
+      "name": "SalesRecord",
+      "entityType": "data_structure",
+      "observations": [
+        "Python dataclass with sku, region, quantity, revenue fields",
+        "Used as the canonical in-memory representation of a CSV row"
+      ]
+    },
+    {
+      "name": "read_csv",
+      "entityType": "function",
+      "observations": [
+        "Reads a CSV file and returns a list of SalesRecord instances",
+        "Uses csv.DictReader; expects SKU, Region, Quantity, Revenue columns"
+      ]
+    },
+    {
+      "name": "filter_by_region",
+      "entityType": "function",
+      "observations": [
+        "Filters a list of SalesRecord by exact region string match",
+        "Returns a new list; does not mutate input"
+      ]
+    },
+    {
+      "name": "export_json",
+      "entityType": "function",
+      "observations": [
+        "Serializes SalesRecord list to a pretty-printed JSON file",
+        "Converts dataclasses to dicts via vars()"
+      ]
+    },
+    {
+      "name": "ingest_pipeline",
+      "entityType": "function",
+      "observations": [
+        "Orchestrates the full ETL: read → filter → export",
+        "Entry point for the ingestion module"
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "read_csv",         "to": "SalesRecord",      "relationType": ["produces"] },
+    { "from": "filter_by_region", "to": "SalesRecord",      "relationType": ["processes"] },
+    { "from": "export_json",      "to": "SalesRecord",      "relationType": ["processes"] },
+    { "from": "ingest_pipeline",  "to": "read_csv",         "relationType": ["calls"] },
+    { "from": "ingest_pipeline",  "to": "filter_by_region", "relationType": ["calls"] },
+    { "from": "ingest_pipeline",  "to": "export_json",      "relationType": ["calls"] }
+  ]
+}
+```