@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/constants/navConfig.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * NAV CONFIG SSOT - NeuraLoom Canonical Navigation Registry
+ * All navigation, sidebars, and menus must import exclusively from here.
+ * DO NOT redefine navigation arrays or hardcode links elsewhere.
+ *
+ * Constitutional compliance: Single source of truth for all navigation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NAV_VERSION = exports.NAV_REGISTRY = void 0;
+exports.NAV_REGISTRY = {
+    main: [
+        {
+            id: 'core',
+            title: 'Core Systems',
+            icon: { name: 'Layers' },
+            sections: [
+                {
+                    id: 'dashboard',
+                    title: 'Dashboard',
+                    items: [
+                        {
+                            id: 'overview',
+                            title: 'Dashboard',
+                            path: '/dashboard',
+                            icon: { name: 'LayoutDashboard' }
+                        },
+                        {
+                            id: 'mission',
+                            title: 'Mission Control',
+                            path: '/mission-control',
+                            icon: { name: 'Activity' }
+                        },
+                        {
+                            id: 'projects',
+                            title: 'Projects',
+                            path: '/projects',
+                            icon: { name: 'FolderKanban' }
+                        },
+                        {
+                            id: 'tutorial',
+                            title: 'Tutorial',
+                            path: '/tutorial',
+                            icon: { name: 'BookOpen' }
+                        }
+                    ]
+                }
+            ]
+        }
+    ],
+    missionControl: [
+        {
+            id: 'operations',
+            title: 'Mission Control',
+            icon: { name: 'Rocket' },
+            sections: [
+                {
+                    id: 'core',
+                    title: 'Core Systems',
+                    items: [
+                        { id: 'overview', title: 'Overview', path: '/mission-control', icon: { name: 'Activity' } },
+                        { id: 'guardian', title: 'Guardian', path: '/mission-control/guardian', icon: { name: 'Shield' } },
+                        { id: 'intelligence', title: 'Intelligence', path: '/mission-control/intelligence', icon: { name: 'Brain' } },
+                        { id: 'graph', title: 'Graph Explorer', path: '/mission-control/graph', icon: { name: 'Network' } }
+                    ]
+                },
+                {
+                    id: 'operations',
+                    title: 'Operations',
+                    items: [
+                        { id: 'orchestration', title: 'Orchestration', path: '/mission-control/orchestration', icon: { name: 'Workflow' } },
+                        { id: 'runs', title: 'Runs', path: '/mission-control/runs', icon: { name: 'Cpu' } },
+                        { id: 'approvals', title: 'Approvals', path: '/mission-control/approvals', icon: { name: 'CheckCircle' } },
+                        { id: 'constitution', title: 'Constitution', path: '/mission-control/constitution', icon: { name: 'Scale' } }
+                    ]
+                },
+                {
+                    id: 'infrastructure',
+                    title: 'Infrastructure',
+                    items: [
+                        { id: 'mcp', title: 'MCP Status', path: '/mission-control/mcp', icon: { name: 'HeartPulse' } }
+                    ]
+                }
+            ]
+        }
+    ],
+    tutorial: [
+        {
+            id: 'getting-started',
+            title: 'Tutorials',
+            icon: { name: 'BookOpen' },
+            sections: [
+                {
+                    id: 'foundation',
+                    title: 'Getting Started',
+                    items: [
+                        { id: 'intro', title: 'Introduction', path: '/tutorial', icon: { name: 'Lightbulb' } },
+                        { id: 'mission', title: 'Mission Control', path: '/tutorial/mission-control', icon: { name: 'Activity' } }
+                    ]
+                },
+                {
+                    id: 'advanced',
+                    title: 'Advanced',
+                    items: [
+                        { id: 'advanced', title: 'Advanced', path: '/tutorial/advanced', icon: { name: 'Zap' } },
+                        { id: 'agents', title: 'Agents', path: '/tutorial/agents', icon: { name: 'Users' } },
+                        { id: 'workflows', title: 'Workflows', path: '/tutorial/workflows', icon: { name: 'Workflow' } },
+                        { id: 'guardian', title: 'Guardian', path: '/tutorial/guardian', icon: { name: 'Shield' } },
+                        { id: 'advanced-features', title: 'Advanced Features', path: '/tutorial/advanced-features', icon: { name: 'Sparkles' } }
+                    ]
+                }
+            ]
+        }
+    ],
+    workflow: [
+        {
+            id: 'projects',
+            title: 'Projects',
+            icon: { name: 'FolderKanban' },
+            sections: [
+                {
+                    id: 'active',
+                    title: 'Active Workflows',
+                    items: [
+                        { id: 'orchestration', title: 'Orchestration', path: '/mission-control/orchestration', icon: { name: 'Workflow' } }
+                    ]
+                }
+            ]
+        }
+    ]
+};
+exports.NAV_VERSION = 'v1.0.0';

