@justyork/repo-mind 0.3.0

package/dist/ui/upload-asset.js

@@ -0,0 +1,61 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { assetApiPath, isImageFileName } from '../index/asset-file.js';
+import { parseMultipartFormData } from './parse-multipart.js';
+import { isValidFsName, joinRelativePath, normalizeRelativePath, resolveUnderKnowledgeRoot } from './safe-path.js';
+export const MAX_ASSET_UPLOAD_BYTES = 5 * 1024 * 1024;
+const DEFAULT_ASSET_DIR = 'assets';
+function isUnderAssetsDir(relativeDir) {
+    const normalized = normalizeRelativePath(relativeDir);
+    if (!normalized) {
+        return false;
+    }
+    return normalized === 'assets' || normalized.startsWith('assets/');
+}
+function validateImageFileName(fileName) {
+    const base = path.basename(fileName);
+    if (!isImageFileName(base)) {
+        return false;
+    }
+    const stem = base.slice(0, base.length - path.extname(base).length);
+    return isValidFsName(stem);
+}
+export function handleAssetUpload(knowledgeRoot, body, contentType) {
+    let parsed;
+    try {
+        parsed = parseMultipartFormData(body, contentType);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'invalid multipart body';
+        return { status: 400, body: { error: message } };
+    }
+    const file = parsed.files.get('file');
+    if (!file) {
+        return { status: 400, body: { error: 'file field required' } };
+    }
+    if (file.data.length > MAX_ASSET_UPLOAD_BYTES) {
+        return { status: 400, body: { error: 'file too large (max 5MB)' } };
+    }
+    const relativeDir = normalizeRelativePath(parsed.fields.get('relativeDir')?.trim() || DEFAULT_ASSET_DIR);
+    if (!isUnderAssetsDir(relativeDir)) {
+        return { status: 400, body: { error: 'relativeDir must be under assets/' } };
+    }
+    const fileName = path.basename(file.fileName);
+    if (!validateImageFileName(fileName)) {
+        return { status: 400, body: { error: 'invalid image file name' } };
+    }
+    const relativePath = joinRelativePath(relativeDir, fileName);
+    const absolutePath = resolveUnderKnowledgeRoot(knowledgeRoot, relativePath);
+    if (!absolutePath) {
+        return { status: 400, body: { error: 'invalid upload path' } };
+    }
+    fs.mkdirSync(path.dirname(absolutePath), { recursive: true });
+    fs.writeFileSync(absolutePath, file.data);
+    return {
+        status: 200,
+        body: {
+            relativePath,
+            url: assetApiPath(relativePath),
+        },
+    };
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@justyork/repo-mind",
+  "version": "0.3.0",
+  "description": "Unified docs/ workspace for humans (UI) and AI agents (MCP) — Confluence in your repo",
+  "type": "module",
+  "bin": {
+    "repo-mind": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "ui/dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc && npm run build:ui",
+    "build:ui": "vite build --config ui/vite.config.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "ab-demo": "npm run build --silent && node dist/ab-demo/run-ab.js --dry-run",
+    "ab-demo:run": "npm run build --silent && node dist/ab-demo/run-ab.js",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "ai",
+    "documentation",
+    "knowledge-base"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/justyork/repomind.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "better-sqlite3": "^12.11.1",
+    "chokidar": "^4.0.3",
+    "fast-glob": "^3.3.3",
+    "gray-matter": "^4.0.3",
+    "mermaid": "^11.15.0",
+    "minimatch": "^10.0.1"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.15.21",
+    "d3": "^7.9.0",
+    "marked": "^15.0.12",
+    "typescript": "^5.8.3",
+    "vite": "^6.3.5",
+    "vitest": "^3.2.1"
+  }
+}

package/templates/adr-example.md

@@ -0,0 +1,27 @@
+---
+type: adr
+domain: technical
+slug: use-plain-markdown
+status: accepted
+title: Use plain Markdown for project knowledge
+tags:
+  - storage
+  - markdown
+related:
+  - mcp
+updated: 2026-06-21
+---
+
+## Context
+
+We need a format that humans and agents can read without special tooling.
+
+## Decision
+
+Store all project knowledge as Markdown files with YAML frontmatter under `docs/`.
+
+## Consequences
+
+- Easy to diff in git
+- No database required for v1
+- Agents can query via MCP instead of reading whole files

