FID

Directory → Ontology → Command Center

What is FID?

FID (File Image Discovery) scans any directory and generates a domain ontology, importance scores, and a live command center. No configuration. The structure IS the interface.

npx fid scan ./my-project

Scanning ./my-project...

Domain detected: ad-intelligence (confidence: 0.94)
Components: 13 found, 2 gaps detected
Importance scores calculated (PEI avg: 7.2)

Command center ready → http://localhost:4200

How It Works

ANY DIRECTORY          FID SCANS              COMMAND CENTER
                                              MATERIALIZES
~/my-project/    →     Detect domains,   →    Live dashboard
  ├── api/             score importance,       Agent activity
  ├── data/            find gaps,              Gap radar
  ├── agents/          map relationships       File tree view
  └── config/                                  Voice + chat

The 4-Stage Pipeline

1. Scanner — Walks the file tree, classifies files by domain
2. Ontology — Maps relationships, detects components and gaps
3. Scorer — Calculates importance (completeness, connectivity, freshness, domain weight, gap detection)
4. Commander — Generates a real-time command center UI

Agentic Importance Scoring

Every data point is scored on 5 dimensions:

| Dimension | What it measures | |---|---| | Completeness | How fully developed is this component? | | Connectivity | How many other components depend on it? | | Freshness | When was it last modified? | | Domain Weight | How critical is it to this specific domain? | | Gap Detection | What's missing that should exist? |

Agents use these scores to decide what to build next.

Usage

CLI

# Scan a directory
npx fid scan ./my-project

# Output ontology as JSON
npx fid scan ./my-project --format json

# Watch mode (re-scan on file changes)
npx fid watch ./my-project

# Score only (no UI)
npx fid score ./my-project

Library

import { FID } from 'fid';

const result = await FID.scan('./my-project');

console.log(result.domain);      // 'ad-intelligence'
console.log(result.components);   // [{ name: 'api', score: 8.3, ... }]
console.log(result.gaps);         // [{ name: 'auth', severity: 'high' }]
console.log(result.ontology);     // Full relationship graph

With aoskit

import { AOS } from 'aoskit';
import { FID } from 'fid';

const wiz = new AOS({ name: 'wiz', domain: 'ad-intelligence', version: '1.0.0' });
wiz.observe(FID.scan('./'));

Part of the XY&Z Ecosystem

| Package | Purpose | |---------|---------| | aoskit | Reference SDK for building AOS | | fid | Directory → ontology → command center | | pid-sdk | Universal agentic identity | | boarding | Progressive onboarding |

License

MIT © XY and Z

Point at a directory. Get a command center. Zero config.

xyandz.io