pcl-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael Sathya Gorski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,122 @@
+# PCL — Product Context Layer
+
+**Give AI coding agents persistent, structured knowledge of your product.**
+
+Instead of re-explaining your personas, journeys, and architecture decisions every session, PCL serves them via MCP on demand. Any agent (Claude Code, Cursor, Windsurf) queries exactly what it needs, when it needs it.
+
+## Stack
+
+| Layer | Technology | Why |
+|---|---|---|
+| Protocol | MCP (stdio) | Universal — works with every major agent |
+| Storage | SQLite + FTS5 | Zero infra, git-friendly, offline |
+| Keyword search | BM25 via FTS5 | Best-in-class for exact term matching |
+| Semantic search | `all-MiniLM-L6-v2` (local) | 23MB, zero API cost, ~3ms/doc |
+| Hybrid fusion | Reciprocal Rank Fusion (k=60) | Better than either alone, no tuning |
+| Validation | Zod schemas | Agents rely on predictable frontmatter |
+| File watching | Chokidar v4 | Live reindex on save |
+
+## Install
+
+```bash
+npm install pcl-mcp
+npx pcl init            # scaffold /product folder
+npm run serve           # start MCP server
+```
+
+## Agent configuration
+
+### Claude Code — `.claude/mcp.json`
+```json
+{
+  "mcpServers": {
+    "pcl": {
+      "command": "node",
+      "args": ["./node_modules/pcl-mcp/dist/src/server.js"]
+    }
+  }
+}
+```
+
+### Cursor — `settings.json`
+```json
+"mcp.servers": {
+  "pcl": {
+    "command": "npx",
+    "args": ["pcl-mcp", "serve"]
+  }
+}
+```
+
+## File structure
+
+```
+/product
+  product.md              ← north star doc (required)
+  personas/
+    001-max.md            ← one persona per file
+  journeys/
+    001-onboarding.md     ← one user journey per file
+  specs/
+    001-auth-flow.md      ← feature specs with acceptance criteria
+  decisions/
+    001-use-nextjs.md     ← architecture decision records (ADRs)
+  domain/
+    core-rules.md         ← business rules agents must never violate
+  .pcl.db                 ← SQLite index (auto-generated, gitignore this)
+```
+
+## Tools available to agents
+
+| Tool | When to use |
+|---|---|
+| `pcl_product_summary` | Always — call at session start |
+| `pcl_get_domain("*critical")` | Always — load hard business rules |
+| `pcl_get_persona(id)` | Before any user-facing feature |
+| `pcl_get_journey(id)` | Before any user flow code |
+| `pcl_get_spec(id)` | Before implementing a feature |
+| `pcl_get_decision(id)` | Before architectural decisions |
+| `pcl_list(type)` | Discover what exists |
+| `pcl_search(query)` | When you don't know the ID |
+| `pcl_related(id)` | Discover connected context |
+
+## How hybrid search works
+
+```
+query: "what does Max find frustrating about onboarding"
+
+BM25 (FTS5):      [persona-max, journey-onboarding, spec-magic-link, ...]
+                   ↓ ranked by term frequency + IDF
+
+Cosine similarity: [journey-onboarding, persona-max, domain-core-rules, ...]
+                   ↓ ranked by embedding dot product (MiniLM-L6-v2)
+
+RRF fusion:        score(d) = Σ 1 / (60 + rank(d))
+                   ↓ combines both rankings without weight tuning
+
+Result:            1. journey-onboarding (0.94)
+                   2. persona-max (0.87)
+                   3. spec-onboarding-ux (0.71)
+```
+
+## Human workflow
+
+The system is only as good as what you put in. Discipline:
+
+- **Product decision made?** → Write a `decisions/` ADR (5 min)
+- **New feature being planned?** → Write a `specs/` file first, then code
+- **User research or feedback?** → Update persona `anti_patterns` or `jobs_to_be_done`
+- **Business rule change?** → Update `domain/` first, then code
+- **New user journey discovered?** → Add to `journeys/`
+
+The agent does the rest.
+
+## Gitignore
+
+```gitignore
+product/.pcl.db      # SQLite index — auto-regenerated
+```
+
+## License
+
+MIT

package/dist/bin/pcl.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=pcl.d.ts.map

package/dist/bin/pcl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcl.d.ts","sourceRoot":"","sources":["../../bin/pcl.ts"],"names":[],"mappings":""}

package/dist/bin/pcl.js