package/templates/agent-instruction-example.md

@@ -0,0 +1,20 @@
+---
+type: agent-instruction
+domain: shared
+slug: query-first
+status: accepted
+title: Query project knowledge before reading files
+tags:
+  - agents
+  - workflow
+related:
+  - mcp
+updated: 2026-06-21
+---
+
+When answering project questions:
+
+1. Call `search_docs` or `get_glossary_term` first
+2. Use `get_doc` for the specific slug you need
+3. Use `explore_graph` to understand related decisions
+4. Only read raw markdown files if MCP tools return no results

package/templates/combat-system-example.md

@@ -0,0 +1,27 @@
+---
+type: feature-spec
+domain: game-design
+slug: combat-system
+status: proposed
+title: Combat System
+tags:
+  - game-design
+  - combat
+related:
+  - mcp
+updated: 2026-06-21
+---
+
+## Summary
+
+Turn-based combat with action points, elemental weaknesses, and status effects.
+
+## Core loop
+
+1. Player selects up to 3 actions per turn (costs action points)
+2. Enemy AI chooses actions based on threat table
+3. Apply damage, shields, and status effects in initiative order
+
+## Design notes
+
+This example doc shows how game-design knowledge fits the same `feature-spec` type as product specs — no schema expansion required.

package/templates/feature-spec-example.md

@@ -0,0 +1,27 @@
+---
+type: feature-spec
+domain: technical
+slug: user-authentication
+status: proposed
+title: User Authentication
+tags:
+  - auth
+  - security
+related:
+  - mcp
+updated: 2026-06-21
+---
+
+## Summary
+
+Users sign in with email and password. Sessions expire after 24 hours.
+
+## Requirements
+
+- Password hashing with bcrypt
+- Rate limiting on login attempts
+- Session tokens stored as httpOnly cookies
+
+## Open Questions
+
+See `open-questions/search-ranking.md` for unresolved ranking behavior.

package/templates/glossary-term-example.md

@@ -0,0 +1,15 @@
+---
+type: glossary-term
+domain: shared
+slug: mcp
+status: accepted
+title: Model Context Protocol (MCP)
+tags:
+  - agents
+  - integration
+related:
+  - use-plain-markdown
+updated: 2026-06-21
+---
+
+Model Context Protocol (MCP) is a standard for connecting AI agents to tools and data sources. RepoMind exposes project knowledge through MCP read tools so agents query by intent instead of ingesting entire files.

package/templates/open-question-example.md

@@ -0,0 +1,26 @@
+---
+type: open-question
+domain: product
+slug: search-ranking
+status: draft
+title: Is grep ranking good enough?
+tags:
+  - search
+  - performance
+related:
+  - mcp
+updated: 2026-06-21
+---
+
+## Question
+
+Should v1 ship with simple grep-based ranking, or invest in SQLite FTS early?
+
+## Options
+
+1. Grep + scoring formula (current v1 plan)
+2. SQLite FTS index (Approach B)
+
+## Decision criteria
+
+Run the A/B kill-switch demo. Upgrade only if ranking quality blocks adoption.

package/ui/dist/assets/arc-DhC0JPue.js