package/dist/constants/orchestration-execution.d.ts

@@ -0,0 +1,5 @@
+import type { StepRetryPolicy } from '../types/orchestration-execution';
+/** Default floor for Guardian when the client does not pass an explicit threshold. */
+export declare const DEFAULT_ORCHESTRATION_GUARDIAN_THRESHOLD = 70;
+export declare const DEFAULT_STEP_TIMEOUT_MS = 180000;
+export declare const DEFAULT_STEP_RETRY_POLICY: StepRetryPolicy;

package/dist/constants/orchestration-execution.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_STEP_RETRY_POLICY = exports.DEFAULT_STEP_TIMEOUT_MS = exports.DEFAULT_ORCHESTRATION_GUARDIAN_THRESHOLD = void 0;
+/** Default floor for Guardian when the client does not pass an explicit threshold. */
+exports.DEFAULT_ORCHESTRATION_GUARDIAN_THRESHOLD = 70;
+exports.DEFAULT_STEP_TIMEOUT_MS = 180_000;
+exports.DEFAULT_STEP_RETRY_POLICY = {
+    maxRetries: 2,
+    retryOn: 'transient',
+};

package/dist/constants/payload-schema-map.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PAYLOAD_SCHEMA_MAP — Canonical per-stage payload extraction schema.
+ *
+ * Law 32 (Constitution v2.7): Every workflow_artifacts stage must declare
+ * how its payload is extracted for display. Display components MUST use
+ * extractPayloadText() from this map rather than inline generic key loops.
+ *
+ * Shape:
+ *  scalarFields   — top-level string/number keys; first non-empty string wins
+ *  arrayField     — top-level array key to render as item list
+ *  itemFields     — keys within each array item to join (first non-null wins per item)
+ *  appendScalars  — additional top-level strings appended after array items
+ *  maxItems       — max array items to render (default 6)
+ */
+export type StagePayloadSchema = {
+    scalarFields?: readonly string[];
+    arrayField?: string;
+    itemFields?: readonly string[];
+    appendScalars?: readonly string[];
+    maxItems?: number;
+};
+export declare const PAYLOAD_SCHEMA_MAP: Readonly<Record<string, StagePayloadSchema>>;

package/dist/constants/payload-schema-map.js

