@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/constants/AGENT_ROLES.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 🎯 AI Agent Roles - Single Source of Truth for NeuraLoom
+ * Constitutional compliance: Centralized role definitions for all AI assistants
+ */
+import { z } from "zod";
+/**
+ * 🎯 Zod schema for validating agent role definitions
+ */
+export declare const AgentRoleSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    prompt: z.ZodString;
+    category: z.ZodEnum<["spec", "architecture", "tasks", "code", "review", "management", "analysis", "infrastructure"]>;
+    capabilities: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title: string;
+    description: string;
+    prompt: string;
+    category: "tasks" | "review" | "code" | "spec" | "architecture" | "management" | "analysis" | "infrastructure";
+    capabilities: string[];
+}, {
+    id: string;
+    title: string;
+    description: string;
+    prompt: string;
+    category: "tasks" | "review" | "code" | "spec" | "architecture" | "management" | "analysis" | "infrastructure";
+    capabilities: string[];
+}>;
+export type AgentRole = z.infer<typeof AgentRoleSchema>;
+/**
+ * 📋 Centralized registry of all AI agent roles
+ * These roles must be imported everywhere (frontend + API routes)
+ * DO NOT inline prompts anywhere else – always reference from here
+ */
+export declare const AGENT_ROLES: AgentRole[];

