@leji-org/leji 1.0.0

package/dist/lib/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/lib/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,SAAS,GAAG,CAAC,IAAY,EAAE,IAAc;IACtC,IAAI,CAAC;QACF,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE;YAC/C,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,OAAO,EAAE,MAAM;SACjB,CAAC,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACN,OAAO,IAAI,CAAC;IACf,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAAC,IAAY;IACrC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACxD,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAe;IAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACnE,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACzD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;IACzB,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7B,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAe;IACtD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,sEAAsE;IACtE,sEAAsE;IACtE,IAAI,WAAmB,CAAC;IACxB,IAAI,YAAoB,CAAC;IACzB,IAAI,CAAC;QACF,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACnC,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACN,qEAAqE;QACrE,OAAO,IAAI,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IAClE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,OAAO,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/lib/layer.d.ts

@@ -0,0 +1,32 @@
+import { type Finding } from './findings.js';
+import { type CategoryId, type Manifest } from './manifest.js';
+export interface ScannedDoc {
+    relPath: string;
+    category: CategoryId;
+    frontmatter: Record<string, unknown> | null;
+    body: string;
+}
+export interface ScannedProfile {
+    relPath: string;
+    frontmatter: Record<string, unknown> | null;
+    findings: Finding[];
+}
+/** Files validate/index must not treat as category content. */
+export declare function excludedFromCategories(manifest: Manifest): (relPath: string) => boolean;
+/**
+ * Collect category documents. A file matched by several category paths is
+ * assigned once: longest declared path wins, manifest order breaks ties.
+ */
+export declare function scanCategories(root: string, manifest: Manifest): ScannedDoc[];
+export declare function scanAgentProfiles(root: string, manifest: Manifest): ScannedProfile[];
+export declare function scanDecisionRecords(root: string, manifest: Manifest): ScannedProfile[];
+/** Duplicate-id findings across a set of artifacts that carry an `id`. */
+export declare function duplicateIdFindings(items: {
+    id: unknown;
+    relPath: string;
+}[], scope: string): Finding[];
+/** Read a declared JSON artifact; returns parsed value or a finding. */
+export declare function readJsonArtifact(root: string, relPath: string): {
+    data: unknown;
+    finding?: Finding;
+};

package/dist/lib/layer.js

