session-orchestrator 4.0.1 → 4.2.0

package/scripts/lib/multi-provider-build/templating.mjs

@@ -1,130 +0,0 @@
-/**
- * scripts/lib/multi-provider-build/templating.mjs
- *
- * Single-source → many-provider templating (PoC). One source document with
- * provider-conditional blocks + placeholders renders to a provider-specific
- * artifact. This replaces the "maintain N near-identical copies by hand" model
- * our codex-install.mjs / cursor-install.mjs currently imply.
- *
- * Two primitives (clean-room reimplementation of impeccable's mechanic):
- *   1. compileProviderBlocks(content, activeTags)
- *        <codex> … </codex> blocks: keep body iff the tag is active, else drop.
- *        Unknown tags are left untouched (so real HTML/JSX isn't mangled).
- *   2. replacePlaceholders(content, providerKey, opts)
- *        {{model}} {{config_file}} {{command_prefix}} {{ask_instruction}}
- *        {{available_commands}} substitution + optional /cmd → $cmd rewrite.
- *
- * renderForProvider() composes both in the correct order (blocks first, then
- * placeholders — matching impeccable's pipeline).
- */
-
-import { PROVIDERS, ALL_BLOCK_TAGS } from './providers.mjs';
-
-/**
- * Keep `<tag>…</tag>` blocks whose tag is in `activeTags`; strip the rest.
- * Only tags in `knownTags` are treated as conditional blocks — any other
- * `<foo>…</foo>` (e.g. real markup) is left exactly as-is.
- *
- * Tags must sit on their own line, e.g.:
- *   <codex>
- *   Codex-only text.
- *   </codex>
- *
- * @param {string} content
- * @param {Iterable<string>} activeTags
- * @param {Iterable<string>} [knownTags] — defaults to ALL_BLOCK_TAGS
- * @returns {string}
- */
-export function compileProviderBlocks(content, activeTags, knownTags = ALL_BLOCK_TAGS) {
-  const active = new Set(activeTags);
-  const known = new Set(knownTags);
-  let compiledAny = false;
-
-  // Match a block: leading newline (or start), <tag> on its own line, body,
-  // </tag> on its own line. Non-greedy body; the backreference enforces matching.
-  const blockRe = /(^|\r?\n)[ \t]*<([a-z][a-z0-9-]*)>[ \t]*\r?\n([\s\S]*?)\r?\n[ \t]*<\/\2>[ \t]*(?=\r?\n|$)/g;
-
-  const out = content.replace(blockRe, (match, prefix, tag, body) => {
-    if (!known.has(tag)) return match; // not a provider block — leave untouched
-    compiledAny = true;
-    return active.has(tag) ? `${prefix}${body}` : prefix;
-  });
-
-  // Collapse the 3+ blank-line runs that stripping can leave behind.
-  return compiledAny ? out.replace(/(\r?\n){3,}/g, '\n\n') : out;
-}
-
-/**
- * Substitute {{placeholders}} for a provider and (optionally) rewrite command
- * invocations from `/name` to the provider's prefix.
- *
- * @param {string} content
- * @param {string} providerKey
- * @param {{ commandNames?: string[] }} [opts]
- * @returns {string}
- */
-export function replacePlaceholders(content, providerKey, opts = {}) {
-  const provider = PROVIDERS[providerKey];
-  if (!provider) throw new Error(`Unknown provider: ${providerKey}`);
-  const { model, configFile, commandPrefix, askInstruction } = provider.placeholders;
-  const commandNames = opts.commandNames ?? [];
-
-  const availableCommands = commandNames.map((n) => `${commandPrefix}${n}`).join(', ');
-
-  let result = content
-    .replace(/\{\{model\}\}/g, model)
-    .replace(/\{\{config_file\}\}/g, configFile)
-    .replace(/\{\{ask_instruction\}\}/g, askInstruction)
-    .replace(/\{\{available_commands\}\}/g, availableCommands)
-    .replace(/\{\{command_prefix\}\}/g, commandPrefix);
-
-  // Rewrite `/cmd` invocations to the provider prefix (e.g. Codex uses `$`).
-  // Longest names first so `/session-end` is rewritten before `/session`.
-  if (commandPrefix !== '/' && commandNames.length > 0) {
-    const sorted = [...commandNames].sort((a, b) => b.length - a.length);
-    for (const name of sorted) {
-      // `/name` where name is followed by a non-identifier char or end.
-      const re = new RegExp(`\\/(${escapeRegex(name)})(?=[^a-zA-Z0-9_-]|$)`, 'g');
-      // Use a replacement FUNCTION, not a string — a `$` commandPrefix would
-      // otherwise collide with String.replace's `$$`/`$1` escape syntax.
-      result = result.replace(re, (_match, g1) => `${commandPrefix}${g1}`);
-    }
-  }
-
-  return result;
-}
-
-/**
- * Render a source document for a single provider: compile blocks, then
- * substitute placeholders.
- *
- * @param {string} source
- * @param {string} providerKey
- * @param {{ commandNames?: string[] }} [opts]
- * @returns {string}
- */
-export function renderForProvider(source, providerKey, opts = {}) {
-  const provider = PROVIDERS[providerKey];
-  if (!provider) throw new Error(`Unknown provider: ${providerKey}`);
-  const compiled = compileProviderBlocks(source, provider.tags);
-  return replacePlaceholders(compiled, providerKey, opts);
-}
-
-/**
- * Render a source for every configured provider.
- * @param {string} source
- * @param {{ commandNames?: string[] }} [opts]
- * @returns {Record<string,string>} keyed by provider key
- */
-export function renderAll(source, opts = {}) {
-  const out = {};
-  for (const key of Object.keys(PROVIDERS)) {
-    out[key] = renderForProvider(source, key, opts);
-  }
-  return out;
-}
-
-/** @param {string} s */
-function escapeRegex(s) {
-  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}