@@ -0,0 +1,327 @@
+#!/usr/bin/env node
+// bin/pcl.ts
+// CLI: pcl init | pcl serve | pcl status
+import { mkdir, writeFile, access } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { constants } from "node:fs";
+const cmd = process.argv[2];
+const args = process.argv.slice(3);
+const hasFlag = (flag) => args.includes(flag);
+// ─── Templates ────────────────────────────────────────────────────────────────
+const TEMPLATES = {
+    "product.md": `---
+name: "My Product"
+tagline: "One-line description of what it does"
+problem: "The problem this product solves"
+solution: "How it solves that problem"
+primary_persona: "change-this-to-your-persona-id"
+tech_stack:
+  - Next.js
+  - Supabase
+  - TypeScript
+stage: prototype
+repo: ""
+url: ""
+---
+
+## Vision
+
+Write your product vision here. What does success look like in 3 years?
+
+## North star metric
+
+The one number that proves this product is working.
+
+## What this product is NOT
+
+(Helps agents avoid scope creep — be explicit about what you're not building)
+`,
+    "personas/001-example.md": `---
+id: example-user
+name: "Alex"
+role: "Freelance designer"
+age_range: "25-35"
+tech_level: medium
+primary_goal: "Ship client projects faster without sacrificing quality"
+biggest_fear: "Losing a client because a project ran over time or budget"
+jobs_to_be_done:
+  - Track project time without friction
+  - Communicate progress to clients proactively
+  - Avoid scope creep
+anti_patterns:
+  - Won't fill out forms longer than 2 minutes
+  - Ignores marketing emails, responds to Slack/WhatsApp
+  - Doesn't read documentation, prefers watching a 60-second demo
+channels:
+  - Twitter/X
+  - Dribbble
+  - Designer Slack communities
+---
+
+## Context
+
+Write 2-3 sentences about Alex's day-to-day life. What does their work look like?
+What tools do they already use? What's the emotional context behind their problem?
+
+## Design implications
+
+Write specific rules the agent must follow when building anything for this persona:
+- Maximum X steps to complete core action
+- Must work on mobile
+- etc.
+`,
+    "journeys/001-onboarding.md": `---
+id: onboarding
+name: "First-time onboarding"
+persona: example-user
+trigger: "User clicks 'Get started free' on landing page"
+success_state: "User completes their first core action within 10 minutes of signup"
+failure_modes:
+  - "Drops off at email verification step"
+  - "Completes signup but never reaches core feature"
+  - "Starts core feature but abandons before saving"
+steps:
+  - landing
+  - signup
+  - verify-email
+  - first-action
+  - aha-moment
+---
+
+## Step detail
+
+### landing
+Goal: Communicate value prop in under 10 seconds.
+Critical: Show social proof above the fold.
+Do not: Ask for credit card on landing page.
+
+### signup
+Email + password or magic link only.
+Do NOT ask for name, company, or phone at this step — capture later.
+
+### verify-email
+Keep this step as frictionless as possible.
+Provide a "resend" link immediately visible.
+Auto-redirect on verification — don't make user click a button.
+
+### first-action
+This is where users must reach immediately after signup.
+Pre-fill as much as possible from their signup email/domain.
+Show a progress indicator: "Step 1 of 3".
+
+### aha-moment
+Define what the "aha moment" is for your product.
+Everything before this step is setup — this is where retention begins.
+`,
+    "specs/001-example-feature.md": `---
+id: magic-link-auth
+title: "Magic link authentication"
+persona: example-user
+journey: onboarding
+status: draft
+acceptance_criteria:
+  - "User enters email and receives a link within 30 seconds"
+  - "Link expires after 15 minutes"
+  - "Link works only once (single-use token)"
+  - "After clicking, user is redirected to /dashboard"
+  - "If link is expired, user sees a clear error with a 'Request new link' button"
+out_of_scope:
+  - "Social login (OAuth) — deferred to v2"
+  - "SMS-based verification"
+design_ref: ""
+---
+
+## Overview
+
+Write a short description of the feature from the user's perspective.
+
+## Technical notes
+
+Any implementation constraints the agent needs to know:
+- Which library to use
+- Which existing patterns to follow
+- Security requirements
+
+## Edge cases
+
+List edge cases that are NOT covered by acceptance criteria above.
+`,
+    "decisions/001-example-adr.md": `---
+id: adr-001
+title: "Use Next.js App Router + Supabase"
+status: accepted
+date: "2025-01-01"
+context: "Need a full-stack framework with good DX, easy auth, and minimal ops overhead for a solo developer."
+decision: "Use Next.js App Router for the frontend/API layer and Supabase for auth, database, and storage."
+consequences:
+  - "Edge functions for webhook handling"
+  - "Row Level Security (RLS) policies enforce data isolation — agents must always include RLS on new tables"
+  - "No separate backend service needed"
+alternatives_rejected:
+  - "Remix — less Claude Code tooling support as of Q1 2025"
+  - "PlanetScale — cost at scale vs Supabase free tier"
+---
+
+## Detail
+
+Write more context here if needed. What trade-offs were made?
+What would make this decision worth revisiting?
+`,
+    "domain/core-rules.md": `---
+id: core-business-rules
+critical: true
+title: "Core business rules"
+---
+
+## Rules that must NEVER be violated
+
+These are business invariants. No agent should ever write code that contradicts these rules.
+If in doubt, call pcl_get_domain('*critical') before touching the relevant code.
+
+### Data ownership
+1. User data is NEVER deleted on account downgrade — only access is restricted
+2. Export must always be available regardless of plan
+
+### Billing
+1. Cancellation takes effect immediately — no grace period unless explicitly specified
+2. Downgrade happens at end of billing period, never mid-period
+3. Stripe is the source of truth for subscription status — never trust local DB alone
+
+### Authentication
+1. Sessions expire after 30 days of inactivity
+2. Password reset tokens expire after 1 hour
+3. Never log or store plaintext passwords, tokens, or secrets anywhere
+
+### Add your own rules below...
+`,
+};
+// ─── Commands ─────────────────────────────────────────────────────────────────
+async function init() {
+    const scanMode = hasFlag("--scan");
+    const scanOnly = hasFlag("--scan-only");
+    // First positional arg that doesn't start with -- is the dir
+    const dirArg = args.find((a) => !a.startsWith("--"));
+    const productDir = resolve(dirArg ?? "./product");
+    console.log(`\nInitialising PCL product folder at: ${productDir}\n`);
+    // Track which type categories were covered by scan imports
+    const coveredTypes = new Set();
+    // ── Scan phase ──
+    if (scanMode || scanOnly) {
+        const { runScan } = await import("../src/scanner.js");
+        const rootDir = process.cwd();
+        const summary = await runScan(rootDir, productDir);
+        if (scanOnly) {
+            console.log("\nDone (scan-only mode).\n");
+            return;
+        }
+        for (const r of summary.imported)
+            coveredTypes.add(r.type);
+        console.log(""); // blank line before template scaffolding
+    }
+    // ── Template scaffolding ──
+    // Map template relative paths to the PCL type category they belong to
+    const templateTypeMap = {
+        "product.md": "product",
+        "personas/001-example.md": "persona",
+        "journeys/001-onboarding.md": "journey",
+        "specs/001-example-feature.md": "spec",
+        "decisions/001-example-adr.md": "decision",
+        "domain/core-rules.md": "domain",
+    };
+    const dirs = ["", "personas", "journeys", "specs", "decisions", "domain"];
+    for (const dir of dirs) {
+        await mkdir(join(productDir, dir), { recursive: true });
+    }
+    let created = 0;
+    let skipped = 0;
+    for (const [rel, content] of Object.entries(TEMPLATES)) {
+        // Skip templates for categories already covered by scan imports
+        const category = templateTypeMap[rel];
+        if (category && coveredTypes.has(category)) {
+            console.log(`  ↷  ${rel} (category covered by scan, skipped)`);
+            skipped++;
+            continue;
+        }
+        const dest = join(productDir, rel);
+        try {
+            await access(dest, constants.F_OK);
+            console.log(`  ↷  ${rel} (exists, skipped)`);
+            skipped++;
+        }
+        catch {
+            await writeFile(dest, content, "utf8");
+            console.log(`  ✓  ${rel}`);
+            created++;
+        }
+    }
+    // Write CLAUDE.md bridge
+    const claudeMd = join(process.cwd(), "CLAUDE.md");
+    const bridge = `
+## Product Context Layer (PCL)
+
+This project uses PCL for product knowledge. An MCP server is running (see mcp config).
+
+### At the start of every coding session:
+1. Call \`pcl_product_summary\` — orient yourself
+2. Call \`pcl_get_domain("*critical")\` — load non-violable business rules
+
+### Before working on any user-facing feature:
+- Call \`pcl_list({ type: "personas" })\` then \`pcl_get_persona(id)\` for the relevant persona
+- Call \`pcl_list({ type: "journeys" })\` then \`pcl_get_journey(id)\` for the relevant journey
+- Call \`pcl_list({ type: "specs" })\` then \`pcl_get_spec(id)\` for the feature spec if it exists
+
+### When unsure about product decisions:
+- Call \`pcl_search({ query: "your question here" })\` to find relevant product knowledge
+- Call \`pcl_get_decision(id)\` for architecture decisions affecting your current task
+
+### NEVER:
+- Make assumptions about who the user is — always load the persona
+- Violate any rule in domain/core-rules.md
+- Build features not covered by an accepted spec without asking first
+`;
+    try {
+        await access(claudeMd, constants.F_OK);
+        console.log(`\n  ↷  CLAUDE.md exists — add the PCL instructions manually (printed above)`);
+        console.log(bridge);
+    }
+    catch {
+        const existing = "";
+        await writeFile(claudeMd, existing + bridge, "utf8");
+        console.log(`  ✓  CLAUDE.md`);
+        created++;
+    }
+    console.log(`\nDone! Created: ${created}, skipped: ${skipped}`);
+    console.log("\nNext steps:");
+    console.log("  1. Edit product/product.md with your actual product details");
+    console.log("  2. Rename and fill in the example persona, journey, and spec files");
+    console.log("  3. Add your MCP server config (see README)");
+    console.log("  4. npm run serve\n");
+}
+// ─── Router ───────────────────────────────────────────────────────────────────
+switch (cmd) {
+    case "init":
+        init().catch(console.error);
+        break;
+    case "serve":
+        // Delegate to the server module
+        import("../src/server.js").catch(console.error);
+        break;
+    default:
+        console.log(`
+pcl — Product Context Layer CLI
+
+Commands:
+  init [dir]              Scaffold /product folder with templates (default: ./product)
+  init --scan [dir]       Scan repo for existing .md files, import, then scaffold remaining templates
+  init --scan-only [dir]  Scan and import only, don't scaffold templates
+  serve                   Start the MCP server (reads --product-dir flag)
+
+Examples:
+  npx pcl-mcp init
+  npx pcl-mcp init --scan
+  npx pcl-mcp init --scan-only
+  npx pcl-mcp init ./my-product-docs
+  npx pcl-mcp serve --product-dir ./product
+`);
+}
+//# sourceMappingURL=pcl.js.map

