@fractary/codex 0.1.0

package/dist/index.js

@@ -0,0 +1,388 @@
+import { z } from 'zod';
+import yaml from 'js-yaml';
+import { isMatch } from 'micromatch';
+
+// src/errors/CodexError.ts
+var CodexError = class _CodexError extends Error {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "CodexError";
+    Object.setPrototypeOf(this, _CodexError.prototype);
+  }
+};
+
+// src/errors/ConfigurationError.ts
+var ConfigurationError = class _ConfigurationError extends CodexError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ConfigurationError";
+    Object.setPrototypeOf(this, _ConfigurationError.prototype);
+  }
+};
+
+// src/errors/ValidationError.ts
+var ValidationError = class _ValidationError extends CodexError {
+  constructor(message, options) {
+    super(message, options);
+    this.name = "ValidationError";
+    Object.setPrototypeOf(this, _ValidationError.prototype);
+  }
+};
+var MetadataSchema = z.object({
+  // Organizational
+  org: z.string().optional(),
+  system: z.string().optional(),
+  // Sync rules
+  codex_sync_include: z.array(z.string()).optional(),
+  codex_sync_exclude: z.array(z.string()).optional(),
+  // Metadata
+  title: z.string().optional(),
+  description: z.string().optional(),
+  visibility: z.enum(["public", "internal", "private"]).optional(),
+  audience: z.array(z.string()).optional(),
+  tags: z.array(z.string()).optional(),
+  // Timestamps
+  created: z.string().optional(),
+  // ISO 8601 date string
+  updated: z.string().optional()
+}).passthrough();
+var AutoSyncPatternSchema = z.object({
+  pattern: z.string(),
+  include: z.array(z.string()),
+  exclude: z.array(z.string()).optional()
+});
+var SyncRulesSchema = z.object({
+  autoSyncPatterns: z.array(AutoSyncPatternSchema).optional(),
+  preventSelfSync: z.boolean().optional(),
+  preventCodexSync: z.boolean().optional(),
+  allowProjectOverrides: z.boolean().optional(),
+  defaultInclude: z.array(z.string()).optional(),
+  defaultExclude: z.array(z.string()).optional()
+});
+var CodexConfigSchema = z.object({
+  organizationSlug: z.string(),
+  directories: z.object({
+    source: z.string().optional(),
+    target: z.string().optional(),
+    systems: z.string().optional()
+  }).optional(),
+  rules: SyncRulesSchema.optional()
+}).strict();
+function parseMetadata(content, options = {}) {
+  const { strict = true, normalize = true } = options;
+  const normalizedContent = normalize ? content.replace(/\r\n/g, "\n") : content;
+  const frontmatterMatch = normalizedContent.match(
+    /^---\n([\s\S]*?)\n---\n([\s\S]*)$/
+  );
+  if (!frontmatterMatch) {
+    return {
+      metadata: {},
+      content: normalizedContent,
+      raw: ""
+    };
+  }
+  const rawFrontmatter = frontmatterMatch[1];
+  const documentContent = frontmatterMatch[2];
+  try {
+    const parsed = yaml.load(rawFrontmatter);
+    const normalized = normalizeLegacyMetadata(parsed);
+    const metadata = strict ? MetadataSchema.parse(normalized) : MetadataSchema.safeParse(normalized).data || {};
+    return {
+      metadata,
+      content: documentContent,
+      raw: rawFrontmatter
+    };
+  } catch (error) {
+    if (strict) {
+      throw new ValidationError(
+        `Invalid frontmatter: ${error instanceof Error ? error.message : String(error)}`,
+        { cause: error }
+      );
+    }
+    return {
+      metadata: {},
+      content: documentContent,
+      raw: rawFrontmatter
+    };
+  }
+}
+function normalizeLegacyMetadata(parsed) {
+  const normalized = { ...parsed };
+  if (parsed.codex?.includes && !parsed.codex_sync_include) {
+    normalized.codex_sync_include = parsed.codex.includes;
+  }
+  if (parsed.codex?.excludes && !parsed.codex_sync_exclude) {
+    normalized.codex_sync_exclude = parsed.codex.excludes;
+  }
+  return normalized;
+}
+function hasFrontmatter(content) {
+  const normalized = content.replace(/\r\n/g, "\n");
+  return /^---\n[\s\S]*?\n---\n/.test(normalized);
+}
+function validateMetadata(metadata) {
+  const result = MetadataSchema.safeParse(metadata);
+  if (result.success) {
+    return { valid: true };
+  }
+  return {
+    valid: false,
+    errors: result.error.issues.map((issue) => issue.message)
+  };
+}
+function extractRawFrontmatter(content) {
+  const normalized = content.replace(/\r\n/g, "\n");
+  const match = normalized.match(/^---\n([\s\S]*?)\n---\n/);
+  return match && match[1] ? match[1] : null;
+}
+function matchPattern(pattern, value) {
+  if (pattern === value) return true;
+  return isMatch(value, pattern);
+}
+function matchAnyPattern(patterns, value) {
+  if (patterns.length === 1 && patterns[0] === "*") {
+    return true;
+  }
+  if (patterns.length === 0) {
+    return false;
+  }
+  return patterns.some((pattern) => matchPattern(pattern, value));
+}
+function filterByPatterns(patterns, values) {
+  return values.filter((value) => matchAnyPattern(patterns, value));
+}
+function evaluatePatterns(options) {
+  const { value, include = [], exclude = [] } = options;
+  if (exclude.length > 0 && matchAnyPattern(exclude, value)) {
+    return false;
+  }
+  if (include.length === 0) {
+    return true;
+  }
+  return matchAnyPattern(include, value);
+}
+
+// src/core/config/organization.ts
+function resolveOrganization(options = {}) {
+  const { orgSlug, repoName, autoDetect = true } = options;
+  if (orgSlug) {
+    return orgSlug;
+  }
+  if (autoDetect && repoName) {
+    const detected = extractOrgFromRepoName(repoName);
+    if (detected) {
+      return detected;
+    }
+  }
+  const envOrg = process.env["ORGANIZATION_SLUG"] || process.env["CODEX_ORG_SLUG"];
+  if (envOrg) {
+    return envOrg;
+  }
+  throw new ConfigurationError(
+    "Organization slug could not be determined. Set ORGANIZATION_SLUG environment variable or pass orgSlug option."
+  );
+}
+function extractOrgFromRepoName(repoName) {
+  const match = repoName.match(/^codex\.([^.]+)\.[^.]+$/);
+  if (match && match[1]) {
+    return match[1];
+  }
+  return null;
+}
+
+// src/core/config/defaults.ts
+function getDefaultDirectories(orgSlug) {
+  return {
+    source: `.${orgSlug}`,
+    target: `.${orgSlug}`,
+    systems: `.${orgSlug}/systems`
+  };
+}
+function getDefaultRules() {
+  return {
+    autoSyncPatterns: [],
+    preventSelfSync: true,
+    preventCodexSync: true,
+    allowProjectOverrides: true,
+    defaultInclude: [],
+    defaultExclude: []
+  };
+}
+function getDefaultConfig(orgSlug) {
+  return {
+    organizationSlug: orgSlug,
+    directories: getDefaultDirectories(orgSlug),
+    rules: getDefaultRules()
+  };
+}
+
+// src/core/config/loader.ts
+function loadConfig(options = {}) {
+  const orgSlug = resolveOrganization({
+    orgSlug: options.organizationSlug,
+    repoName: options.repoName
+  });
+  let config = {
+    organizationSlug: orgSlug,
+    directories: getDefaultDirectories(orgSlug),
+    rules: getDefaultRules()
+  };
+  const envConfig = loadConfigFromEnv(options.env || process.env);
+  config = mergeConfigs(config, envConfig);
+  return CodexConfigSchema.parse(config);
+}
+function loadConfigFromEnv(env) {
+  const config = {};
+  if (env["ORGANIZATION_SLUG"] || env["CODEX_ORG_SLUG"]) {
+    config.organizationSlug = env["ORGANIZATION_SLUG"] || env["CODEX_ORG_SLUG"];
+  }
+  if (env["CODEX_SOURCE_DIR"] || env["CODEX_TARGET_DIR"]) {
+    config.directories = {
+      source: env["CODEX_SOURCE_DIR"],
+      target: env["CODEX_TARGET_DIR"]
+    };
+  }
+  const rules = {};
+  if (env["CODEX_PREVENT_SELF_SYNC"] !== void 0) {
+    rules.preventSelfSync = env["CODEX_PREVENT_SELF_SYNC"] === "true";
+  }
+  if (env["CODEX_PREVENT_CODEX_SYNC"] !== void 0) {
+    rules.preventCodexSync = env["CODEX_PREVENT_CODEX_SYNC"] === "true";
+  }
+  if (env["CODEX_ALLOW_PROJECT_OVERRIDES"] !== void 0) {
+    rules.allowProjectOverrides = env["CODEX_ALLOW_PROJECT_OVERRIDES"] === "true";
+  }
+  if (Object.keys(rules).length > 0) {
+    config.rules = rules;
+  }
+  return config;
+}
+function mergeConfigs(base, override) {
+  return {
+    organizationSlug: override.organizationSlug ?? base.organizationSlug,
+    directories: {
+      ...base.directories,
+      ...override.directories
+    },
+    rules: {
+      ...base.rules,
+      ...override.rules,
+      // Arrays are replaced, not merged
+      autoSyncPatterns: override.rules?.autoSyncPatterns ?? base.rules?.autoSyncPatterns,
+      defaultInclude: override.rules?.defaultInclude ?? base.rules?.defaultInclude,
+      defaultExclude: override.rules?.defaultExclude ?? base.rules?.defaultExclude
+    }
+  };
+}
+
+// src/core/routing/evaluator.ts
+function shouldSyncToRepo(options) {
+  const {
+    filePath,
+    fileMetadata,
+    targetRepo,
+    sourceRepo,
+    rules = getDefaultRules()
+  } = options;
+  const specialRuleResult = evaluateSpecialRules({
+    filePath,
+    targetRepo,
+    sourceRepo,
+    rules
+  });
+  if (specialRuleResult !== null) {
+    return specialRuleResult;
+  }
+  return evaluateFrontmatterRules({
+    metadata: fileMetadata,
+    targetRepo,
+    allowOverrides: rules.allowProjectOverrides ?? true
+  });
+}
+function evaluateSpecialRules(options) {
+  const { filePath, targetRepo, sourceRepo, rules } = options;
+  if (rules.autoSyncPatterns?.length) {
+    const autoSyncResult = evaluateAutoSyncPatterns(
+      filePath,
+      targetRepo,
+      rules.autoSyncPatterns
+    );
+    if (autoSyncResult !== null) {
+      return autoSyncResult;
+    }
+  }
+  if (rules.preventSelfSync) {
+    const selfSyncResult = preventSelfSync(filePath, targetRepo);
+    if (selfSyncResult !== null) {
+      return selfSyncResult;
+    }
+  }
+  if (rules.preventCodexSync) {
+    const codexSyncResult = preventCodexSync(targetRepo, sourceRepo);
+    if (codexSyncResult !== null) {
+      return codexSyncResult;
+    }
+  }
+  return null;
+}
+function evaluateAutoSyncPatterns(filePath, targetRepo, patterns) {
+  for (const autoPattern of patterns) {
+    if (matchPattern(autoPattern.pattern, filePath)) {
+      return evaluatePatterns({
+        value: targetRepo,
+        include: autoPattern.include,
+        ...autoPattern.exclude && { exclude: autoPattern.exclude }
+      });
+    }
+  }
+  return null;
+}
+function preventSelfSync(filePath, targetRepo, _sourceRepo) {
+  const systemMatch = filePath.match(/systems\/([^/]+)\//);
+  if (systemMatch && systemMatch[1]) {
+    const systemName = systemMatch[1];
+    if (systemName === targetRepo) {
+      return false;
+    }
+  }
+  return null;
+}
+function preventCodexSync(targetRepo, sourceRepo) {
+  const isCodexRepo = targetRepo === sourceRepo || targetRepo.startsWith("codex.");
+  if (isCodexRepo) {
+    return false;
+  }
+  return null;
+}
+function evaluateFrontmatterRules(options) {
+  const { metadata, targetRepo, allowOverrides } = options;
+  if (!allowOverrides) {
+    return false;
+  }
+  const include = metadata.codex_sync_include || [];
+  const exclude = metadata.codex_sync_exclude || [];
+  if (include.length === 0) {
+    return false;
+  }
+  return evaluatePatterns({
+    value: targetRepo,
+    include,
+    exclude
+  });
+}
+function getTargetRepos(options) {
+  const { filePath, fileMetadata, sourceRepo, allRepos, rules } = options;
+  return allRepos.filter(
+    (targetRepo) => shouldSyncToRepo({
+      filePath,
+      fileMetadata,
+      targetRepo,
+      sourceRepo,
+      ...rules && { rules }
+    })
+  );
+}
+
+export { AutoSyncPatternSchema, CodexConfigSchema, CodexError, ConfigurationError, MetadataSchema, SyncRulesSchema, ValidationError, evaluatePatterns, extractOrgFromRepoName, extractRawFrontmatter, filterByPatterns, getDefaultConfig, getDefaultDirectories, getDefaultRules, getTargetRepos, hasFrontmatter, loadConfig, matchAnyPattern, matchPattern, parseMetadata, resolveOrganization, shouldSyncToRepo, validateMetadata };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/CodexError.ts","../src/errors/ConfigurationError.ts","../src/errors/ValidationError.ts","../src/schemas/metadata.ts","../src/schemas/config.ts","../src/core/metadata/parser.ts","../src/core/patterns/matcher.ts","../src/core/config/organization.ts","../src/core/config/defaults.ts","../src/core/config/loader.ts","../src/core/routing/evaluator.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Base error class for all Codex SDK errors\n */\nexport class CodexError extends Error {\n  constructor(\n    message: string,\n    options?: ErrorOptions\n  ) {\n    super(message, options)\n    this.name = 'CodexError'\n    Object.setPrototypeOf(this, CodexError.prototype)\n  }\n}\n","import { CodexError } from './CodexError.js'\n\n/**\n * Error thrown when configuration is missing or invalid\n */\nexport class ConfigurationError extends CodexError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options)\n    this.name = 'ConfigurationError'\n    Object.setPrototypeOf(this, ConfigurationError.prototype)\n  }\n}\n","import { CodexError } from './CodexError.js'\n\n/**\n * Error thrown when data validation fails\n */\nexport class ValidationError extends CodexError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options)\n    this.name = 'ValidationError'\n    Object.setPrototypeOf(this, ValidationError.prototype)\n  }\n}\n","import { z } from 'zod'\n\n/**\n * Schema for document frontmatter metadata\n *\n * Based on SPEC-00002: Metadata Parsing\n */\nexport const MetadataSchema = z\n  .object({\n    // Organizational\n    org: z.string().optional(),\n    system: z.string().optional(),\n\n    // Sync rules\n    codex_sync_include: z.array(z.string()).optional(),\n    codex_sync_exclude: z.array(z.string()).optional(),\n\n    // Metadata\n    title: z.string().optional(),\n    description: z.string().optional(),\n    visibility: z.enum(['public', 'internal', 'private']).optional(),\n    audience: z.array(z.string()).optional(),\n    tags: z.array(z.string()).optional(),\n\n    // Timestamps\n    created: z.string().optional(), // ISO 8601 date string\n    updated: z.string().optional(),\n  })\n  .passthrough() // Allow additional fields for extensibility\n\nexport type Metadata = z.infer<typeof MetadataSchema>\n","import { z } from 'zod'\n\n/**\n * Schema for auto-sync patterns\n *\n * Based on SPEC-00004: Routing & Distribution\n */\nexport const AutoSyncPatternSchema = z.object({\n  pattern: z.string(),\n  include: z.array(z.string()),\n  exclude: z.array(z.string()).optional(),\n})\n\nexport type AutoSyncPattern = z.infer<typeof AutoSyncPatternSchema>\n\n/**\n * Schema for sync rules configuration\n *\n * Based on SPEC-00004: Routing & Distribution\n */\nexport const SyncRulesSchema = z.object({\n  autoSyncPatterns: z.array(AutoSyncPatternSchema).optional(),\n  preventSelfSync: z.boolean().optional(),\n  preventCodexSync: z.boolean().optional(),\n  allowProjectOverrides: z.boolean().optional(),\n  defaultInclude: z.array(z.string()).optional(),\n  defaultExclude: z.array(z.string()).optional(),\n})\n\nexport type SyncRules = z.infer<typeof SyncRulesSchema>\n\n/**\n * Schema for Codex configuration\n *\n * Based on SPEC-00005: Configuration System\n */\nexport const CodexConfigSchema = z\n  .object({\n    organizationSlug: z.string(),\n\n    directories: z\n      .object({\n        source: z.string().optional(),\n        target: z.string().optional(),\n        systems: z.string().optional(),\n      })\n      .optional(),\n\n    rules: SyncRulesSchema.optional(),\n  })\n  .strict()\n\nexport type CodexConfig = z.infer<typeof CodexConfigSchema>\n","import yaml from 'js-yaml'\nimport { MetadataSchema, type Metadata } from '../../schemas/metadata.js'\nimport { ValidationError } from '../../errors/index.js'\n\nexport interface ParseMetadataOptions {\n  strict?: boolean // Throw on validation errors (default: true)\n  normalize?: boolean // Normalize line endings (default: true)\n}\n\nexport interface ParseResult {\n  metadata: Metadata\n  content: string // Document content without frontmatter\n  raw: string // Raw frontmatter block\n}\n\n/**\n * Extracts and parses YAML frontmatter from markdown content\n *\n * Based on SPEC-00002: Metadata Parsing\n *\n * @param content - Markdown file content\n * @param options - Parsing options\n * @returns Parsed metadata and content\n * @throws ValidationError if frontmatter is malformed (in strict mode)\n */\nexport function parseMetadata(\n  content: string,\n  options: ParseMetadataOptions = {}\n): ParseResult {\n  const { strict = true, normalize = true } = options\n\n  // Normalize line endings (CRLF → LF)\n  const normalizedContent = normalize\n    ? content.replace(/\\r\\n/g, '\\n')\n    : content\n\n  // Extract frontmatter block\n  const frontmatterMatch = normalizedContent.match(\n    /^---\\n([\\s\\S]*?)\\n---\\n([\\s\\S]*)$/\n  )\n\n  if (!frontmatterMatch) {\n    // No frontmatter found\n    return {\n      metadata: {},\n      content: normalizedContent,\n      raw: '',\n    }\n  }\n\n  const rawFrontmatter = frontmatterMatch[1]!\n  const documentContent = frontmatterMatch[2]!\n\n  try {\n    // Parse YAML\n    const parsed = yaml.load(rawFrontmatter) as Record<string, unknown>\n\n    // Normalize legacy formats\n    const normalized = normalizeLegacyMetadata(parsed)\n\n    // Validate against schema\n    const metadata = strict\n      ? MetadataSchema.parse(normalized)\n      : MetadataSchema.safeParse(normalized).data || {}\n\n    return {\n      metadata,\n      content: documentContent,\n      raw: rawFrontmatter,\n    }\n  } catch (error) {\n    if (strict) {\n      throw new ValidationError(\n        `Invalid frontmatter: ${error instanceof Error ? error.message : String(error)}`,\n        { cause: error }\n      )\n    }\n\n    // Non-strict mode: return empty metadata\n    return {\n      metadata: {},\n      content: documentContent,\n      raw: rawFrontmatter,\n    }\n  }\n}\n\n/**\n * Normalize legacy frontmatter formats to standard format\n *\n * Handles:\n * - Nested codex.includes → codex_sync_include\n * - Nested codex.excludes → codex_sync_exclude\n */\nfunction normalizeLegacyMetadata(parsed: any): any {\n  const normalized: any = { ...parsed }\n\n  // Handle nested codex.includes → codex_sync_include\n  if (parsed.codex?.includes && !parsed.codex_sync_include) {\n    normalized.codex_sync_include = parsed.codex.includes\n  }\n\n  // Handle nested codex.excludes → codex_sync_exclude\n  if (parsed.codex?.excludes && !parsed.codex_sync_exclude) {\n    normalized.codex_sync_exclude = parsed.codex.excludes\n  }\n\n  return normalized\n}\n\n/**\n * Check if content has frontmatter\n */\nexport function hasFrontmatter(content: string): boolean {\n  const normalized = content.replace(/\\r\\n/g, '\\n')\n  return /^---\\n[\\s\\S]*?\\n---\\n/.test(normalized)\n}\n\n/**\n * Validate metadata without parsing content\n */\nexport function validateMetadata(\n  metadata: unknown\n): { valid: boolean; errors?: string[] } {\n  const result = MetadataSchema.safeParse(metadata)\n\n  if (result.success) {\n    return { valid: true }\n  }\n\n  return {\n    valid: false,\n    errors: result.error.issues.map(issue => issue.message),\n  }\n}\n\n/**\n * Extract only frontmatter (no validation)\n */\nexport function extractRawFrontmatter(content: string): string | null {\n  const normalized = content.replace(/\\r\\n/g, '\\n')\n  const match = normalized.match(/^---\\n([\\s\\S]*?)\\n---\\n/)\n  return match && match[1] ? match[1] : null\n}\n","import { isMatch } from 'micromatch'\n\n/**\n * Match a pattern against a value using glob syntax\n *\n * Based on SPEC-00003: Pattern Matching\n *\n * @param pattern - Glob pattern (e.g., \"api-*\", \"core-*\")\n * @param value - Value to test (e.g., \"api-gateway\")\n * @returns true if pattern matches value\n */\nexport function matchPattern(pattern: string, value: string): boolean {\n  // Special case: exact match\n  if (pattern === value) return true\n\n  // Use micromatch for glob pattern matching\n  return isMatch(value, pattern)\n}\n\n/**\n * Check if value matches any pattern in array\n *\n * @param patterns - Array of glob patterns\n * @param value - Value to test\n * @returns true if value matches any pattern\n */\nexport function matchAnyPattern(\n  patterns: string[],\n  value: string\n): boolean {\n  // Special case: [*] matches everything\n  if (patterns.length === 1 && patterns[0] === '*') {\n    return true\n  }\n\n  // Empty array matches nothing\n  if (patterns.length === 0) {\n    return false\n  }\n\n  // Check each pattern\n  return patterns.some(pattern => matchPattern(pattern, value))\n}\n\n/**\n * Filter values that match any pattern\n *\n * @param patterns - Array of glob patterns\n * @param values - Array of values to filter\n * @returns Values that match any pattern\n */\nexport function filterByPatterns(\n  patterns: string[],\n  values: string[]\n): string[] {\n  return values.filter(value => matchAnyPattern(patterns, value))\n}\n\n/**\n * Evaluate include/exclude rules\n *\n * @param options - Evaluation options\n * @returns true if value should be included\n */\nexport function evaluatePatterns(options: {\n  value: string\n  include?: string[]\n  exclude?: string[]\n}): boolean {\n  const { value, include = [], exclude = [] } = options\n\n  // Check exclusions first (exclusions take priority)\n  if (exclude.length > 0 && matchAnyPattern(exclude, value)) {\n    return false\n  }\n\n  // Check inclusions\n  if (include.length === 0) {\n    // No include patterns = include by default\n    return true\n  }\n\n  return matchAnyPattern(include, value)\n}\n","import { ConfigurationError } from '../../errors/index.js'\n\nexport interface ResolveOrgOptions {\n  orgSlug?: string // Explicit org slug\n  repoName?: string // Repo name for auto-detection\n  autoDetect?: boolean // Enable auto-detection (default: true)\n}\n\n/**\n * Resolve organization slug from multiple sources\n *\n * Based on SPEC-00005: Configuration System\n *\n * Priority:\n * 1. Explicit orgSlug parameter\n * 2. Auto-detect from repoName (if enabled)\n * 3. Environment variable (ORGANIZATION_SLUG or CODEX_ORG_SLUG)\n * 4. Throw ConfigurationError if none found\n *\n * @param options - Resolution options\n * @returns Organization slug\n * @throws ConfigurationError if slug cannot be determined\n */\nexport function resolveOrganization(\n  options: ResolveOrgOptions = {}\n): string {\n  const { orgSlug, repoName, autoDetect = true } = options\n\n  // 1. Explicit parameter\n  if (orgSlug) {\n    return orgSlug\n  }\n\n  // 2. Auto-detect from repo name\n  if (autoDetect && repoName) {\n    const detected = extractOrgFromRepoName(repoName)\n    if (detected) {\n      return detected\n    }\n  }\n\n  // 3. Environment variables\n  const envOrg =\n    process.env['ORGANIZATION_SLUG'] || process.env['CODEX_ORG_SLUG']\n\n  if (envOrg) {\n    return envOrg\n  }\n\n  // 4. Fail - required parameter missing\n  throw new ConfigurationError(\n    'Organization slug could not be determined. ' +\n      'Set ORGANIZATION_SLUG environment variable or pass orgSlug option.'\n  )\n}\n\n/**\n * Extract org slug from repo name pattern\n *\n * Patterns:\n * - codex.fractary.com → \"fractary\"\n * - codex.acme.ai → \"acme\"\n * - codex.my-org.io → \"my-org\"\n *\n * @param repoName - Repository name\n * @returns Organization slug or null if pattern doesn't match\n */\nexport function extractOrgFromRepoName(repoName: string): string | null {\n  // Pattern: codex.{org}.{tld}\n  const match = repoName.match(/^codex\\.([^.]+)\\.[^.]+$/)\n\n  if (match && match[1]) {\n    return match[1]\n  }\n\n  return null\n}\n","import type { CodexConfig, SyncRules } from '../../schemas/config.js'\n\n/**\n * Get default directory structure\n *\n * Based on SPEC-00005: Configuration System\n */\nexport function getDefaultDirectories(orgSlug: string) {\n  return {\n    source: `.${orgSlug}`,\n    target: `.${orgSlug}`,\n    systems: `.${orgSlug}/systems`,\n  }\n}\n\n/**\n * Get default sync rules\n *\n * Based on SPEC-00004: Routing & Distribution\n */\nexport function getDefaultRules(): SyncRules {\n  return {\n    autoSyncPatterns: [],\n    preventSelfSync: true,\n    preventCodexSync: true,\n    allowProjectOverrides: true,\n    defaultInclude: [],\n    defaultExclude: [],\n  }\n}\n\n/**\n * Get default configuration\n *\n * @param orgSlug - Organization slug\n * @returns Default CodexConfig\n */\nexport function getDefaultConfig(orgSlug: string): CodexConfig {\n  return {\n    organizationSlug: orgSlug,\n    directories: getDefaultDirectories(orgSlug),\n    rules: getDefaultRules(),\n  }\n}\n","import {\n  CodexConfigSchema,\n  type CodexConfig,\n  type SyncRules,\n} from '../../schemas/config.js'\nimport { resolveOrganization } from './organization.js'\nimport { getDefaultDirectories, getDefaultRules } from './defaults.js'\n\nexport interface LoadConfigOptions {\n  organizationSlug?: string\n  repoName?: string\n  env?: Record<string, string | undefined> // Environment variables (default: process.env)\n}\n\n/**\n * Load and resolve configuration from all sources\n *\n * Based on SPEC-00005: Configuration System\n *\n * @param options - Loading options\n * @returns Fully resolved configuration\n */\nexport function loadConfig(options: LoadConfigOptions = {}): CodexConfig {\n  // 1. Resolve organization slug\n  const orgSlug = resolveOrganization({\n    orgSlug: options.organizationSlug,\n    repoName: options.repoName,\n  })\n\n  // 2. Build base config with defaults\n  let config: Partial<CodexConfig> = {\n    organizationSlug: orgSlug,\n    directories: getDefaultDirectories(orgSlug),\n    rules: getDefaultRules(),\n  }\n\n  // 3. Apply environment variable overrides\n  const envConfig = loadConfigFromEnv(options.env || process.env)\n  config = mergeConfigs(config, envConfig)\n\n  // 4. Validate final configuration\n  return CodexConfigSchema.parse(config)\n}\n\n/**\n * Load configuration from environment variables\n */\nfunction loadConfigFromEnv(\n  env: Record<string, string | undefined>\n): Partial<CodexConfig> {\n  const config: Partial<CodexConfig> = {}\n\n  // Organization\n  if (env['ORGANIZATION_SLUG'] || env['CODEX_ORG_SLUG']) {\n    config.organizationSlug = env['ORGANIZATION_SLUG'] || env['CODEX_ORG_SLUG']\n  }\n\n  // Directories\n  if (env['CODEX_SOURCE_DIR'] || env['CODEX_TARGET_DIR']) {\n    config.directories = {\n      source: env['CODEX_SOURCE_DIR'],\n      target: env['CODEX_TARGET_DIR'],\n    }\n  }\n\n  // Rules\n  const rules: Partial<SyncRules> = {}\n\n  if (env['CODEX_PREVENT_SELF_SYNC'] !== undefined) {\n    rules.preventSelfSync = env['CODEX_PREVENT_SELF_SYNC'] === 'true'\n  }\n\n  if (env['CODEX_PREVENT_CODEX_SYNC'] !== undefined) {\n    rules.preventCodexSync = env['CODEX_PREVENT_CODEX_SYNC'] === 'true'\n  }\n\n  if (env['CODEX_ALLOW_PROJECT_OVERRIDES'] !== undefined) {\n    rules.allowProjectOverrides =\n      env['CODEX_ALLOW_PROJECT_OVERRIDES'] === 'true'\n  }\n\n  if (Object.keys(rules).length > 0) {\n    config.rules = rules\n  }\n\n  return config\n}\n\n/**\n * Deep merge two configuration objects\n * Later config overrides earlier config\n */\nfunction mergeConfigs(\n  base: Partial<CodexConfig>,\n  override: Partial<CodexConfig>\n): Partial<CodexConfig> {\n  return {\n    organizationSlug: override.organizationSlug ?? base.organizationSlug,\n\n    directories: {\n      ...base.directories,\n      ...override.directories,\n    },\n\n    rules: {\n      ...base.rules,\n      ...override.rules,\n\n      // Arrays are replaced, not merged\n      autoSyncPatterns:\n        override.rules?.autoSyncPatterns ?? base.rules?.autoSyncPatterns,\n      defaultInclude:\n        override.rules?.defaultInclude ?? base.rules?.defaultInclude,\n      defaultExclude:\n        override.rules?.defaultExclude ?? base.rules?.defaultExclude,\n    },\n  }\n}\n","import type { Metadata } from '../../schemas/metadata.js'\nimport type { SyncRules, AutoSyncPattern } from '../../schemas/config.js'\nimport { matchPattern, evaluatePatterns } from '../patterns/matcher.js'\nimport { getDefaultRules } from '../config/defaults.js'\n\nexport interface ShouldSyncOptions {\n  filePath: string // Path to file being evaluated\n  fileMetadata: Metadata // Parsed frontmatter from file\n  targetRepo: string // Repository to sync to\n  sourceRepo: string // Repository file is from\n  rules?: SyncRules // Optional routing rules (defaults applied)\n}\n\n/**\n * Determine if a file should be synced to a target repository\n *\n * Based on SPEC-00004: Routing & Distribution\n *\n * @param options - Evaluation options\n * @returns true if file should sync to targetRepo\n */\nexport function shouldSyncToRepo(options: ShouldSyncOptions): boolean {\n  const {\n    filePath,\n    fileMetadata,\n    targetRepo,\n    sourceRepo,\n    rules = getDefaultRules(),\n  } = options\n\n  // 1. Check special rules first\n  const specialRuleResult = evaluateSpecialRules({\n    filePath,\n    targetRepo,\n    sourceRepo,\n    rules,\n  })\n\n  if (specialRuleResult !== null) {\n    return specialRuleResult\n  }\n\n  // 2. Evaluate frontmatter rules\n  return evaluateFrontmatterRules({\n    metadata: fileMetadata,\n    targetRepo,\n    allowOverrides: rules.allowProjectOverrides ?? true,\n  })\n}\n\n/**\n * Evaluate special routing rules\n *\n * Returns true/false if a special rule matches, null otherwise\n */\nfunction evaluateSpecialRules(options: {\n  filePath: string\n  targetRepo: string\n  sourceRepo: string\n  rules: SyncRules\n}): boolean | null {\n  const { filePath, targetRepo, sourceRepo, rules } = options\n\n  // Rule 1: Auto-sync patterns (highest priority)\n  if (rules.autoSyncPatterns?.length) {\n    const autoSyncResult = evaluateAutoSyncPatterns(\n      filePath,\n      targetRepo,\n      rules.autoSyncPatterns\n    )\n\n    if (autoSyncResult !== null) {\n      return autoSyncResult\n    }\n  }\n\n  // Rule 2: Prevent self-sync\n  if (rules.preventSelfSync) {\n    const selfSyncResult = preventSelfSync(filePath, targetRepo, sourceRepo)\n\n    if (selfSyncResult !== null) {\n      return selfSyncResult\n    }\n  }\n\n  // Rule 3: Prevent codex sync\n  if (rules.preventCodexSync) {\n    const codexSyncResult = preventCodexSync(targetRepo, sourceRepo)\n\n    if (codexSyncResult !== null) {\n      return codexSyncResult\n    }\n  }\n\n  // No special rule applies\n  return null\n}\n\n/**\n * Evaluate auto-sync patterns\n */\nfunction evaluateAutoSyncPatterns(\n  filePath: string,\n  targetRepo: string,\n  patterns: AutoSyncPattern[]\n): boolean | null {\n  for (const autoPattern of patterns) {\n    // Check if file matches auto-sync pattern\n    if (matchPattern(autoPattern.pattern, filePath)) {\n      // File matches - evaluate repo include/exclude\n      return evaluatePatterns({\n        value: targetRepo,\n        include: autoPattern.include,\n        ...(autoPattern.exclude && { exclude: autoPattern.exclude }),\n      })\n    }\n  }\n\n  // No auto-sync pattern matched\n  return null\n}\n\n/**\n * Prevent system files from syncing to their own repository\n */\nfunction preventSelfSync(\n  filePath: string,\n  targetRepo: string,\n  _sourceRepo: string\n): boolean | null {\n  // Extract system name from file path\n  // Example: \".fractary/systems/api-gateway/docs/README.md\" → \"api-gateway\"\n  const systemMatch = filePath.match(/systems\\/([^/]+)\\//)\n\n  if (systemMatch && systemMatch[1]) {\n    const systemName = systemMatch[1]\n\n    if (systemName === targetRepo) {\n      // Prevent: Don't sync system files to their own repo\n      return false\n    }\n  }\n\n  // Not a system file, or different system\n  return null\n}\n\n/**\n * Prevent files from syncing back to the codex repository\n */\nfunction preventCodexSync(\n  targetRepo: string,\n  sourceRepo: string\n): boolean | null {\n  // Detect if target is the codex repo\n  const isCodexRepo =\n    targetRepo === sourceRepo || targetRepo.startsWith('codex.')\n\n  if (isCodexRepo) {\n    return false\n  }\n\n  return null\n}\n\n/**\n * Evaluate frontmatter sync rules\n */\nfunction evaluateFrontmatterRules(options: {\n  metadata: Metadata\n  targetRepo: string\n  allowOverrides: boolean\n}): boolean {\n  const { metadata, targetRepo, allowOverrides } = options\n\n  // If project overrides disabled, return false (no sync by default)\n  if (!allowOverrides) {\n    return false\n  }\n\n  const include = metadata.codex_sync_include || []\n  const exclude = metadata.codex_sync_exclude || []\n\n  // If no include rules, don't sync (must be explicit)\n  if (include.length === 0) {\n    return false\n  }\n\n  // Evaluate include/exclude patterns\n  return evaluatePatterns({\n    value: targetRepo,\n    include,\n    exclude,\n  })\n}\n\n/**\n * Determine all repos that should receive a file\n *\n * @param options - Evaluation options\n * @returns Array of repository names that should receive this file\n */\nexport function getTargetRepos(options: {\n  filePath: string\n  fileMetadata: Metadata\n  sourceRepo: string\n  allRepos: string[]\n  rules?: SyncRules\n}): string[] {\n  const { filePath, fileMetadata, sourceRepo, allRepos, rules } = options\n\n  return allRepos.filter(targetRepo =>\n    shouldSyncToRepo({\n      filePath,\n      fileMetadata,\n      targetRepo,\n      sourceRepo,\n      ...(rules && { rules }),\n    })\n  )\n}\n"]}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@fractary/codex",
+  "version": "0.1.0",
+  "description": "Core SDK for Fractary Codex - centralized knowledge management and distribution platform",
+  "keywords": [
+    "codex",
+    "documentation",
+    "knowledge-management",
+    "sync",
+    "fractary"
+  ],
+  "homepage": "https://github.com/fractary/codex#readme",
+  "bugs": {
+    "url": "https://github.com/fractary/codex/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fractary/codex.git"
+  },
+  "license": "MIT",
+  "author": "Fractary Engineering",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0",
+    "micromatch": "^4.0.8",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/micromatch": "^4.0.9",
+    "@types/node": "^20.17.9",
+    "@typescript-eslint/eslint-plugin": "^8.17.0",
+    "@typescript-eslint/parser": "^8.17.0",
+    "@vitest/coverage-v8": "^2.1.8",
+    "eslint": "^9.17.0",
+    "prettier": "^3.4.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}