package/scripts/lib/owner-config/coerce.mjs

@@ -1,29 +0,0 @@
-/**
- * owner-config/coerce.mjs — Strict-mode wrapper around validate().
- *
- * Imports: validate + OwnerConfigError. Throws on validation failure, returns
- * the normalized value on success. Convenient for CLI entrypoints and tests
- * that want to assert on success without inspecting `ok`.
- */
-
-import { validate } from './validate.mjs';
-import { OwnerConfigError } from './error.mjs';
-
-/**
- * Strict-mode wrapper around validate(). Returns the normalized value when
- * the input passes the gate, otherwise throws OwnerConfigError with the
- * full error list attached as `.errors`.
- *
- * @param {unknown} raw
- * @returns {object}
- */
-export function coerce(raw) {
-  const result = validate(raw);
-  if (!result.ok) {
-    throw new OwnerConfigError(
-      `owner config validation failed (${result.errors.length} error${result.errors.length === 1 ? '' : 's'})`,
-      result.errors
-    );
-  }
-  return result.value;
-}

package/scripts/lib/owner-config/constants.mjs

@@ -1,21 +0,0 @@
-/**
- * owner-config/constants.mjs — Schema constants for the owner persona config.
- *
- * Leaf module. No imports. All exported arrays are frozen so consumers cannot
- * accidentally mutate the canonical enum sets.
- */
-
-/** Current owner-config schema version. New writes are stamped with this. */
-export const CURRENT_OWNER_SCHEMA_VERSION = 1;
-
-/** Valid values for tone.style. */
-export const VALID_TONE_STYLES = Object.freeze(['direct', 'neutral', 'friendly']);
-
-/** Valid values for efficiency.output-level. */
-export const VALID_OUTPUT_LEVELS = Object.freeze(['lite', 'full', 'ultra']);
-
-/** Valid values for efficiency.preamble. */
-export const VALID_PREAMBLE_LEVELS = Object.freeze(['minimal', 'verbose']);
-
-/** Valid values for efficiency.comments-in-code. */
-export const VALID_COMMENTS_LEVELS = Object.freeze(['minimal', 'full']);

package/scripts/lib/owner-config/defaults.mjs