package/dist/constants/AGENT_ROLES.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * 🎯 AI Agent Roles - Single Source of Truth for NeuraLoom
+ * Constitutional compliance: Centralized role definitions for all AI assistants
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_ROLES = exports.AgentRoleSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * 🎯 Zod schema for validating agent role definitions
+ */
+exports.AgentRoleSchema = zod_1.z.object({
+    id: zod_1.z.string(), // short ID used in code (e.g. "spec-engineer")
+    title: zod_1.z.string(), // human-readable name
+    description: zod_1.z.string(), // what this role is responsible for
+    prompt: zod_1.z.string(), // base system prompt for injection into LLM
+    category: zod_1.z.enum(["spec", "architecture", "tasks", "code", "review", "management", "analysis", "infrastructure"]),
+    capabilities: zod_1.z.array(zod_1.z.string()), // list of abilities this role has
+});
+/**
+ * 📋 Centralized registry of all AI agent roles
+ * These roles must be imported everywhere (frontend + API routes)
+ * DO NOT inline prompts anywhere else – always reference from here
+ */
+exports.AGENT_ROLES = [
+    {
+        id: "spec-engineer",
+        title: "Specification Engineer",
+        description: "Converts natural language requirements into structured specifications.",
+        prompt: `You are a Specification Engineer. Your job is to transform unstructured requirements into detailed, testable specifications. Always use formal structure, acceptance criteria, and constitutional compliance rules.`,
+        category: "spec",
+        capabilities: [
+            "generate-specs",
+            "expand-requirements",
+            "improve-descriptions",
+            "map-to-acceptance-criteria"
+        ]
+    },
+    {
+        id: "system-architect",
+        title: "System Architect",
+        description: "Designs system architecture, tech stack, and integration patterns.",
+        prompt: `You are a System Architect. Your task is to design secure, scalable, and compliant system architectures. Always consider data flow, API boundaries, and Guardian compliance rules.`,
+        category: "architecture",
+        capabilities: [
+            "generate-architecture",
+            "suggest-tech-stack",
+            "optimize-data-flow",
+            "perform-security-review"
+        ]
+    },
+    {
+        id: "task-analyst",
+        title: "Task Analyst",
+        description: "Breaks specifications into tasks, estimates effort, and sequences dependencies.",
+        prompt: `You are a Task Analyst. Your role is to decompose specifications into actionable tasks, estimate time/effort, and define task dependencies. Always align with SSOT workflow.`,
+        category: "tasks",
+        capabilities: [
+            "generate-tasks",
+            "estimate-effort",
+            "define-dependencies",
+            "optimize-task-sequence"
+        ]
+    },
+    {
+        id: "code-implementer",
+        title: "Code Implementer",
+        description: "Implements features, opens PRs, and ensures Guardian compliance.",
+        prompt: `You are a Code Implementer. Your role is to generate code aligned with specifications, open pull requests, and validate against Guardian compliance.`,
+        category: "code",
+        capabilities: [
+            "generate-code",
+            "open-pull-request",
+            "guardian-check"
+        ]
+    },
+    {
+        id: "code-reviewer",
+        title: "Code Reviewer",
+        description: "Reviews code for quality, security, and constitutional compliance.",
+        prompt: `You are a Code Reviewer. Your responsibility is to analyze code submissions for quality, correctness, security, and constitutional compliance.`,
+        category: "review",
+        capabilities: [
+            "review-code",
+            "suggest-improvements",
+            "enforce-constitution"
+        ]
+    },
+    {
+        id: "project-analyst",
+        title: "Project Analyst",
+        description: "Analyzes project data for retrospectives and insights.",
+        prompt: `You are a Project Analyst. Your task is to analyze project performance metrics, task velocity, and team contributions to generate retrospective insights.`,
+        category: "analysis",
+        capabilities: [
+            "generate-retrospective",
+            "analyze-performance",
+            "compare-ai-vs-human"
+        ]
+    },
+    {
+        id: "compliance-officer",
+        title: "Compliance Officer",
+        description: "Ensures specifications, tasks, and code meet Guardian rules.",
+        prompt: `You are a Compliance Officer. Your task is to validate all outputs against constitutional and Guardian compliance rules.`,
+        category: "management",
+        capabilities: [
+            "compliance-check",
+            "guardian-report",
+            "auto-fix-violations"
+        ]
+    },
+    {
+        id: "infra-architect",
+        title: "Infrastructure Architect",
+        description: "Generates infrastructure specifications from project requirements.",
+        prompt: `You are an Infrastructure Architect specializing in platform automation. Your role is to convert project specifications into valid provider-aligned configurations for Vercel, Supabase, Doppler, and GitHub.
+
+CONSTITUTIONAL REQUIREMENTS:
+- All secrets must reference Doppler (no hardcoded values)
+- Use only approved providers: vercel, supabase, doppler, github
+- Enable RLS on all Supabase tables
+- Use private repositories only
+- Follow naming convention: {brand}-{environment}-{component}
+- Estimate costs conservatively
+- Ensure all resources have proper tags (Brand, Environment, ManagedBy, Constitutional)
+
+OUTPUT FORMAT:
+Generate a valid JSON InfraSpec with the following structure:
+{
+  "projectName": "string",
+  "brand": "neuraloom|loomlab|tagadagat",
+  "environment": "dev|preview|prd",
+  "providers": {
+    "vercel": { configuration for Vercel project },
+    "supabase": { configuration for Supabase project },
+    "doppler": { configuration for Doppler secrets },
+    "github": { configuration for GitHub repository }
+  },
+  "estimatedCost": number (monthly USD),
+  "estimatedSetupTime": number (minutes)
+}
+
+PROVIDER CONFIGURATIONS:
+
+Vercel:
+{
+  "projectName": "string",
+  "framework": "nextjs|remix|vite|sveltekit",
+  "buildCommand": "string (optional)",
+  "installCommand": "string (optional)",
+  "rootDirectory": "string (optional)",
+  "region": "string (optional)",
+  "environmentVariables": { key: "doppler reference" }
+}
+
+Supabase:
+{
+  "projectName": "string",
+  "region": "us-east-1|eu-west-1|ap-southeast-1",
+  "databasePassword": "var.supabase_db_password",
+  "enableRLS": true,
+  "enableRealtime": boolean,
+  "enableStorage": boolean
+}
+
+Doppler:
+{
+  "projectName": "string",
+  "environments": ["dev", "preview", "prd"],
+  "syncToVercel": boolean,
+  "syncToGitHub": boolean
+}
+
+GitHub:
+{
+  "repositoryName": "string",
+  "description": "string",
+  "visibility": "private",
+  "hasIssues": boolean,
+  "hasProjects": boolean,
+  "autoInit": boolean
+}
+
+Always consider:
+1. Data flow between services
+2. Security best practices
+3. Cost optimization
+4. Scalability requirements
+5. Guardian compliance rules`,
+        category: "infrastructure",
+        capabilities: [
+            "validate-provider-config",
+            "estimate-infrastructure-cost",
+            "optimize-resource-usage",
+            "suggest-scaling-patterns"
+        ]
+    }
+];