@@ -0,0 +1,375 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAYLOAD_SCHEMA_MAP = void 0;
+exports.PAYLOAD_SCHEMA_MAP = {
+    // ── Fiction Specify (premise) ──────────────────────────────────────────────
+    premiseDraft: {
+        scalarFields: ['content', 'logline', 'narrativeEngine', 'storyPromise'],
+        arrayField: 'themes',
+        itemFields: ['question', 'name'],
+        appendScalars: ['emotionalRegister'],
+    },
+    themeArticulation: {
+        scalarFields: ['content', 'narrativeTone', 'overallMoralRegister'],
+        arrayField: 'themes',
+        itemFields: ['question', 'characterManifestation'],
+    },
+    premiseFinal: {
+        scalarFields: ['content', 'summary', 'logline'],
+    },
+    // ── Fiction Plan (story structure) ────────────────────────────────────────
+    actOutline: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'acts',
+        itemFields: ['title', 'dramaticFunction', 'protagonistArc'],
+        appendScalars: ['midpointInversion'],
+        maxItems: 5,
+    },
+    plotBeats: {
+        scalarFields: ['content'],
+        arrayField: 'beats',
+        itemFields: ['title', 'event'],
+        maxItems: 8,
+    },
+    narrativeArc: {
+        scalarFields: ['content', 'overallArcShape'],
+        arrayField: 'arcs',
+        itemFields: ['name', 'type', 'emotionalJourney', 'endingState'],
+        maxItems: 6,
+    },
+    storyStructureFinal: {
+        scalarFields: ['content', 'summary'],
+    },
+    // ── Fiction Schema (world ontology) ───────────────────────────────────────
+    worldOntologyDraft: {
+        scalarFields: ['content', 'worldDescription', 'summary'],
+        arrayField: 'elements',
+        itemFields: ['name', 'description', 'category'],
+        maxItems: 5,
+    },
+    factionRegistry: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'factions',
+        itemFields: ['name', 'storyRole'],
+        maxItems: 5,
+    },
+    loreSystemDraft: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'loreSystems',
+        itemFields: ['name', 'narrativeRole', 'type'],
+        maxItems: 5,
+    },
+    symbolRegistry: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'symbols',
+        itemFields: ['name', 'meaning', 'thematicFunction'],
+        maxItems: 5,
+    },
+    worldOntologyFinal: {
+        scalarFields: ['content', 'summary'],
+    },
+    // ── Fiction API (interaction systems) ─────────────────────────────────────
+    characterInteractionProtocol: {
+        scalarFields: ['content', 'overallSocialStructure'],
+        arrayField: 'protocols',
+        itemFields: ['name', 'powerDynamic'],
+        maxItems: 6,
+    },
+    dialogueSystemDraft: {
+        scalarFields: ['content', 'subtext'],
+        arrayField: 'registers',
+        itemFields: ['name', 'sentenceRhythm', 'flavourExample'],
+        maxItems: 6,
+    },
+    agencyRules: {
+        scalarFields: ['content', 'centralPowerBalance'],
+        arrayField: 'agencyRuleSets',
+        itemFields: ['entity', 'storyRole'],
+        maxItems: 6,
+    },
+    interactionSystemsFinal: {
+        scalarFields: ['content', 'summary'],
+    },
+    // ── Fiction UI (reader experience) ────────────────────────────────────────
+    voiceToneProfile: {
+        scalarFields: ['content', 'perspective', 'proseRegister', 'sentenceRhythm', 'interiorityLevel'],
+        arrayField: 'toneDescriptors',
+        itemFields: [],
+        maxItems: 4,
+    },
+    pacingGuide: {
+        scalarFields: ['content', 'tensionCurveShape', 'openingHookStrategy', 'chapterEndingConvention'],
+        arrayField: 'pacingTechniques',
+        itemFields: ['technique', 'effect'],
+        maxItems: 4,
+    },
+    immersionTechniques: {
+        scalarFields: ['content', 'worldBuildingDelivery'],
+        arrayField: 'techniques',
+        itemFields: ['technique', 'when'],
+        appendScalars: [],
+        maxItems: 4,
+    },
+    readerExperienceFinal: {
+        scalarFields: ['content', 'summary'],
+    },
+    // ── Fiction Tasks ──────────────────────────────────────────────────────────
+    sceneTaskDecomposition: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'tasks',
+        itemFields: ['sceneTitle', 'description', 'dramaticPurpose'],
+        maxItems: 6,
+    },
+    chapterSchedule: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'chapters',
+        itemFields: ['title', 'notes'],
+        appendScalars: ['totalManuscriptWords'],
+        maxItems: 6,
+    },
+    sceneTasksFinal: {
+        scalarFields: ['content', 'summary'],
+    },
+    // ── Fiction Implement (scene/chapter drafts) ───────────────────────────────
+    sceneDraft: {
+        scalarFields: ['content', 'prose', 'text', 'draft'],
+    },
+    chapterDraft: {
+        scalarFields: ['content', 'prose', 'text', 'draft'],
+    },
+    loreEntryDraft: {
+        scalarFields: ['content', 'entry', 'text'],
+    },
+    // ── Fiction Review ─────────────────────────────────────────────────────────
+    loreContinuityAudit: {
+        scalarFields: ['content', 'summary', 'verdict'],
+        arrayField: 'findings',
+        itemFields: ['issue', 'recommendation'],
+        maxItems: 5,
+    },
+    characterContinuityAudit: {
+        scalarFields: ['content', 'summary', 'verdict'],
+        arrayField: 'findings',
+        itemFields: ['issue', 'recommendation'],
+        maxItems: 5,
+    },
+    tonalDriftAudit: {
+        scalarFields: ['content', 'summary', 'verdict'],
+    },
+    tonalDriftCheck: {
+        scalarFields: ['content', 'summary', 'verdict'],
+    },
+    narrativePacingReview: {
+        scalarFields: ['content', 'summary', 'verdict'],
+    },
+    fictionEditorialFinal: {
+        scalarFields: ['content', 'summary', 'verdict'],
+    },
+    // ── Nonfiction Specify ─────────────────────────────────────────────────────
+    thesisStatement: {
+        scalarFields: ['content', 'thesis', 'thesisStatement', 'summary'],
+    },
+    thesisFramework: {
+        scalarFields: ['content', 'summary', 'thesis'],
+        arrayField: 'keyArguments',
+        itemFields: ['argument', 'claim', 'text'],
+        maxItems: 5,
+    },
+    definitionsAndClaims: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'claims',
+        itemFields: ['claimText', 'term', 'definition'],
+        maxItems: 5,
+    },
+    counterclaimFramework: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'counterclaims',
+        itemFields: ['claim', 'response'],
+        maxItems: 5,
+    },
+    nonfictionSpecFinal: {
+        scalarFields: ['content', 'summary'],
+    },
+    // ── Nonfiction Plan ────────────────────────────────────────────────────────
+    argumentStructure: {
+        scalarFields: ['content', 'summary', 'centralArgument'],
+        arrayField: 'chapters',
+        itemFields: ['title', 'centralClaim', 'summary'],
+        maxItems: 6,
+    },
+    chapterPlan: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'chapters',
+        itemFields: ['title', 'keyArgument', 'summary'],
+        maxItems: 6,
+    },
+    evidenceHierarchy: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'evidenceTiers',
+        itemFields: ['tier', 'description', 'criteria'],
+        maxItems: 5,
+    },
+    nonfictionArgumentFinal: {
+        scalarFields: ['content', 'summary'],
+    },
+    // ── Nonfiction Schema (claim ontology) ────────────────────────────────────
+    claimRegistry: {
+        scalarFields: ['content', 'centralThesisClaim'],
+        arrayField: 'claims',
+        itemFields: ['claimText', 'logicalRole'],
+        maxItems: 5,
+    },
+    definitionGlossary: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'terms',
+        itemFields: ['term', 'definition'],
+        maxItems: 5,
+    },
+    conceptTaxonomy: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'clusters',
+        itemFields: ['clusterName', 'anchorConcept'],
+        maxItems: 5,
+    },
+    nonfictionClaimOntologyFinal: {
+        scalarFields: ['content', 'summary'],
+    },
+    // ── Nonfiction API (source registry) ─────────────────────────────────────
+    nonfictionSourceRegistry: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'sources',
+        itemFields: ['title', 'authors', 'relevance'],
+        maxItems: 5,
+    },
+    evidenceGraph: {
+        scalarFields: ['content', 'summary'],
+    },
+    citationSystem: {
+        scalarFields: ['content', 'summary', 'citationStyle'],
+    },
+    nonfictionSourceRegistryFinal: {
+        scalarFields: ['content', 'summary'],
+    },
+    // ── Nonfiction UI (narrative voice) ──────────────────────────────────────
+    narrativeVoiceDraft: {
+        scalarFields: ['content', 'register', 'proseSample', 'readerRelationship'],
+    },
+    rhetoricalRegister: {
+        scalarFields: ['content', 'rhetoricalMode', 'argumentProgressionStyle'],
+    },
+    readerPositioning: {
+        scalarFields: ['content', 'openingContract', 'epistemicJourney', 'emotionalArc'],
+    },
+    nonfictionNarrativeVoiceFinal: {
+        scalarFields: ['content', 'summary'],
+    },
+    // ── Software Specify ──────────────────────────────────────────────────────
+    requirementsAnalysis: {
+        scalarFields: ['content', 'summary', 'overview'],
+        arrayField: 'requirements',
+        itemFields: ['title', 'description'],
+        maxItems: 5,
+    },
+    architectureDecisions: {
+        scalarFields: ['content', 'summary', 'rationale'],
+        arrayField: 'decisions',
+        itemFields: ['title', 'rationale'],
+        maxItems: 5,
+    },
+    technicalSpec: {
+        scalarFields: ['content', 'summary', 'overview'],
+    },
+    specFinal: {
+        scalarFields: ['content', 'summary'],
+    },
+    // ── Software Plan (architecture) ──────────────────────────────────────────
+    systemArchitecture: {
+        scalarFields: ['content', 'summary', 'overview'],
+        arrayField: 'components',
+        itemFields: ['name', 'responsibility'],
+        maxItems: 5,
+    },
+    dataModel: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'entities',
+        itemFields: ['name', 'description'],
+        maxItems: 5,
+    },
+    apiDesign: {
+        scalarFields: ['content', 'summary'],
+        arrayField: 'endpoints',
+        itemFields: ['path', 'description'],
+        maxItems: 5,
+    },
+    architectureFinal: {
+        scalarFields: ['content', 'summary'],
+    },
+    // ── Film production (media_film_* stages) ─────────────────────────────────
+    media_film_logline: {
+        scalarFields: ['logline', 'genre', 'tone', 'productionMode', 'targetAudience', 'aiUsagePolicyNotes'],
+        appendScalars: ['targetRuntimeSeconds'],
+    },
+    media_film_storyBible: {
+        scalarFields: ['premise', 'theme', 'emotionalArc', 'narrativeStructure', 'endingDirection', 'visualMetaphor'],
+        arrayField: 'worldRules',
+        itemFields: [],
+        maxItems: 8,
+    },
+    media_film_characterBible: {
+        arrayField: 'characters',
+        itemFields: ['name', 'role', 'visualDescription'],
+        maxItems: 8,
+    },
+    media_film_locationBible: {
+        arrayField: 'locations',
+        itemFields: ['name', 'description'],
+        maxItems: 6,
+    },
+    media_film_styleBible: {
+        scalarFields: ['lensLanguage', 'cameraMovement', 'colorPalette', 'lightingStyle', 'defaultNegativePrompt'],
+        arrayField: 'referenceFilms',
+        itemFields: [],
+        maxItems: 6,
+    },
+    media_film_sceneList: {
+        scalarFields: ['totalScenes', 'estimatedRuntimeSeconds'],
+        arrayField: 'scenes',
+        itemFields: ['sceneCode', 'title', 'purpose'],
+        maxItems: 12,
+    },
+    media_film_shotList: {
+        scalarFields: ['totalShots'],
+        appendScalars: ['totalShots'],
+    },
+    media_film_promptPack: {
+        scalarFields: ['provider', 'styleBibleVersion'],
+        arrayField: 'prompts',
+        itemFields: ['shotCode', 'positivePrompt'],
+        maxItems: 8,
+    },
+    media_film_clipManifest: {
+        scalarFields: ['totalClips', 'selectedClips', 'pendingReview'],
+        arrayField: 'coverageGaps',
+        itemFields: ['shotCode', 'reason'],
+        maxItems: 6,
+    },
+    media_film_editSequence: {
+        scalarFields: ['totalDurationSeconds', 'frameRate'],
+        arrayField: 'missingCoverage',
+        itemFields: ['shotCode', 'sceneCode', 'reason'],
+        maxItems: 6,
+    },
+    media_film_reviewReport: {
+        scalarFields: ['exportReady', 'exportBlockers', 'continuityScore'],
+        arrayField: 'findings',
+        itemFields: ['finding', 'recommendation'],
+        maxItems: 8,
+    },
+    media_film_exportPacket: {
+        scalarFields: ['exportType', 'status', 'coverageComplete'],
+    },
+    // ── Generic fallback (unknown stages) ─────────────────────────────────────
+    _generic: {
+        scalarFields: ['content', 'summary', 'description', 'text', 'overview'],
+    },
+};