@@ -0,0 +1 @@
+import{$ as ln,a0 as an,a1 as G,a2 as q,a3 as z,a4 as un,a5 as y,a6 as tn,a7 as K,a8 as _,a9 as rn,aa as o,ab as on,ac as sn,ad as fn}from"./mermaid.core-Bddhr0ku.js";function cn(l){return l.innerRadius}function yn(l){return l.outerRadius}function gn(l){return l.startAngle}function dn(l){return l.endAngle}function mn(l){return l&&l.padAngle}function pn(l,h,I,D,v,A,B,a){var O=I-l,i=D-h,n=B-v,d=a-A,u=d*O-n*i;if(!(u*u<y))return u=(n*(h-A)-d*(l-v))/u,[l+u*O,h+u*i]}function V(l,h,I,D,v,A,B){var a=l-I,O=h-D,i=(B?A:-A)/K(a*a+O*O),n=i*O,d=-i*a,u=l+n,s=h+d,f=I+n,c=D+d,C=(u+f)/2,t=(s+c)/2,m=f-u,g=c-s,R=m*m+g*g,T=v-A,P=u*c-f*s,S=(g<0?-1:1)*K(on(0,T*T*R-P*P)),$=(P*g-m*S)/R,j=(-P*m-g*S)/R,w=(P*g+m*S)/R,p=(-P*m+g*S)/R,x=$-C,e=j-t,r=w-C,F=p-t;return x*x+e*e>r*r+F*F&&($=w,j=p),{cx:$,cy:j,x01:-n,y01:-d,x11:$*(v/T-1),y11:j*(v/T-1)}}function hn(){var l=cn,h=yn,I=z(0),D=null,v=gn,A=dn,B=mn,a=null,O=ln(i);function i(){var n,d,u=+l.apply(this,arguments),s=+h.apply(this,arguments),f=v.apply(this,arguments)-un,c=A.apply(this,arguments)-un,C=rn(c-f),t=c>f;if(a||(a=n=O()),s<u&&(d=s,s=u,u=d),!(s>y))a.moveTo(0,0);else if(C>tn-y)a.moveTo(s*G(f),s*q(f)),a.arc(0,0,s,f,c,!t),u>y&&(a.moveTo(u*G(c),u*q(c)),a.arc(0,0,u,c,f,t));else{var m=f,g=c,R=f,T=c,P=C,S=C,$=B.apply(this,arguments)/2,j=$>y&&(D?+D.apply(this,arguments):K(u*u+s*s)),w=_(rn(s-u)/2,+I.apply(this,arguments)),p=w,x=w,e,r;if(j>y){var F=sn(j/u*q($)),L=sn(j/s*q($));(P-=F*2)>y?(F*=t?1:-1,R+=F,T-=F):(P=0,R=T=(f+c)/2),(S-=L*2)>y?(L*=t?1:-1,m+=L,g-=L):(S=0,m=g=(f+c)/2)}var H=s*G(m),J=s*q(m),M=u*G(T),N=u*q(T);if(w>y){var Q=s*G(g),U=s*q(g),W=u*G(R),X=u*q(R),E;if(C<an)if(E=pn(H,J,W,X,Q,U,M,N)){var Y=H-E[0],Z=J-E[1],b=Q-E[0],k=U-E[1],nn=1/q(fn((Y*b+Z*k)/(K(Y*Y+Z*Z)*K(b*b+k*k)))/2),en=K(E[0]*E[0]+E[1]*E[1]);p=_(w,(u-en)/(nn-1)),x=_(w,(s-en)/(nn+1))}else p=x=0}S>y?x>y?(e=V(W,X,H,J,s,x,t),r=V(Q,U,M,N,s,x,t),a.moveTo(e.cx+e.x01,e.cy+e.y01),x<w?a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,s,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),!t),a.arc(r.cx,r.cy,x,o(r.y11,r.x11),o(r.y01,r.x01),!t))):(a.moveTo(H,J),a.arc(0,0,s,m,g,!t)):a.moveTo(H,J),!(u>y)||!(P>y)?a.lineTo(M,N):p>y?(e=V(M,N,Q,U,u,-p,t),r=V(H,J,W,X,u,-p,t),a.lineTo(e.cx+e.x01,e.cy+e.y01),p<w?a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,u,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),t),a.arc(r.cx,r.cy,p,o(r.y11,r.x11),o(r.y01,r.x01),!t))):a.arc(0,0,u,T,R,t)}if(a.closePath(),n)return a=null,n+""||null}return i.centroid=function(){var n=(+l.apply(this,arguments)+ +h.apply(this,arguments))/2,d=(+v.apply(this,arguments)+ +A.apply(this,arguments))/2-an/2;return[G(d)*n,q(d)*n]},i.innerRadius=function(n){return arguments.length?(l=typeof n=="function"?n:z(+n),i):l},i.outerRadius=function(n){return arguments.length?(h=typeof n=="function"?n:z(+n),i):h},i.cornerRadius=function(n){return arguments.length?(I=typeof n=="function"?n:z(+n),i):I},i.padRadius=function(n){return arguments.length?(D=n==null?null:typeof n=="function"?n:z(+n),i):D},i.startAngle=function(n){return arguments.length?(v=typeof n=="function"?n:z(+n),i):v},i.endAngle=function(n){return arguments.length?(A=typeof n=="function"?n:z(+n),i):A},i.padAngle=function(n){return arguments.length?(B=typeof n=="function"?n:z(+n),i):B},i.context=function(n){return arguments.length?(a=n??null,i):a},i}export{hn as d};