package/dist/constants/audiobook-embed-placeholder-url.d.ts

@@ -0,0 +1,5 @@
+/**
+ * SSOT placeholder URL used when chapter audio storage is pending (embed MVP non-blocker path).
+ * Public-archive MP3 test asset — deterministic URL for CI and dev placeholders.
+ */
+export declare const AUDIOBOOK_EMBED_PENDING_AUDIO_PUBLIC_URL = "https://archive.org/download/testmp3testfile/mpthreetest.mp3";

package/dist/constants/audiobook-embed-placeholder-url.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUDIOBOOK_EMBED_PENDING_AUDIO_PUBLIC_URL = void 0;
+/**
+ * SSOT placeholder URL used when chapter audio storage is pending (embed MVP non-blocker path).
+ * Public-archive MP3 test asset — deterministic URL for CI and dev placeholders.
+ */
+exports.AUDIOBOOK_EMBED_PENDING_AUDIO_PUBLIC_URL = 'https://archive.org/download/testmp3testfile/mpthreetest.mp3';

package/dist/constants/ci-config.d.ts

@@ -0,0 +1,4 @@
+/**
+ * CI/CD generated artifact paths (SSOT for API + DB default)
+ */
+export declare const DEFAULT_CI_CONFIG_TARGET_FILE_PATH: ".github/workflows/neuraloom-ci.yml";

package/dist/constants/ci-config.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CI_CONFIG_TARGET_FILE_PATH = void 0;
+/**
+ * CI/CD generated artifact paths (SSOT for API + DB default)
+ */
+exports.DEFAULT_CI_CONFIG_TARGET_FILE_PATH = ".github/workflows/neuraloom-ci.yml";

package/dist/constants/kg-implement-stable-keys.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Stable `knowledge_nodes.external_id` keys for implement / delivery KG.
+ * SSOT: composite keys avoid null external_id collisions on (project_id, type, external_id).
+ */
+export declare function buildTaskKnowledgeNodeExternalId(projectId: string, taskId: string): string;
+export declare function buildPatchKnowledgeNodeExternalId(projectId: string, patchSetId: string): string;
+export declare function buildImplementFileNodeExternalId(projectId: string, path: string): string;
+export declare function buildGithubBranchNodeExternalId(repoFullName: string, branchName: string): string;
+export declare function buildGithubPullRequestNodeExternalId(repoFullName: string, prNumber: number): string;

package/dist/constants/kg-implement-stable-keys.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Stable `knowledge_nodes.external_id` keys for implement / delivery KG.
+ * SSOT: composite keys avoid null external_id collisions on (project_id, type, external_id).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTaskKnowledgeNodeExternalId = buildTaskKnowledgeNodeExternalId;
+exports.buildPatchKnowledgeNodeExternalId = buildPatchKnowledgeNodeExternalId;
+exports.buildImplementFileNodeExternalId = buildImplementFileNodeExternalId;
+exports.buildGithubBranchNodeExternalId = buildGithubBranchNodeExternalId;
+exports.buildGithubPullRequestNodeExternalId = buildGithubPullRequestNodeExternalId;
+function buildTaskKnowledgeNodeExternalId(projectId, taskId) {
+    return `task:${projectId}:${taskId}`;
+}
+function buildPatchKnowledgeNodeExternalId(projectId, patchSetId) {
+    return `patch:${projectId}:${patchSetId}`;
+}
+function buildImplementFileNodeExternalId(projectId, path) {
+    return `file:${projectId}:${path}`;
+}
+function buildGithubBranchNodeExternalId(repoFullName, branchName) {
+    return `branch:${repoFullName}:${branchName}`;
+}
+function buildGithubPullRequestNodeExternalId(repoFullName, prNumber) {
+    return `pr:${repoFullName}:${prNumber}`;
+}