@@ -0,0 +1,138 @@
+import * as path from 'node:path';
+import { finding } from './findings.js';
+import { isFile, readText, realpathWithin, underPath, walkMd } from './fsx.js';
+import { parseFrontmatter } from './frontmatter.js';
+import { CATEGORY_IDS } from './manifest.js';
+import { schemaErrors } from './schemas.js';
+/** Files validate/index must not treat as category content. */
+export function excludedFromCategories(manifest) {
+    const profilesDir = manifest.machine?.agentProfilesPath;
+    return (relPath) => {
+        if (relPath === manifest.bootProfilePath)
+            return true;
+        if (profilesDir && underPath(relPath, profilesDir))
+            return true;
+        if (path.posix.basename(relPath).toLowerCase() === 'readme.md')
+            return true;
+        return false;
+    };
+}
+/**
+ * Collect category documents. A file matched by several category paths is
+ * assigned once: longest declared path wins, manifest order breaks ties.
+ */
+export function scanCategories(root, manifest) {
+    const excluded = excludedFromCategories(manifest);
+    const byFile = new Map();
+    for (const category of CATEGORY_IDS) {
+        const mapping = manifest.categories[category];
+        if (!mapping)
+            continue;
+        for (const declared of mapping.paths) {
+            for (const relPath of walkMd(root, declared)) {
+                if (excluded(relPath))
+                    continue;
+                const prev = byFile.get(relPath);
+                if (!prev || declared.length > prev.declaredLen) {
+                    byFile.set(relPath, { category, declaredLen: declared.length });
+                }
+            }
+        }
+    }
+    const docs = [];
+    for (const [relPath, { category }] of [...byFile.entries()].sort(([a], [b]) => (a < b ? -1 : 1))) {
+        const text = readText(path.join(root, relPath));
+        const fm = parseFrontmatter(text);
+        docs.push({ relPath, category, frontmatter: fm.data, body: fm.body });
+    }
+    return docs;
+}
+function scanFrontmatterArtifacts(root, dir, schemaName, rule) {
+    const out = [];
+    for (const relPath of walkMd(root, dir)) {
+        if (path.posix.basename(relPath).toLowerCase() === 'readme.md')
+            continue;
+        const text = readText(path.join(root, relPath));
+        const fm = parseFrontmatter(text);
+        const findings = [];
+        if (fm.error) {
+            findings.push(finding(rule, 'error', fm.error, relPath));
+        }
+        else if (!fm.data) {
+            findings.push(finding(rule, 'error', 'missing YAML frontmatter', relPath));
+        }
+        else {
+            for (const err of schemaErrors(schemaName, fm.data)) {
+                findings.push(finding(rule, 'error', err, relPath));
+            }
+        }
+        out.push({ relPath, frontmatter: fm.data, findings });
+    }
+    return out;
+}
+export function scanAgentProfiles(root, manifest) {
+    const dir = manifest.machine?.agentProfilesPath;
+    if (!dir)
+        return [];
+    return scanFrontmatterArtifacts(root, dir, 'agent-profile', 'profile-frontmatter');
+}
+export function scanDecisionRecords(root, manifest) {
+    // Scan the declared records path and every mapped decisions path; a layer
+    // may map several and valid records can live in any of them.
+    const dirs = new Set();
+    if (manifest.machine?.decisionRecordsPath)
+        dirs.add(manifest.machine.decisionRecordsPath);
+    for (const p of manifest.categories.decisions?.paths ?? [])
+        dirs.add(p);
+    const seen = new Set();
+    const out = [];
+    for (const dir of dirs) {
+        for (const scanned of scanFrontmatterArtifacts(root, dir, 'decision-record', 'decision-frontmatter')) {
+            if (seen.has(scanned.relPath))
+                continue;
+            seen.add(scanned.relPath);
+            out.push(scanned);
+        }
+    }
+    return out;
+}
+/** Duplicate-id findings across a set of artifacts that carry an `id`. */
+export function duplicateIdFindings(items, scope) {
+    const seen = new Map();
+    const findings = [];
+    for (const { id, relPath } of items) {
+        if (typeof id !== 'string' || id === '')
+            continue;
+        const first = seen.get(id);
+        if (first !== undefined && first !== relPath) {
+            findings.push(finding('id-duplicate', 'error', `${scope} id "${id}" already used by ${first}`, relPath));
+        }
+        else {
+            seen.set(id, relPath);
+        }
+    }
+    return findings;
+}
+/** Read a declared JSON artifact; returns parsed value or a finding. */
+export function readJsonArtifact(root, relPath) {
+    const abs = path.join(root, relPath);
+    if (!isFile(abs)) {
+        return { data: null };
+    }
+    if (!realpathWithin(path.resolve(root), abs)) {
+        return {
+            data: null,
+            finding: finding('artifact-parse', 'error', `artifact ${relPath} resolves outside the layer root`, relPath),
+        };
+    }
+    try {
+        return { data: JSON.parse(readText(abs)) };
+    }
+    catch (e) {
+        return {
+            data: null,
+            finding: finding('artifact-parse', 'error', `invalid JSON: ${e.message}`, relPath),
+        };
+    }
+}
+//# sourceMappingURL=layer.js.map

package/dist/lib/layer.js.map

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

package/dist/lib/manifest.d.ts