package/dist/constants/phase-guardian.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Phase-level Guardian gating — thresholds for entering governance / build / ship.
+ * The aggregate compared to the threshold is from the **upstream** phase for that entry
+ * (Build uses Design, not the prior numeric phase). See getPhaseGuardianUpstreamPhase.
+ */
+/** Phase being entered → minimum average Guardian score required */
+export declare const PHASE_GUARDIAN_THRESHOLDS: Readonly<Record<3 | 4 | 5, number>>;
+/**
+ * First workflow nav step id in the entering phase (sidebar row for lock copy).
+ */
+export declare const PHASE_GUARDIAN_NAV_ENTRY_STEP: Readonly<Record<3 | 4 | 5, string>>;
+export declare function getPhaseGuardianThreshold(enteringPhase: number): number | undefined;
+/**
+ * Phase whose completed-step Guardian aggregate gates **entry** into `enteringPhase`.
+ * Build (4) uses Design (2), not Governance (3), so entry is not blocked by an empty Governance aggregate.
+ */
+export declare function getPhaseGuardianUpstreamPhase(enteringPhase: number): number | undefined;

package/dist/constants/phase-guardian.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Phase-level Guardian gating — thresholds for entering governance / build / ship.
+ * The aggregate compared to the threshold is from the **upstream** phase for that entry
+ * (Build uses Design, not the prior numeric phase). See getPhaseGuardianUpstreamPhase.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PHASE_GUARDIAN_NAV_ENTRY_STEP = exports.PHASE_GUARDIAN_THRESHOLDS = void 0;
+exports.getPhaseGuardianThreshold = getPhaseGuardianThreshold;
+exports.getPhaseGuardianUpstreamPhase = getPhaseGuardianUpstreamPhase;
+/** Phase being entered → minimum average Guardian score required */
+exports.PHASE_GUARDIAN_THRESHOLDS = {
+    3: 70,
+    4: 75,
+    5: 80,
+};
+/**
+ * First workflow nav step id in the entering phase (sidebar row for lock copy).
+ */
+exports.PHASE_GUARDIAN_NAV_ENTRY_STEP = {
+    3: "constitution",
+    4: "tasks",
+    5: "ci",
+};
+function getPhaseGuardianThreshold(enteringPhase) {
+    if (enteringPhase === 3 || enteringPhase === 4 || enteringPhase === 5) {
+        return exports.PHASE_GUARDIAN_THRESHOLDS[enteringPhase];
+    }
+    return undefined;
+}
+/**
+ * Phase whose completed-step Guardian aggregate gates **entry** into `enteringPhase`.
+ * Build (4) uses Design (2), not Governance (3), so entry is not blocked by an empty Governance aggregate.
+ */
+function getPhaseGuardianUpstreamPhase(enteringPhase) {
+    if (enteringPhase === 3 || enteringPhase === 4) {
+        return 2;
+    }
+    if (enteringPhase === 5) {
+        return 4;
+    }
+    return undefined;
+}