@@ -1,50 +0,0 @@
-/**
- * owner-config/defaults.mjs — Canonical default-filled owner config factory.
- *
- * Imports constants only. Leaf in the dependency sense (no circular deps).
- * Returns the fully-default-filled config with `owner.name` and
- * `owner.language` intentionally left blank — those are required from the user;
- * the bootstrap interview (D2) fills them in.
- */
-
-import { CURRENT_OWNER_SCHEMA_VERSION } from './constants.mjs';
-
-/**
- * Returns the canonical default-filled owner config. `owner.name` and
- * `owner.language` are intentionally empty — those are user-required fields
- * the bootstrap interview (D2) fills in. The `defaults()` shape is what
- * `merge()` uses as its base when callers pass partial overrides.
- *
- * @returns {object}
- */
-export function defaults() {
-  return {
-    'schema-version': CURRENT_OWNER_SCHEMA_VERSION,
-    owner: {
-      name: '',
-      'email-hash': null,
-      language: '',
-    },
-    tone: {
-      style: 'neutral',
-      tonality: null,
-    },
-    efficiency: {
-      'output-level': 'full',
-      preamble: 'minimal',
-      'comments-in-code': 'minimal',
-    },
-    'hardware-sharing': {
-      enabled: false,
-      'hash-salt': null,
-    },
-    defaults: {
-      'preferred-test-command': null,
-      'preferred-editor': null,
-    },
-    metadata: {
-      created_at: null,
-      updated_at: null,
-    },
-  };
-}

package/scripts/lib/owner-config/error.mjs

@@ -1,19 +0,0 @@
-/**
- * owner-config/error.mjs — OwnerConfigError class.
- *
- * Leaf module. No imports. Thrown by coerce() when validation fails. The
- * `.errors` array carries the full list of human-readable failure messages
- * collected by validate().
- */
-
-export class OwnerConfigError extends Error {
-  /**
-   * @param {string} message
-   * @param {string[]} [errors]
-   */
-  constructor(message, errors = []) {
-    super(message);
-    this.name = 'OwnerConfigError';
-    this.errors = errors;
-  }
-}

package/scripts/lib/owner-config/index.mjs

@@ -1,13 +0,0 @@
-/**
- * owner-config/index.mjs — Re-export hub for all 10 public symbols.
- *
- * DAG: constants/error (leaves) → defaults → merge; constants/error → validate → coerce.
- * This hub is the single import target for `scripts/lib/owner-config.mjs` (top wrapper).
- */
-
-export { CURRENT_OWNER_SCHEMA_VERSION, VALID_TONE_STYLES, VALID_OUTPUT_LEVELS, VALID_PREAMBLE_LEVELS, VALID_COMMENTS_LEVELS } from './constants.mjs';
-export { OwnerConfigError } from './error.mjs';
-export { defaults } from './defaults.mjs';
-export { validate } from './validate.mjs';
-export { coerce } from './coerce.mjs';
-export { merge } from './merge.mjs';

package/scripts/lib/owner-config/merge.mjs

@@ -1,52 +0,0 @@
-/**
- * owner-config/merge.mjs — Deep merge for owner persona configs.
- *
- * Imports: constants + defaults. One-level-deep section merge because the
- * schema has no nested object leaves beyond top-level sections. The output is
- * always a full default-filled config — either input may be partial.
- */
-
-import { CURRENT_OWNER_SCHEMA_VERSION } from './constants.mjs';
-import { defaults } from './defaults.mjs';
-
-function isPlainObject(v) {
-  return v !== null && typeof v === 'object' && !Array.isArray(v);
-}
-
-/**
- * Deep merge two owner configs. `override` values win on every leaf key
- * where they are defined (i.e. not undefined). The returned value is a
- * full default-filled config — either input may be partial.
- *
- * Used by D3 (`soul.md` runtime-merge) and D4 (baseline-propagation +
- * per-session override). The merge is one level deep on each top-level
- * section (owner, tone, efficiency, hardware-sharing, defaults, metadata)
- * because the schema has no nested object leaves beyond that.
- *
- * @param {object|null|undefined} base
- * @param {object|null|undefined} override
- * @returns {object}
- */
-export function merge(base, override) {
-  const baseSafe = isPlainObject(base) ? base : {};
-  const overSafe = isPlainObject(override) ? override : {};
-  const def = defaults();
-
-  const sections = ['owner', 'tone', 'efficiency', 'hardware-sharing', 'defaults', 'metadata'];
-  const out = {
-    'schema-version': CURRENT_OWNER_SCHEMA_VERSION,
-  };
-
-  for (const section of sections) {
-    const baseSection = isPlainObject(baseSafe[section]) ? baseSafe[section] : {};
-    const overSection = isPlainObject(overSafe[section]) ? overSafe[section] : {};
-    out[section] = { ...def[section], ...baseSection };
-    for (const [k, v] of Object.entries(overSection)) {
-      if (v !== undefined) {
-        out[section][k] = v;
-      }
-    }
-  }
-
-  return out;
-}