@@ -0,0 +1,62 @@
+import { type Finding } from './findings.js';
+export declare const CATEGORY_IDS: readonly ["domain", "system", "practice", "governance", "decisions"];
+export type CategoryId = (typeof CATEGORY_IDS)[number];
+export declare const CONFORMANCE_LEVELS: readonly ["core", "indexed", "governed", "federated"];
+export type ConformanceLevel = (typeof CONFORMANCE_LEVELS)[number];
+export interface Owner {
+    name: string;
+    contact?: string;
+}
+export interface Manifest {
+    $schema?: string;
+    leji: string;
+    name: string;
+    description?: string;
+    rootPath: string;
+    bootProfilePath: string;
+    categories: Partial<Record<CategoryId, {
+        paths: string[];
+    }>>;
+    machine?: {
+        indexPath?: string;
+        changelogPath?: string;
+        agentProfilesPath?: string;
+        decisionRecordsPath?: string;
+    };
+    agents?: Record<string, string>;
+    docs?: {
+        port?: number;
+    };
+    owners: {
+        primary: Owner;
+        continuity?: Owner;
+    };
+    conformance?: {
+        claimedLevel?: ConformanceLevel;
+        claimedAt?: string;
+    };
+    federation?: {
+        mounts?: {
+            path: string;
+            name: string;
+            owner: Owner;
+            role?: string;
+            source?: string;
+        }[];
+    };
+    vendorAdapters?: string[];
+}
+export interface ManifestLoad {
+    manifest: Manifest | null;
+    findings: Finding[];
+}
+export declare const MANIFEST_FILENAME = "leji.json";
+/**
+ * Load and structurally validate leji.json at the repository root: existence,
+ * JSON parse, declared spec line, manifest schema. Content-level checks
+ * (paths existing, categories populated) live in the validate command.
+ */
+export declare function loadManifest(root: string): ManifestLoad;
+/** Effective conformance claim: absent claim is treated as core. */
+export declare function claimedLevel(manifest: Manifest): ConformanceLevel;
+export declare function levelAtLeast(level: ConformanceLevel, threshold: ConformanceLevel): boolean;

package/dist/lib/manifest.js