package/dist/bin/pcl.js.map

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

package/dist/src/db.d.ts

@@ -0,0 +1,38 @@
+import Database from "better-sqlite3";
+import type { FileType, IndexedFile } from "./types.js";
+export declare function packEmbedding(vec: number[]): Buffer;
+export declare function unpackEmbedding(buf: Buffer): number[];
+export declare function hashContent(text: string): string;
+export declare function openDB(productDir: string): Database.Database;
+export declare function closeDB(): void;
+export interface DBRow {
+    id: string;
+    type: FileType;
+    path: string;
+    frontmatter: string;
+    body: string;
+    full_text: string;
+    title: string;
+    summary: string;
+    critical: number;
+    mtime: number;
+    hash: string;
+    embedding: Buffer | null;
+}
+export declare function upsertFile(db: Database.Database, file: IndexedFile): void;
+export declare function updateEmbedding(db: Database.Database, path: string, embedding: number[]): void;
+export declare function deleteFile(db: Database.Database, path: string): void;
+export declare function getFileByPath(db: Database.Database, path: string): IndexedFile | null;
+export declare function getFileById(db: Database.Database, type: FileType, id: string): IndexedFile | null;
+export declare function getProductFile(db: Database.Database): IndexedFile | null;
+export declare function listByType(db: Database.Database, type: FileType): IndexedFile[];
+export declare function getCritical(db: Database.Database): IndexedFile[];
+export declare function getAllWithEmbeddings(db: Database.Database): IndexedFile[];
+export declare function getAllWithoutEmbeddings(db: Database.Database): IndexedFile[];
+export interface FTSResult {
+    id: string;
+    type: string;
+    rank: number;
+}
+export declare function keywordSearch(db: Database.Database, query: string, limit?: number): FTSResult[];
+//# sourceMappingURL=db.d.ts.map

package/dist/src/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/db.ts"],"names":[],"mappings":"AAMA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA2DxD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAErD;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAQD,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAoB5D;AAED,wBAAgB,OAAO,IAAI,IAAI,CAO9B;AAkDD,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAqBD,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAgBzE;AAED,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EAAE,GAClB,IAAI,CAGN;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGpE;AAID,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAGrF;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAGjG;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,WAAW,GAAG,IAAI,CAGxE;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG,WAAW,EAAE,CAG/E;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,WAAW,EAAE,CAGhE;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,WAAW,EAAE,CAKzE;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,WAAW,EAAE,CAG5E;AAID,MAAM,WAAW,SAAS;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAErE,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,SAAS,EAAE,CAeb"}