package/scripts/lib/owner-config/validate.mjs

@@ -1,259 +0,0 @@
-/**
- * owner-config/validate.mjs — Pure schema validator for the owner persona config.
- * Never throws — returns {ok, value, errors}. Unknown top-level sections dropped.
- */
-
-import {
-  CURRENT_OWNER_SCHEMA_VERSION,
-  VALID_TONE_STYLES,
-  VALID_OUTPUT_LEVELS,
-  VALID_PREAMBLE_LEVELS,
-  VALID_COMMENTS_LEVELS,
-} from './constants.mjs';
-
-// Internal constants
-const NAME_MAX = 100;
-const TONALITY_MAX = 200;
-const TEST_COMMAND_MAX = 200;
-const EDITOR_MAX = 50;
-const HEX64_RE = /^[a-f0-9]{64}$/i;
-const ISO_639_1_RE = /^[a-z]{2}(-[A-Z]{2})?$/;
-
-// Private helpers
-const isPlainObject = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
-const isNonEmptyString = (v, max) => typeof v === 'string' && v.length > 0 && (max === undefined || v.length <= max);
-
-// Section validators (module-private)
-function _validateSchemaVersionSection(raw, errors) {
-  const schemaVersion = raw['schema-version'];
-  if (schemaVersion === undefined || schemaVersion === null) {
-    errors.push('schema-version is required');
-  } else if (schemaVersion !== CURRENT_OWNER_SCHEMA_VERSION) {
-    errors.push(
-      `schema-version must be ${CURRENT_OWNER_SCHEMA_VERSION}, got: ${JSON.stringify(schemaVersion)}`
-    );
-  }
-}
-
-function _validateOwnerSection(raw, errors, ownerOut) {
-  const owner = raw.owner;
-  if (!isPlainObject(owner)) {
-    errors.push('owner must be an object');
-    return;
-  }
-  if (!isNonEmptyString(owner.name, NAME_MAX)) {
-    errors.push(`owner.name must be a non-empty string (max ${NAME_MAX} chars)`);
-  } else {
-    ownerOut.name = owner.name;
-  }
-  if (owner['email-hash'] !== undefined && owner['email-hash'] !== null) {
-    if (typeof owner['email-hash'] !== 'string' || !HEX64_RE.test(owner['email-hash'])) {
-      errors.push('owner.email-hash must be a 64-char hex string (sha256) or null');
-    } else {
-      ownerOut['email-hash'] = owner['email-hash'].toLowerCase();
-    }
-  }
-  if (!isNonEmptyString(owner.language, 10) || !ISO_639_1_RE.test(owner.language)) {
-    errors.push('owner.language must be an ISO-639-1 code (e.g. "de", "en", "en-US")');
-  } else {
-    ownerOut.language = owner.language;
-  }
-}
-
-function _validateToneSection(raw, errors, toneOut) {
-  if (raw.tone === undefined) return;
-  if (!isPlainObject(raw.tone)) {
-    errors.push('tone must be an object');
-    return;
-  }
-  if (raw.tone.style !== undefined) {
-    if (!VALID_TONE_STYLES.includes(raw.tone.style)) {
-      errors.push(`tone.style must be one of ${VALID_TONE_STYLES.join('|')}, got: ${raw.tone.style}`);
-    } else {
-      toneOut.style = raw.tone.style;
-    }
-  }
-  if (raw.tone.tonality !== undefined && raw.tone.tonality !== null) {
-    if (typeof raw.tone.tonality !== 'string' || raw.tone.tonality.length > TONALITY_MAX) {
-      errors.push(`tone.tonality must be a string (max ${TONALITY_MAX} chars) or null`);
-    } else {
-      toneOut.tonality = raw.tone.tonality;
-    }
-  }
-}
-
-function _validateEfficiencySection(raw, errors, efficiencyOut) {
-  if (raw.efficiency === undefined) return;
-  if (!isPlainObject(raw.efficiency)) {
-    errors.push('efficiency must be an object');
-    return;
-  }
-  if (raw.efficiency['output-level'] !== undefined) {
-    if (!VALID_OUTPUT_LEVELS.includes(raw.efficiency['output-level'])) {
-      errors.push(
-        `efficiency.output-level must be one of ${VALID_OUTPUT_LEVELS.join('|')}, got: ${raw.efficiency['output-level']}`
-      );
-    } else {
-      efficiencyOut['output-level'] = raw.efficiency['output-level'];
-    }
-  }
-  if (raw.efficiency.preamble !== undefined) {
-    if (!VALID_PREAMBLE_LEVELS.includes(raw.efficiency.preamble)) {
-      errors.push(
-        `efficiency.preamble must be one of ${VALID_PREAMBLE_LEVELS.join('|')}, got: ${raw.efficiency.preamble}`
-      );
-    } else {
-      efficiencyOut.preamble = raw.efficiency.preamble;
-    }
-  }
-  if (raw.efficiency['comments-in-code'] !== undefined) {
-    if (!VALID_COMMENTS_LEVELS.includes(raw.efficiency['comments-in-code'])) {
-      errors.push(
-        `efficiency.comments-in-code must be one of ${VALID_COMMENTS_LEVELS.join('|')}, got: ${raw.efficiency['comments-in-code']}`
-      );
-    } else {
-      efficiencyOut['comments-in-code'] = raw.efficiency['comments-in-code'];
-    }
-  }
-}
-
-function _validateHardwareSharingSection(raw, errors, hwOut) {
-  if (raw['hardware-sharing'] === undefined) return;
-  const hw = raw['hardware-sharing'];
-  if (!isPlainObject(hw)) {
-    errors.push('hardware-sharing must be an object');
-    return;
-  }
-  if (hw.enabled !== undefined) {
-    if (typeof hw.enabled !== 'boolean') {
-      errors.push(`hardware-sharing.enabled must be boolean, got: ${typeof hw.enabled}`);
-    } else {
-      hwOut.enabled = hw.enabled;
-    }
-  }
-  if (hw['hash-salt'] !== undefined && hw['hash-salt'] !== null) {
-    if (typeof hw['hash-salt'] !== 'string' || !HEX64_RE.test(hw['hash-salt'])) {
-      errors.push('hardware-sharing.hash-salt must be a 64-char hex string (32 bytes) or null');
-    } else {
-      hwOut['hash-salt'] = hw['hash-salt'].toLowerCase();
-    }
-  }
-  // Privacy contract: enabled=true requires hash-salt to be set.
-  if (hwOut.enabled && hwOut['hash-salt'] === null) {
-    errors.push('hardware-sharing.enabled=true requires hash-salt to be set (D4 consent contract)');
-  }
-}
-
-function _validateDefaultsSection(raw, errors, defaultsOut) {
-  if (raw.defaults === undefined) return;
-  if (!isPlainObject(raw.defaults)) {
-    errors.push('defaults must be an object');
-    return;
-  }
-  const ptc = raw.defaults['preferred-test-command'];
-  if (ptc !== undefined && ptc !== null) {
-    if (typeof ptc !== 'string' || ptc.length > TEST_COMMAND_MAX) {
-      errors.push(`defaults.preferred-test-command must be a string (max ${TEST_COMMAND_MAX} chars) or null`);
-    } else {
-      defaultsOut['preferred-test-command'] = ptc;
-    }
-  }
-  const pe = raw.defaults['preferred-editor'];
-  if (pe !== undefined && pe !== null) {
-    if (typeof pe !== 'string' || pe.length > EDITOR_MAX) {
-      errors.push(`defaults.preferred-editor must be a string (max ${EDITOR_MAX} chars) or null`);
-    } else {
-      defaultsOut['preferred-editor'] = pe;
-    }
-  }
-}
-
-function _validateMetadataSection(raw, errors, metadataOut) {
-  if (raw.metadata === undefined) return;
-  if (!isPlainObject(raw.metadata)) {
-    errors.push('metadata must be an object');
-    return;
-  }
-  if (raw.metadata.created_at !== undefined && raw.metadata.created_at !== null) {
-    if (typeof raw.metadata.created_at !== 'string' || Number.isNaN(Date.parse(raw.metadata.created_at))) {
-      errors.push('metadata.created_at must be an ISO 8601 timestamp string or null');
-    } else {
-      metadataOut.created_at = raw.metadata.created_at;
-    }
-  }
-  if (raw.metadata.updated_at !== undefined && raw.metadata.updated_at !== null) {
-    if (typeof raw.metadata.updated_at !== 'string' || Number.isNaN(Date.parse(raw.metadata.updated_at))) {
-      errors.push('metadata.updated_at must be an ISO 8601 timestamp string or null');
-    } else {
-      metadataOut.updated_at = raw.metadata.updated_at;
-    }
-  }
-}
-
-// Public API
-
-/**
- * Validate a raw owner config object. Defensive — never throws. Returns
- * `{ok, value, errors}` where `value` is the normalized (default-filled)
- * config when ok=true. When ok=false, `value` is null and `errors` is a
- * non-empty array of human-readable messages.
- *
- * @param {unknown} raw
- * @returns {{ok: boolean, value: object|null, errors: string[]}}
- */
-export function validate(raw) {
-  const errors = [];
-
-  if (!isPlainObject(raw)) {
-    return { ok: false, value: null, errors: ['owner config must be an object'] };
-  }
-
-  // schema-version (required, must be 1)
-  _validateSchemaVersionSection(raw, errors);
-
-  // owner (required)
-  const ownerOut = { name: '', 'email-hash': null, language: '' };
-  _validateOwnerSection(raw, errors, ownerOut);
-
-  // tone (optional; defaults applied)
-  const toneOut = { style: 'neutral', tonality: null };
-  _validateToneSection(raw, errors, toneOut);
-
-  // efficiency (optional; defaults applied)
-  const efficiencyOut = {
-    'output-level': 'full',
-    preamble: 'minimal',
-    'comments-in-code': 'minimal',
-  };
-  _validateEfficiencySection(raw, errors, efficiencyOut);
-
-  // hardware-sharing (optional; defaults applied)
-  const hwOut = { enabled: false, 'hash-salt': null };
-  _validateHardwareSharingSection(raw, errors, hwOut);
-
-  // defaults (optional)
-  const defaultsOut = { 'preferred-test-command': null, 'preferred-editor': null };
-  _validateDefaultsSection(raw, errors, defaultsOut);
-
-  // metadata (optional, auto-managed by writer)
-  const metadataOut = { created_at: null, updated_at: null };
-  _validateMetadataSection(raw, errors, metadataOut);
-
-  if (errors.length > 0) {
-    return { ok: false, value: null, errors };
-  }
-
-  return {
-    ok: true,
-    errors: [],
-    value: {
-      'schema-version': CURRENT_OWNER_SCHEMA_VERSION,
-      owner: ownerOut,
-      tone: toneOut,
-      efficiency: efficiencyOut,
-      'hardware-sharing': hwOut,
-      defaults: defaultsOut,
-      metadata: metadataOut,
-    },
-  };
-}