@@ -0,0 +1,54 @@
+import * as path from 'node:path';
+import { finding } from './findings.js';
+import { exists, isFile, readText } from './fsx.js';
+import { SUPPORTED_LINES, schemaErrors } from './schemas.js';
+export const CATEGORY_IDS = ['domain', 'system', 'practice', 'governance', 'decisions'];
+export const CONFORMANCE_LEVELS = ['core', 'indexed', 'governed', 'federated'];
+export const MANIFEST_FILENAME = 'leji.json';
+/**
+ * Load and structurally validate leji.json at the repository root: existence,
+ * JSON parse, declared spec line, manifest schema. Content-level checks
+ * (paths existing, categories populated) live in the validate command.
+ */
+export function loadManifest(root) {
+    const abs = path.join(root, MANIFEST_FILENAME);
+    if (!exists(abs) || !isFile(abs)) {
+        return {
+            manifest: null,
+            findings: [
+                finding('manifest-missing', 'error', `no ${MANIFEST_FILENAME} at the repository root`, MANIFEST_FILENAME),
+            ],
+        };
+    }
+    let data;
+    try {
+        data = JSON.parse(readText(abs));
+    }
+    catch (e) {
+        return {
+            manifest: null,
+            findings: [finding('manifest-parse', 'error', `invalid JSON: ${e.message}`, MANIFEST_FILENAME)],
+        };
+    }
+    const findings = [];
+    const line = data?.leji;
+    if (typeof line === 'string' && /^\d+\.\d+$/.test(line) && !SUPPORTED_LINES.includes(line)) {
+        findings.push(finding('manifest-line', 'error', `declared spec line "${line}" is not supported by this SDK (supported: ${SUPPORTED_LINES.join(', ')})`, MANIFEST_FILENAME));
+        return { manifest: null, findings };
+    }
+    for (const err of schemaErrors('context-manifest', data)) {
+        findings.push(finding('manifest-schema', 'error', err, MANIFEST_FILENAME));
+    }
+    if (findings.some((f) => f.rule === 'manifest-schema')) {
+        return { manifest: null, findings };
+    }
+    return { manifest: data, findings };
+}
+/** Effective conformance claim: absent claim is treated as core. */
+export function claimedLevel(manifest) {
+    return manifest.conformance?.claimedLevel ?? 'core';
+}
+export function levelAtLeast(level, threshold) {
+    return CONFORMANCE_LEVELS.indexOf(level) >= CONFORMANCE_LEVELS.indexOf(threshold);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/lib/manifest.js.map

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

package/dist/lib/schemas.d.ts

@@ -0,0 +1,38 @@
+import { type ValidateFunction } from 'ajv/dist/2020.js';
+/** Spec lines this SDK supports (versioning.md: validate against the declared line). */
+export declare const SUPPORTED_LINES: string[];
+export type SchemaName = 'context-manifest' | 'context-index' | 'context-changelog' | 'agent-profile' | 'decision-record';
+export declare const SDK_VERSION: string;
+/** Directory holding the vendored schema files for a spec line. */
+export declare function schemasDir(): string;
+/** Directory holding the vendored templates. */
+export declare function templatesDir(): string;
+export interface CliOption {
+    flags: string;
+    summary: string;
+}
+export interface CliCommand {
+    name: string;
+    summary: string;
+    usage: string;
+    description: string;
+    options: CliOption[];
+    examples: string[];
+}
+export interface CliSpec {
+    name: string;
+    summary: string;
+    usage: string;
+    globalOptions: CliOption[];
+    exitCodes: {
+        code: number;
+        meaning: string;
+    }[];
+    commands: CliCommand[];
+}
+/** The canonical CLI description, single-sourced from cli.json. The terminal
+ * help and the docs site both render from this. */
+export declare function loadCliSpec(): CliSpec;
+export declare function getValidator(name: SchemaName): ValidateFunction;
+/** Validate data against a vendored schema; returns human-readable error strings. */
+export declare function schemaErrors(name: SchemaName, data: unknown): string[];

package/dist/lib/schemas.js

@@ -0,0 +1,57 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Ajv2020 } from 'ajv/dist/2020.js';
+/** Spec lines this SDK supports (versioning.md: validate against the declared line). */
+export const SUPPORTED_LINES = ['1.0'];
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
+function readSdkVersion() {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
+        return typeof pkg.version === 'string' && pkg.version ? pkg.version : '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+export const SDK_VERSION = readSdkVersion();
+/** Directory holding the vendored schema files for a spec line. */
+export function schemasDir() {
+    return path.join(packageRoot, 'schemas');
+}
+/** Directory holding the vendored templates. */
+export function templatesDir() {
+    return path.join(packageRoot, 'templates');
+}
+/** The canonical CLI description, single-sourced from cli.json. The terminal
+ * help and the docs site both render from this. */
+export function loadCliSpec() {
+    return JSON.parse(fs.readFileSync(path.join(packageRoot, 'cli.json'), 'utf8'));
+}
+const ajv = new Ajv2020({ allErrors: true, strict: false, validateFormats: false });
+const cache = new Map();
+export function getValidator(name) {
+    let v = cache.get(name);
+    if (!v) {
+        const schema = JSON.parse(fs.readFileSync(path.join(schemasDir(), `${name}.schema.json`), 'utf8'));
+        v = ajv.compile(schema);
+        cache.set(name, v);
+    }
+    return v;
+}
+/** Validate data against a vendored schema; returns human-readable error strings. */
+export function schemaErrors(name, data) {
+    const v = getValidator(name);
+    if (v(data))
+        return [];
+    return ((v.errors ?? [])
+        // Ajv reports conditional (if/then) failures twice: the inner error plus
+        // a "must match then schema" wrapper. Drop the wrapper for finding-count
+        // parity with the Python SDK's jsonschema.
+        .filter((e) => e.keyword !== 'if')
+        .map((e) => {
+        const where = e.instancePath === '' ? '(root)' : e.instancePath;
+        return `${where} ${e.message ?? 'invalid'}`;
+    }));
+}
+//# sourceMappingURL=schemas.js.map

package/dist/lib/schemas.js.map

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

package/package.json

@@ -0,0 +1,61 @@
+{
+   "name": "@leji-org/leji",
+   "version": "1.0.0",
+   "description": "Reference SDK and CLI for Leji, the open specification for the shared context layer of AI-native teams: validate, index, changelog, freshness, conformance, and init.",
+   "keywords": [
+      "leji",
+      "ai-native",
+      "ai-native-teams",
+      "context-layer",
+      "shared-context",
+      "agent-context",
+      "ai-agents",
+      "governance",
+      "specification",
+      "validation",
+      "cli"
+   ],
+   "homepage": "https://leji.org",
+   "repository": {
+      "type": "git",
+      "url": "git+https://github.com/leji-org/leji.git",
+      "directory": "packages/sdk"
+   },
+   "author": "Vuong Nguyen (https://vuongnguyen.com)",
+   "license": "Apache-2.0",
+   "type": "module",
+   "engines": {
+      "node": ">=22"
+   },
+   "bin": {
+      "leji": "dist/cli.js"
+   },
+   "main": "./dist/index.js",
+   "types": "./dist/index.d.ts",
+   "exports": {
+      ".": "./dist/index.js"
+   },
+   "files": [
+      "dist",
+      "schemas",
+      "templates",
+      "assets-manifest.json",
+      "cli.json"
+   ],
+   "scripts": {
+      "build": "tsc",
+      "pretest": "npm run build",
+      "test": "node --test",
+      "coverage": "npm run build && c8 --reporter=text --include='dist/**/*.js' --all node --test",
+      "validate": "node ./dist/cli.js validate"
+   },
+   "dependencies": {
+      "ajv": "8.20.0",
+      "yaml": "2.9.0"
+   },
+   "devDependencies": {
+      "@types/node": "25.9.3",
+      "c8": "11.0.0",
+      "typescript": "6.0.3"
+   }
+}

package/schemas/README.md

@@ -0,0 +1,3 @@
+# Schemas
+
+JSON Schemas (draft 2020-12) for the machine-readable surface. Normative; see spec/machine-readable-surface.md and spec/versioning.md for the stability rules. Each schema is self-contained and carries a stable $id on the https://leji.org/schemas/v1.0/ line.

package/schemas/agent-profile.schema.json

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://leji.org/schemas/v1.0/agent-profile.schema.json",
+  "title": "Leji agent profile frontmatter",
+  "description": "Validates the YAML frontmatter of an agent profile document. The markdown body stays free-form.",
+  "type": "object",
+  "required": [
+    "id",
+    "name",
+    "role",
+    "requiredRead",
+    "mustAskWhen"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "description": "Stable identifier for this profile, e.g. \"core\" or \"reviewer\".",
+      "type": "string",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+    },
+    "name": {
+      "description": "Human-readable name of the role.",
+      "type": "string",
+      "minLength": 1
+    },
+    "role": {
+      "description": "The role identifier this profile fills, bound in the manifest's agents map.",
+      "type": "string",
+      "minLength": 1
+    },
+    "purpose": {
+      "description": "One line on what this role is for.",
+      "type": "string"
+    },
+    "version": {
+      "description": "Optional version of this profile.",
+      "type": "string"
+    },
+    "inherits": {
+      "type": "string",
+      "description": "id of the profile this one extends, typically the core profile."
+    },
+    "requiredRead": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "pattern": "^(?!/)(?!\\./)(?!.*(^|/)\\.\\.(/|$))(?!.*\\\\).+$"
+      },
+      "description": "Paths this role loads before any task."
+    },
+    "defaultContext": {
+      "type": "array",
+      "items": {
+        "enum": [
+          "domain",
+          "system",
+          "practice",
+          "governance",
+          "decisions"
+        ]
+      },
+      "description": "Categories this role loads by default."
+    },
+    "mustAskWhen": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string"
+      },
+      "description": "Conditions under which the role must stop and ask a human."
+    },
+    "mustRefuseWhen": {
+      "description": "Conditions under which the role must refuse outright rather than ask.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "escalation": {
+      "type": "string",
+      "description": "Who or what to escalate to."
+    },
+    "owners": {
+      "description": "Optional owners of this profile.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "freshness": {
+      "description": "Review horizon for this profile.",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "reviewAfter": {
+          "description": "ISO 8601 date after which the profile should be reviewed for staleness.",
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+        }
+      }
+    },
+    "host": {
+      "type": "string",
+      "description": "The agent host that runs this agent, e.g. \"claude-code\", \"codex\", \"cursor\". Omit for host-agnostic profiles."
+    },
+    "invocation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "command"
+      ],
+      "properties": {
+        "command": {
+          "type": "string",
+          "description": "Command template to engage this agent from a shell, with <prompt> as the placeholder."
+        },
+        "constraints": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Operational constraints worth machine-knowing, e.g. prompt length limits, timeouts."
+        }
+      },
+      "description": "How to engage this agent as an external CLI. Omit for the host's own resident agent."
+    }
+  }
+}