package/dist/constants/knowledge-edge-relation.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Allowed `knowledge_edges.relation` values introduced by the Knowledge step.
+ *
+ * Sprint K1 (#573) widens the existing `knowledge_edges_relation_check`
+ * (see `supabase/migrations/20260504010000_knowledge_lineage_uniques.sql`)
+ * to accept these values alongside the legacy generic relations.
+ *
+ * Sub-sprint ownership:
+ *   K1-B (#575) writes `taskInPatch`, `patchOpensPr`, `prTouchesFile`.
+ *   K1-C (#576) writes `taskDuplicatedAcrossPrs`.
+ *   K1-D (#577) writes `taskCoveredByFile`.
+ *
+ * Add new relations here AND extend the DB CHECK in a follow-up migration.
+ */
+export declare const KNOWLEDGE_EDGE_RELATION: {
+    readonly taskInPatch: "task_in_patch";
+    readonly patchOpensPr: "patch_opens_pr";
+    readonly prTouchesFile: "pr_touches_file";
+    readonly patchTouchesFile: "patch_touches_file";
+    readonly patchPushedBranch: "patch_pushed_branch";
+    readonly branchOpensPr: "branch_opens_pr";
+    readonly taskCoveredByFile: "task_covered_by_file";
+    readonly taskDuplicatedAcrossPrs: "task_duplicated_across_prs";
+    /**
+     * Deployment lifecycle — `relation` column must stay on the DB CHECK whitelist.
+     * Semantic intent (e.g. DEPLOYED_FROM) is carried on `knowledge_edges.kg_edge_type` at writers.
+     */
+    readonly deploymentDerivedFromRepo: "derived_from";
+    readonly deployTriggerDependsOnProject: "depends_on";
+    readonly deployVerificationReferencesDeployment: "references";
+    /** Writing mode relations. */
+    readonly contains: "contains";
+    readonly supportedBy: "supported_by";
+    readonly challengedBy: "challenged_by";
+    readonly usedIn: "used_in";
+    readonly revises: "revises";
+    readonly targets: "targets";
+    readonly cites: "cites";
+};
+/**
+ * Value union of `KNOWLEDGE_EDGE_RELATION`.
+ *
+ * NOTE — code-vs-brief mismatch: `types/index.ts` already exports a legacy
+ * `KnowledgeEdgeRelation` (`"references" | "fulfills" | "relates"`) that does
+ * not reflect the live DB CHECK. Renamed here to `KnowledgeEdgeRelationValue`
+ * to avoid an `export *` collision in `src/index.ts`. The legacy type should
+ * be removed in K2 once consumers are migrated.
+ */
+export type KnowledgeEdgeRelationValue = typeof KNOWLEDGE_EDGE_RELATION[keyof typeof KNOWLEDGE_EDGE_RELATION];

package/dist/constants/knowledge-edge-relation.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KNOWLEDGE_EDGE_RELATION = void 0;
+/**
+ * Allowed `knowledge_edges.relation` values introduced by the Knowledge step.
+ *
+ * Sprint K1 (#573) widens the existing `knowledge_edges_relation_check`
+ * (see `supabase/migrations/20260504010000_knowledge_lineage_uniques.sql`)
+ * to accept these values alongside the legacy generic relations.
+ *
+ * Sub-sprint ownership:
+ *   K1-B (#575) writes `taskInPatch`, `patchOpensPr`, `prTouchesFile`.
+ *   K1-C (#576) writes `taskDuplicatedAcrossPrs`.
+ *   K1-D (#577) writes `taskCoveredByFile`.
+ *
+ * Add new relations here AND extend the DB CHECK in a follow-up migration.
+ */
+exports.KNOWLEDGE_EDGE_RELATION = {
+    taskInPatch: 'task_in_patch',
+    patchOpensPr: 'patch_opens_pr',
+    prTouchesFile: 'pr_touches_file',
+    patchTouchesFile: 'patch_touches_file',
+    patchPushedBranch: 'patch_pushed_branch',
+    branchOpensPr: 'branch_opens_pr',
+    taskCoveredByFile: 'task_covered_by_file',
+    taskDuplicatedAcrossPrs: 'task_duplicated_across_prs',
+    /**
+     * Deployment lifecycle — `relation` column must stay on the DB CHECK whitelist.
+     * Semantic intent (e.g. DEPLOYED_FROM) is carried on `knowledge_edges.kg_edge_type` at writers.
+     */
+    deploymentDerivedFromRepo: 'derived_from',
+    deployTriggerDependsOnProject: 'depends_on',
+    deployVerificationReferencesDeployment: 'references',
+    /** Writing mode relations. */
+    contains: 'contains',
+    supportedBy: 'supported_by',
+    challengedBy: 'challenged_by',
+    usedIn: 'used_in',
+    revises: 'revises',
+    targets: 'targets',
+    cites: 'cites',
+};

package/dist/constants/knowledge-node.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Provenance for `knowledge_nodes.source` (DB CHECK). Issue #157.
+ * Repo scanner sets `repoScan`; workflow / AI app paths set `workflowStep`.
+ */
+export declare const KNOWLEDGE_NODE_SOURCE: {
+    readonly workflowStep: "workflow_step";
+    readonly repoScan: "repo_scan";
+    /** Sprint K1-B (#575): nodes materialised from PR/patch/file lineage. */
+    readonly prLineage: "pr_lineage";
+    /** Writing mode: nodes materialised from editorial review pipeline. */
+    readonly editorialReview: "editorial_review";
+};
+export type KnowledgeNodeSource = (typeof KNOWLEDGE_NODE_SOURCE)[keyof typeof KNOWLEDGE_NODE_SOURCE];
+/**
+ * `knowledge_nodes.data` shape for the Knowledge workflow step (not repo scan).
+ * Docs/generate and other step-owned paths set `data: { step: 'knowledge' }`.
+ */
+export declare const WORKFLOW_KNOWLEDGE_NODE_DATA: {
+    step: "knowledge";
+};
+export type WorkflowKnowledgeNodeData = typeof WORKFLOW_KNOWLEDGE_NODE_DATA;

package/dist/constants/knowledge-node.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOW_KNOWLEDGE_NODE_DATA = exports.KNOWLEDGE_NODE_SOURCE = void 0;
+/**
+ * Provenance for `knowledge_nodes.source` (DB CHECK). Issue #157.
+ * Repo scanner sets `repoScan`; workflow / AI app paths set `workflowStep`.
+ */
+exports.KNOWLEDGE_NODE_SOURCE = {
+    workflowStep: "workflow_step",
+    repoScan: "repo_scan",
+    /** Sprint K1-B (#575): nodes materialised from PR/patch/file lineage. */
+    prLineage: "pr_lineage",
+    /** Writing mode: nodes materialised from editorial review pipeline. */
+    editorialReview: "editorial_review",
+};
+/**
+ * `knowledge_nodes.data` shape for the Knowledge workflow step (not repo scan).
+ * Docs/generate and other step-owned paths set `data: { step: 'knowledge' }`.
+ */
+exports.WORKFLOW_KNOWLEDGE_NODE_DATA = { step: "knowledge" };

package/dist/constants/mission-control-nav.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Mission Control Navigation - SSOT
+ * Constitutional compliance: Centralized navigation structure for Mission Control
+ */
+export interface MissionControlNavItem {
+    id: string;
+    label: string;
+    href: string;
+    icon: string;
+    description: string;
+    category: 'core' | 'operations';
+}
+export declare const MISSION_CONTROL_NAV: MissionControlNavItem[];

package/dist/constants/mission-control-nav.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Mission Control Navigation - SSOT
+ * Constitutional compliance: Centralized navigation structure for Mission Control
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MISSION_CONTROL_NAV = void 0;
+exports.MISSION_CONTROL_NAV = [
+    // Core Systems
+    {
+        id: 'guardian',
+        label: 'Guardian',
+        href: '/mission-control/guardian',
+        icon: 'Shield',
+        description: 'Constitutional compliance monitoring',
+        category: 'core'
+    },
+    {
+        id: 'orchestration',
+        label: 'AI Orchestration',
+        href: '/mission-control/orchestration',
+        icon: 'Cpu',
+        description: 'Workflow and agent coordination',
+        category: 'core'
+    },
+    {
+        id: 'constitution',
+        label: 'Constitution',
+        href: '/mission-control/constitution',
+        icon: 'Scale',
+        description: 'Governance rules and policies',
+        category: 'core'
+    },
+    {
+        id: 'intelligence',
+        label: 'Intelligence',
+        href: '/mission-control/intelligence',
+        icon: 'Brain',
+        description: 'AI agents and capabilities',
+        category: 'core'
+    },
+    // Operations
+    {
+        id: 'runs',
+        label: 'Runs',
+        href: '/mission-control/runs',
+        icon: 'Play',
+        description: 'Active workflow executions',
+        category: 'operations'
+    },
+    {
+        id: 'approvals',
+        label: 'Approvals',
+        href: '/mission-control/approvals',
+        icon: 'FileCheck',
+        description: 'Pending human reviews',
+        category: 'operations'
+    },
+    {
+        id: 'graph',
+        label: 'Graph Explorer',
+        href: '/mission-control/graph',
+        icon: 'Network',
+        description: 'Knowledge graph visualization',
+        category: 'operations'
+    },
+    {
+        id: 'mcp',
+        label: 'MCP Health',
+        href: '/mission-control/mcp',
+        icon: 'Activity',
+        description: 'Infrastructure status',
+        category: 'operations'
+    }
+];

package/dist/constants/model-mode-preset-defaults.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Workflow presets. Modes vary reasoning effort, verbosity, context, and quality.
+ */
+import type { ModelModePresetMap } from "../schemas/ai/model-policy/model-mode-preset.schema";
+export declare const DEFAULT_MODEL_MODE_PRESETS: ModelModePresetMap;

package/dist/constants/model-mode-preset-defaults.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Workflow presets. Modes vary reasoning effort, verbosity, context, and quality.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MODEL_MODE_PRESETS = void 0;
+const model_registry_1 = require("../data/model-registry");
+exports.DEFAULT_MODEL_MODE_PRESETS = {
+    testing: {
+        mode: "testing",
+        provider: "openai",
+        modelId: model_registry_1.NEURALOOM_WORKFLOW_GENERATION_MODEL_ID,
+        reasoningEffort: "low",
+        verbosity: "low",
+        maxOutputTokens: 32000,
+        maxContextItems: 30,
+        temperature: 0,
+        qualityGate: "low",
+        guardianThreshold: 60,
+        costLimitUsdPerRun: null,
+        description: "Low-reasoning, low-verbosity workflow mode. No cumulative cap — per-call estimates only.",
+    },
+    balanced: {
+        mode: "balanced",
+        provider: "openai",
+        modelId: model_registry_1.NEURALOOM_WORKFLOW_GENERATION_MODEL_ID,
+        reasoningEffort: "medium",
+        verbosity: "medium",
+        maxOutputTokens: 48000,
+        maxContextItems: 80,
+        temperature: 0,
+        qualityGate: "medium",
+        guardianThreshold: 75,
+        costLimitUsdPerRun: null,
+        description: "Default medium-reasoning workflow mode. Use for normal workflow generation.",
+    },
+    production: {
+        mode: "production",
+        provider: "openai",
+        modelId: model_registry_1.NEURALOOM_WORKFLOW_GENERATION_MODEL_ID,
+        reasoningEffort: "high",
+        verbosity: "medium",
+        maxOutputTokens: 64000,
+        maxContextItems: 200,
+        temperature: 0,
+        qualityGate: "high",
+        guardianThreshold: 85,
+        costLimitUsdPerRun: null,
+        description: "High-reasoning workflow mode with strict Guardian. Use for real architecture and code generation.",
+    },
+    custom: {
+        mode: "custom",
+        provider: "openai",
+        modelId: model_registry_1.NEURALOOM_WORKFLOW_GENERATION_MODEL_ID,
+        reasoningEffort: "medium",
+        verbosity: "medium",
+        maxOutputTokens: 48000,
+        maxContextItems: 80,
+        temperature: 0,
+        qualityGate: "medium",
+        guardianThreshold: 75,
+        costLimitUsdPerRun: null,
+        description: "Per-step explicit configuration.",
+    },
+};

package/dist/constants/model-policies.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Policy-Based Model Orchestration — SSOT
+ * SP-POL1: Task type decides reasoning, budget, timeout, and escalation path.
+ * Model identity is centralized in the workflow model registry.
+ */
+export type TaskKind = 'spec.generate' | 'specify.domain_model' | 'specify.requirements' | 'specify.acceptance_criteria' | 'specify.edge_cases' | 'specify.constraints' | 'specify.final' | 'task.generate' | 'tasks.graph' | 'schema.generate' | 'schema.domain_model' | 'schema.blueprint' | 'schema.relations' | 'schema.migration_sql' | 'schema.security_rls' | 'schema.types' | 'api.generate' | 'api.endpoint_map' | 'api.contracts' | 'ui.generate' | 'ui.screen_map' | 'ui.component_contracts' | 'plan.architecture' | 'plan.data_flow' | 'plan.module_boundaries' | 'plan.risks' | 'plan.delivery_phases' | 'plan.final' | 'architecture.plan' | 'guardian.validate' | 'debug.root_cause' | 'repo.summarize' | 'audit.findings_register' | 'audit.capability_classification' | 'audit.canonicalization_decision' | 'knowledge.generate' | 'writing.scaffold' | 'writing.prose' | 'writing.guardian' | 'writing.repair' | 'code.implement' | 'implement.file_plan' | 'implement.code_gen' | 'implement.tests' | 'review.artifact' | 'review.code' | 'review.security' | 'review.release_decision' | 'constitution.generate' | 'code.review' | 'analytics.generate' | 'pipeline.generate' | 'deploy.target_config' | 'deploy.final' | 'compliance.evidence' | 'compliance.policy' | 'compliance.score' | 'compliance.remediation' | 'compliance.final' | 'cicd.commands' | 'cicd.workflow_file' | 'cicd.final' | 'film.still_review' | 'film.clip_review' | 'critical.escalation';
+export type ReasoningEffort = 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+export interface ModelPolicy {
+    model: string;
+    reasoning: ReasoningEffort;
+    maxOutputTokens: number;
+    structuredOutput: boolean;
+    maxEstimatedUsd: number;
+    timeoutMs: number;
+    retryCount: number;
+    escalation?: TaskKind;
+    requiresApproval?: boolean;
+}
+/**
+ * Authoritative policy table.
+ *
+ * Rules (SP-POL2: Reasoning Effort Tiers — #184):
+ * - high:   plan.architecture, plan.final, plan.module_boundaries, review.*, *.security, review.release_decision
+ * - medium: spec/specify, schema (except security_rls), constitution, guardian, code.review, debug, compliance, deploy, cicd, implement.file_plan
+ * - low:    plan.data_flow, plan.risks, plan.delivery_phases, api.*, ui.*, tasks.*, code.implement, repo.summarize, knowledge, implement.code_gen, implement.tests
+ * - none:   analytics, pipeline
+ * - xhigh:  critical.escalation (requiresApproval)
+ * - maxOutputTokens on reasoning-enabled entries are sized to absorb reasoning overhead
+ *   (visible_output = max_output - reasoning_tokens)
+ */
+export declare const MODEL_POLICIES: Record<TaskKind, ModelPolicy>;
+/**
+ * Bounded preparation calls keep the ModelPolicy shape and the executeStage path.
+ * Model id is the cheapest id already on MODEL_POLICIES. Reasoning is `low`
+ * (the lowest effort the policy table uses besides `none`). Output is capped at 1200.
+ */
+export declare function preparationModelPolicy(base: ModelPolicy): ModelPolicy;