@neuraloom/contracts 0.0.0-stage → 0.1.22

package/dist/constants/pipeline-step-stages.d.ts

@@ -0,0 +1,73 @@
+/**
+ * SSOT: pipeline stage IDs per workflow step (workflow_artifacts.stage_id).
+ * Consumed by buildWorkflowState and stub UIs that mirror pipeline shells.
+ */
+export declare const PIPELINE_STEP_STAGES: {
+    readonly integrations: readonly ["integrationsStatus"];
+    readonly repo: readonly ["repoSetup"];
+    readonly team: readonly ["teamConfig"];
+    readonly constitution: readonly ["constitutionDraft", "constitutionRules", "constitutionCompliance", "constitutionFinal"];
+    readonly guardian: readonly ["guardianValidation", "guardianReport"];
+    readonly knowledge: readonly ["knowledgeSourceSummary", "knowledgeDomainKnowledge", "knowledgeGraphEntries", "knowledgeFinal", "knowledgeCoverage"];
+    readonly analytics: readonly ["analyticsMetrics", "analyticsInsights"];
+    readonly api: readonly ["apiEndpointMap", "apiContract"];
+    readonly ci: readonly ["cicdCommands", "cicdWorkflowFile", "cicdValidation", "cicdCommitArtifact", "cicdRepoApply", "cicdFinal"];
+    readonly compliance: readonly ["complianceEvidence", "compliancePolicy", "complianceScore", "complianceRemediation", "complianceFinal"];
+    readonly deployments: readonly ["deployTargetConfig", "deployTrigger", "deployVercelResult", "deployStatusPersist", "deployFinal"];
+    readonly implement: readonly ["gateImportValidity", "gateContextContamination", "implementFilePlan", "implementCodeGen", "implementTests", "implementPrCreate", "implementGuardianReview", "implementFinal"];
+    readonly plan: readonly ["planArchitecture", "planDataFlow", "planModuleBoundaries", "planRisks", "planDeliveryPhases", "planFinal"];
+    readonly review: readonly ["reviewArtifact", "reviewCode", "reviewSecurity", "reviewReleaseDecision", "reviewFinal"];
+    readonly schema: readonly ["schemaDomainModel", "schemaBlueprint", "schemaRelations", "schemaMigration", "schemaSecurity", "schemaTypes"];
+    readonly specify: readonly ["specifyDomainModel", "specifyRequirements", "specifyAcceptanceCriteria", "specifyEdgeCases", "specifyConstraints"];
+    readonly tasks: readonly ["taskContextIntake", "taskArtifactCoverage", "taskWorkBreakdown", "taskDependencyGraph", "taskImplementationCards", "taskValidation", "taskFinalGraph"];
+    readonly ui: readonly ["uiScreenMap", "uiComponentContract"];
+    readonly monitor: readonly ["monitor.bootstrap"];
+    readonly writing_specify: readonly ["thesisDomain", "thesisStatement", "thesisCounterclaims", "thesisDefinitions", "thesisFinal"];
+    readonly writing_plan: readonly ["outlineDomain", "outlineStructure", "outlineChapters", "outlineDependencies", "outlineFinal"];
+    readonly writing_implement: readonly ["draftScaffold", "draftProse", "draftCitations", "draftFinal", "chapterDraft", "chapterRevisionDelta", "chapterContinuityLedger", "artifactDependency"];
+    readonly writing_review: readonly ["editorialClaimAudit", "editorialContradictions", "editorialStyleDrift", "editorialMissingSources", "editorialFindingsFinal", "chapterRevisionBrief", "chapterRevisionQAReport"];
+    readonly writing_deployments: readonly ["publicationPackage", "audioProductionSettings", "audiobookVoiceProfile", "audiobookNarrationScript", "audiobookNarrationTiming", "audiobookProductionTimeline", "audiobookSoundCueSheet", "audiobookSoundAssetBundle", "audiobookMixPlan", "audiobookMixedChapterAudio", "audiobookQaReport", "audiobookVisualStoryboard", "audiobookStillImagePromptSet", "audiobookMotionStoryCueSheet", "audiobookProductionManifest", "audiobookEmbedPackage", "audiobookElevenLabsStudioProject"];
+    readonly writing_schema: readonly ["definitionsGlossary", "definitionsClaims", "definitionsConceptMap", "definitionsFinal"];
+    readonly writing_api: readonly ["sourceRegistryScan", "sourceRegistrySources", "sourceRegistryFinal"];
+    readonly writing_ui: readonly ["styleVoiceProfile", "styleRules", "styleProseExamples", "styleSystemFinal"];
+    readonly writing_constitution: readonly ["constitutionMission", "constitutionPrinciples", "constitutionGates", "constitutionWritingFinal"];
+    readonly writing_guardian: readonly ["guardianCoherence", "guardianCompliance", "guardianGapAnalysis", "guardianFinal"];
+    readonly writing_argument_map: readonly ["argumentMapClaimExtraction", "argumentMapDependencyMapping", "argumentMapFinal"];
+    readonly writing_counterclaim_framework: readonly ["counterclaimSurvey", "counterclaimFrameworkFinal"];
+    readonly writing_tasks: readonly ["writingTasksScan", "writingTasksFinal"];
+    readonly writing_draft_all: readonly ["chapterDraft", "manuscriptDraft"];
+    readonly writing_ci: readonly ["manuscriptChecksReport"];
+    readonly fiction_specify: readonly ["premiseDraft", "themeArticulation", "premiseFinal"];
+    readonly fiction_plan: readonly ["actOutline", "plotBeats", "narrativeArc", "storyStructureFinal"];
+    readonly fiction_schema: readonly ["worldOntologyDraft", "factionRegistry", "loreSystemDraft", "symbolRegistry", "worldOntologyFinal"];
+    readonly fiction_api: readonly ["characterInteractionProtocol", "dialogueSystemDraft", "agencyRules", "interactionSystemsFinal"];
+    readonly fiction_ui: readonly ["voiceToneProfile", "pacingGuide", "immersionTechniques", "readerExperienceFinal"];
+    readonly fiction_tasks: readonly ["sceneTaskDecomposition", "chapterSchedule", "sceneTasksFinal"];
+    readonly fiction_implement: readonly ["sceneDraft", "chapterDraft", "loreEntryDraft"];
+    readonly fiction_review: readonly ["loreContinuityAudit", "characterContinuityAudit", "tonalDriftCheck", "narrativePacingReview", "fictionEditorialFinal"];
+    readonly nonfiction_specify: readonly ["thesisDraft", "thesisRefinement", "audienceProfile", "nonfictionThesisFinal"];
+    readonly nonfiction_plan: readonly ["argumentStructure", "chapterPlan", "evidenceHierarchy", "nonfictionArgumentFinal"];
+    readonly nonfiction_schema: readonly ["claimRegistry", "definitionGlossary", "conceptTaxonomy", "nonfictionClaimOntologyFinal"];
+    readonly nonfiction_api: readonly ["nonfictionSourceRegistry", "evidenceGraph", "citationSystem", "nonfictionSourceRegistryFinal"];
+    readonly nonfiction_ui: readonly ["narrativeVoiceDraft", "rhetoricalRegister", "readerPositioning", "nonfictionNarrativeVoiceFinal"];
+    readonly nonfiction_tasks: readonly ["researchTaskDecomposition", "sourceValidation", "nonfictionChapterSchedule", "nonfictionResearchTasksFinal"];
+    readonly nonfiction_implement: readonly ["argumentProse", "evidenceIntegration", "nonfictionDraftFinal"];
+    readonly nonfiction_review: readonly ["sourceQualityAudit", "contradictionAnalysis", "hallucinationCheck", "rhetoricalBalanceReview", "nonfictionPeerReviewFinal"];
+};
+/** Canonical count of `implement` workflow artifact stages (terminal payloads / orchestration SSOT). */
+export declare const IMPLEMENT_PIPELINE_STAGE_COUNT: 8;
+/** Accepted workflow_artifacts rows for a complete software_app tasks pipeline (7 stages). */
+export declare const TASKS_PIPELINE_STAGE_TOTAL: 7;
+/** Union of all `stage_id` values listed in PIPELINE_STEP_STAGES (workflow_artifacts / pipeline UI). */
+export type PipelineStageId = (typeof PIPELINE_STEP_STAGES)[keyof typeof PIPELINE_STEP_STAGES][number];
+/**
+ * Resolve pipeline stage IDs for a given kind + step.
+ *
+ * This function is a compatibility wrapper. New code should call
+ * getWorkflowStageIds(resolveVariantFromKind(kind), stepId) directly.
+ *
+ * For steps registered in the WorkflowChannelRegistry the registry is
+ * authoritative. For steps only in PIPELINE_STEP_STAGES (e.g. deployments,
+ * constitution, guardian, analytics) the legacy lookup is retained.
+ */
+export declare function getPipelineStages(kind: string | undefined | null, stepId: string): readonly PipelineStageId[];

package/dist/constants/pipeline-step-stages.js

@@ -0,0 +1,342 @@
+"use strict";
+/**
+ * SSOT: pipeline stage IDs per workflow step (workflow_artifacts.stage_id).
+ * Consumed by buildWorkflowState and stub UIs that mirror pipeline shells.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TASKS_PIPELINE_STAGE_TOTAL = exports.IMPLEMENT_PIPELINE_STAGE_COUNT = exports.PIPELINE_STEP_STAGES = void 0;
+exports.getPipelineStages = getPipelineStages;
+const workflow_artifacts_schema_1 = require("../schemas/ai/workflow-artifacts.schema");
+exports.PIPELINE_STEP_STAGES = {
+    integrations: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.integrationsStatus,
+    ],
+    repo: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.repoSetup,
+    ],
+    team: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.teamConfig,
+    ],
+    constitution: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.constitutionDraft,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.constitutionRules,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.constitutionCompliance,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.constitutionFinal,
+    ],
+    guardian: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.guardianValidation,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.guardianReport,
+    ],
+    knowledge: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.knowledgeSourceSummary,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.knowledgeDomainKnowledge,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.knowledgeGraphEntries,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.knowledgeFinal,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.knowledgeCoverage,
+    ],
+    analytics: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.analyticsMetrics,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.analyticsInsights,
+    ],
+    api: ["apiEndpointMap", "apiContract"],
+    ci: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.cicdCommands,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.cicdWorkflowFile,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.cicdValidation,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.cicdCommitArtifact,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.cicdRepoApply,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.cicdFinal,
+    ],
+    compliance: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.complianceEvidence,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.compliancePolicy,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.complianceScore,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.complianceRemediation,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.complianceFinal,
+    ],
+    deployments: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.deployTargetConfig,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.deployTrigger,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.deployVercelResult,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.deployStatusPersist,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.deployFinal,
+    ],
+    implement: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.gateImportValidity,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.gateContextContamination,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.implementFilePlan,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.implementCodeGen,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.implementTests,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.implementPrCreate,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.implementGuardianReview,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.implementFinal,
+    ],
+    plan: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.planArchitecture,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.planDataFlow,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.planModuleBoundaries,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.planRisks,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.planDeliveryPhases,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.planFinal,
+    ],
+    review: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.reviewArtifact,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.reviewCode,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.reviewSecurity,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.reviewReleaseDecision,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.reviewFinal,
+    ],
+    schema: [
+        "schemaDomainModel",
+        "schemaBlueprint",
+        "schemaRelations",
+        "schemaMigration",
+        "schemaSecurity",
+        "schemaTypes",
+    ],
+    specify: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.specifyDomainModel,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.specifyRequirements,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.specifyAcceptanceCriteria,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.specifyEdgeCases,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.specifyConstraints,
+    ],
+    tasks: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.taskContextIntake,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.taskArtifactCoverage,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.taskWorkBreakdown,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.taskDependencyGraph,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.taskImplementationCards,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.taskValidation,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.taskFinalGraph,
+    ],
+    ui: ["uiScreenMap", "uiComponentContract"],
+    monitor: ["monitor.bootstrap"],
+    // Writing mode pipeline stages (keyed by writing step name)
+    writing_specify: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.thesisDomain,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.thesisStatement,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.thesisCounterclaims,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.thesisDefinitions,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.thesisFinal,
+    ],
+    writing_plan: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.outlineDomain,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.outlineStructure,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.outlineChapters,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.outlineDependencies,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.outlineFinal,
+    ],
+    writing_implement: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.draftScaffold,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.draftProse,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.draftCitations,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.draftFinal,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.chapterDraft,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.chapterRevisionDelta,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.chapterContinuityLedger,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.artifactDependency,
+    ],
+    writing_review: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.editorialClaimAudit,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.editorialContradictions,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.editorialStyleDrift,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.editorialMissingSources,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.editorialFindingsFinal,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.chapterRevisionBrief,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.chapterRevisionQAReport,
+    ],
+    writing_deployments: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.publicationPackage,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audioProductionSettings,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookVoiceProfile,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookNarrationScript,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookNarrationTiming,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookProductionTimeline,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookSoundCueSheet,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookSoundAssetBundle,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookMixPlan,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookMixedChapterAudio,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookQaReport,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookVisualStoryboard,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookStillImagePromptSet,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookMotionStoryCueSheet,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookProductionManifest,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookEmbedPackage,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.audiobookElevenLabsStudioProject,
+    ],
+    writing_schema: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.definitionsGlossary,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.definitionsClaims,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.definitionsConceptMap,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.definitionsFinal,
+    ],
+    writing_api: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.sourceRegistryScan,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.sourceRegistrySources,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.sourceRegistryFinal,
+    ],
+    writing_ui: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.styleVoiceProfile,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.styleRules,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.styleProseExamples,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.styleSystemFinal,
+    ],
+    writing_constitution: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.constitutionMission,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.constitutionPrinciples,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.constitutionGates,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.constitutionWritingFinal,
+    ],
+    writing_guardian: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.guardianCoherence,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.guardianCompliance,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.guardianGapAnalysis,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.guardianFinal,
+    ],
+    writing_argument_map: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.argumentMapClaimExtraction,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.argumentMapDependencyMapping,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.argumentMapFinal,
+    ],
+    writing_counterclaim_framework: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.counterclaimSurvey,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.counterclaimFrameworkFinal,
+    ],
+    writing_tasks: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.writingTasksScan,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.writingTasksFinal,
+    ],
+    writing_draft_all: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.chapterDraft,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.manuscriptDraft,
+    ],
+    writing_ci: [workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.manuscriptChecksReport],
+    // Fiction mode pipeline stages (keyed by fiction step name)
+    fiction_specify: ['premiseDraft', 'themeArticulation', 'premiseFinal'],
+    fiction_plan: ['actOutline', 'plotBeats', 'narrativeArc', 'storyStructureFinal'],
+    fiction_schema: ['worldOntologyDraft', 'factionRegistry', 'loreSystemDraft', 'symbolRegistry', 'worldOntologyFinal'],
+    fiction_api: ['characterInteractionProtocol', 'dialogueSystemDraft', 'agencyRules', 'interactionSystemsFinal'],
+    fiction_ui: ['voiceToneProfile', 'pacingGuide', 'immersionTechniques', 'readerExperienceFinal'],
+    fiction_tasks: ['sceneTaskDecomposition', 'chapterSchedule', 'sceneTasksFinal'],
+    fiction_implement: ['sceneDraft', 'chapterDraft', 'loreEntryDraft'],
+    fiction_review: [
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.loreContinuityAudit,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.characterContinuityAudit,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.tonalDriftCheck,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.narrativePacingReview,
+        workflow_artifacts_schema_1.WORKFLOW_ARTIFACT_TYPE.fictionEditorialFinal,
+    ],
+    // Nonfiction mode pipeline stages (keyed by nonfiction step name)
+    nonfiction_specify: ['thesisDraft', 'thesisRefinement', 'audienceProfile', 'nonfictionThesisFinal'],
+    nonfiction_plan: ['argumentStructure', 'chapterPlan', 'evidenceHierarchy', 'nonfictionArgumentFinal'],
+    nonfiction_schema: ['claimRegistry', 'definitionGlossary', 'conceptTaxonomy', 'nonfictionClaimOntologyFinal'],
+    nonfiction_api: ['nonfictionSourceRegistry', 'evidenceGraph', 'citationSystem', 'nonfictionSourceRegistryFinal'],
+    nonfiction_ui: ['narrativeVoiceDraft', 'rhetoricalRegister', 'readerPositioning', 'nonfictionNarrativeVoiceFinal'],
+    nonfiction_tasks: ['researchTaskDecomposition', 'sourceValidation', 'nonfictionChapterSchedule', 'nonfictionResearchTasksFinal'],
+    nonfiction_implement: ['argumentProse', 'evidenceIntegration', 'nonfictionDraftFinal'],
+    nonfiction_review: ['sourceQualityAudit', 'contradictionAnalysis', 'hallucinationCheck', 'rhetoricalBalanceReview', 'nonfictionPeerReviewFinal'],
+};
+/** Canonical count of `implement` workflow artifact stages (terminal payloads / orchestration SSOT). */
+exports.IMPLEMENT_PIPELINE_STAGE_COUNT = exports.PIPELINE_STEP_STAGES.implement.length;
+/** Accepted workflow_artifacts rows for a complete software_app tasks pipeline (7 stages). */
+exports.TASKS_PIPELINE_STAGE_TOTAL = exports.PIPELINE_STEP_STAGES.tasks.length;
+const resolve_workflow_variant_1 = require("../workflow/resolve-workflow-variant");
+const channel_registry_1 = require("../workflow/channel-registry");
+// ─── Legacy Stage Maps (retained for PIPELINE_STEP_STAGES direct-access callers) ──
+const WRITING_STAGE_MAP = {
+    specify: 'writing_specify',
+    plan: 'writing_plan',
+    implement: 'writing_implement',
+    review: 'writing_review',
+    deployments: 'writing_deployments',
+    schema: 'writing_schema',
+    api: 'writing_api',
+    ui: 'writing_ui',
+    constitution: 'writing_constitution',
+    guardian: 'writing_guardian',
+    argument_map: 'writing_argument_map',
+    counterclaim_framework: 'writing_counterclaim_framework',
+    tasks: 'writing_tasks',
+    draft_all: 'writing_draft_all',
+    ci: 'writing_ci',
+};
+const FICTION_STAGE_MAP = {
+    specify: 'fiction_specify',
+    plan: 'fiction_plan',
+    schema: 'fiction_schema',
+    api: 'fiction_api',
+    ui: 'fiction_ui',
+    guardian: 'writing_guardian',
+    tasks: 'fiction_tasks',
+    implement: 'fiction_implement',
+    review: 'fiction_review',
+};
+const NONFICTION_STAGE_MAP = {
+    specify: 'nonfiction_specify',
+    plan: 'nonfiction_plan',
+    schema: 'nonfiction_schema',
+    api: 'nonfiction_api',
+    ui: 'nonfiction_ui',
+    constitution: 'writing_constitution',
+    guardian: 'writing_guardian',
+    tasks: 'nonfiction_tasks',
+    implement: 'nonfiction_implement',
+    review: 'nonfiction_review',
+};
+/**
+ * Resolve pipeline stage IDs for a given kind + step.
+ *
+ * This function is a compatibility wrapper. New code should call
+ * getWorkflowStageIds(resolveVariantFromKind(kind), stepId) directly.
+ *
+ * For steps registered in the WorkflowChannelRegistry the registry is
+ * authoritative. For steps only in PIPELINE_STEP_STAGES (e.g. deployments,
+ * constitution, guardian, analytics) the legacy lookup is retained.
+ */
+function getPipelineStages(kind, stepId) {
+    // Attempt registry resolution first for the four critical steps.
+    const variant = (0, resolve_workflow_variant_1.resolveVariantFromKind)(kind ?? undefined);
+    const registryStages = (0, channel_registry_1.getWorkflowStageIds)(variant, stepId);
+    if (registryStages.length > 0) {
+        return registryStages;
+    }
+    // Legacy fallback — retains exact historical behaviour for non-registry steps.
+    if (kind === 'fiction') {
+        const fictionKey = FICTION_STAGE_MAP[stepId];
+        if (fictionKey !== undefined)
+            return exports.PIPELINE_STEP_STAGES[fictionKey];
+        if (stepId === 'constitution') {
+            return exports.PIPELINE_STEP_STAGES.writing_constitution;
+        }
+        const softwareKey = stepId;
+        return softwareKey in exports.PIPELINE_STEP_STAGES ? exports.PIPELINE_STEP_STAGES[softwareKey] : [];
+    }
+    if (kind === 'nonfiction') {
+        const nonfictionKey = NONFICTION_STAGE_MAP[stepId];
+        if (nonfictionKey !== undefined)
+            return exports.PIPELINE_STEP_STAGES[nonfictionKey];
+        const softwareKey = stepId;
+        return softwareKey in exports.PIPELINE_STEP_STAGES ? exports.PIPELINE_STEP_STAGES[softwareKey] : [];
+    }
+    if (kind === 'research') {
+        const researchWritingStepKeys = {
+            constitution: 'writing_constitution',
+            guardian: 'writing_guardian',
+        };
+        const researchKey = researchWritingStepKeys[stepId];
+        if (researchKey !== undefined)
+            return exports.PIPELINE_STEP_STAGES[researchKey];
+        const softwareKey = stepId;
+        return softwareKey in exports.PIPELINE_STEP_STAGES ? exports.PIPELINE_STEP_STAGES[softwareKey] : [];
+    }
+    if ((0, channel_registry_1.isSoftwareAppCompletionSpine)((0, resolve_workflow_variant_1.resolveVariantFromKind)(kind))) {
+        const key = stepId;
+        return key in exports.PIPELINE_STEP_STAGES ? exports.PIPELINE_STEP_STAGES[key] : [];
+    }
+    const writingKey = WRITING_STAGE_MAP[stepId];
+    if (writingKey !== undefined)
+        return exports.PIPELINE_STEP_STAGES[writingKey];
+    const softwareKey = stepId;
+    return softwareKey in exports.PIPELINE_STEP_STAGES ? exports.PIPELINE_STEP_STAGES[softwareKey] : [];
+}

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

@@ -0,0 +1,29 @@
+/**
+ * Project Control Navigation - SSOT
+ * Sprint 43A: System pages for project-level monitoring and control
+ * Separate from workflow steps (which generate artifacts)
+ */
+/** Sidebar treatment for Controls links (workflow hub — issue #379). */
+export type ProjectControlAvailability = 'implemented' | 'coming_soon';
+export interface ProjectControlPage {
+    id: string;
+    label: string;
+    href: string;
+    icon: string;
+    description: string;
+    category: 'monitor' | 'control' | 'settings';
+    order: number;
+    /** Defaults to implemented when omitted. */
+    availability?: ProjectControlAvailability;
+}
+/**
+ * Project-level system pages
+ * These are NOT workflow steps - they're monitoring/control interfaces
+ */
+export declare const PROJECT_CONTROL_PAGES: ProjectControlPage[];
+/**
+ * Global Command Center (Mission Control) — external to project pages.
+ * This is the href used to link to the global Mission Control from within project sidebars.
+ */
+export declare const COMMAND_CENTER_HREF: "/mission-control";
+export type ProjectControlPageId = typeof PROJECT_CONTROL_PAGES[number]['id'];

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

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Project Control Navigation - SSOT
+ * Sprint 43A: System pages for project-level monitoring and control
+ * Separate from workflow steps (which generate artifacts)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMAND_CENTER_HREF = exports.PROJECT_CONTROL_PAGES = void 0;
+/**
+ * Project-level system pages
+ * These are NOT workflow steps - they're monitoring/control interfaces
+ */
+exports.PROJECT_CONTROL_PAGES = [
+    {
+        id: 'monitor',
+        label: 'Monitor',
+        href: '/monitor',
+        icon: 'Monitor',
+        description: 'Operational monitoring and health dashboard for this project',
+        category: 'monitor',
+        order: 1,
+        availability: 'coming_soon',
+    },
+    {
+        id: 'approvals',
+        label: 'Approvals',
+        href: '/approvals',
+        icon: 'CheckSquare',
+        description: 'Review and approve pending AI agent actions for this project',
+        category: 'control',
+        order: 3
+    },
+    {
+        id: 'telemetry',
+        label: 'Guardian Telemetry',
+        href: '/telemetry',
+        icon: 'BarChart3',
+        description: 'Real-time AI metrics, Guardian scores, and compliance analytics',
+        category: 'monitor',
+        order: 4
+    },
+    {
+        id: 'settings',
+        label: 'Settings & Export',
+        href: '/settings',
+        icon: 'Settings',
+        description: 'Project settings, BMAD metrics, and export controls',
+        category: 'settings',
+        order: 5
+    },
+    {
+        id: 'quality',
+        label: 'Quality & Control',
+        href: '/quality',
+        icon: 'Shield',
+        description: 'Workflow gate status, control artifacts, policy findings, and task capsules.',
+        category: 'control',
+        order: 2,
+    }
+];
+/**
+ * Global Command Center (Mission Control) — external to project pages.
+ * This is the href used to link to the global Mission Control from within project sidebars.
+ */
+exports.COMMAND_CENTER_HREF = '/mission-control';

package/dist/constants/software-index-targets.d.ts

@@ -0,0 +1,17 @@
+/**
+ * First-class NeuroNetIQ software products that NeuraLoom indexes as
+ * software_app projects. This is a catalog, not a fourth product app.
+ * SurveyMappingMono is SurveyIQ.
+ */
+export declare const SOFTWARE_INDEX_TARGET_IDS: readonly ["loomlab", "spatialiq", "surveyiq"];
+export type SoftwareIndexTargetId = (typeof SOFTWARE_INDEX_TARGET_IDS)[number];
+export type SoftwareIndexTarget = {
+    readonly id: SoftwareIndexTargetId;
+    readonly owner: 'NeuroNetIQ';
+    readonly repo: string;
+    readonly productName: string;
+    readonly githubFullName: string;
+};
+export declare const SOFTWARE_INDEX_TARGETS: readonly SoftwareIndexTarget[];
+export declare function matchSoftwareIndexTarget(repoFullName: string): SoftwareIndexTarget | null;
+export declare function otherSoftwareIndexTargets(repoFullName: string): readonly SoftwareIndexTarget[];

package/dist/constants/software-index-targets.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * First-class NeuroNetIQ software products that NeuraLoom indexes as
+ * software_app projects. This is a catalog, not a fourth product app.
+ * SurveyMappingMono is SurveyIQ.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOFTWARE_INDEX_TARGETS = exports.SOFTWARE_INDEX_TARGET_IDS = void 0;
+exports.matchSoftwareIndexTarget = matchSoftwareIndexTarget;
+exports.otherSoftwareIndexTargets = otherSoftwareIndexTargets;
+exports.SOFTWARE_INDEX_TARGET_IDS = ['loomlab', 'spatialiq', 'surveyiq'];
+exports.SOFTWARE_INDEX_TARGETS = [
+    {
+        id: 'loomlab',
+        owner: 'NeuroNetIQ',
+        repo: 'LoomLab',
+        productName: 'LoomLab',
+        githubFullName: 'NeuroNetIQ/LoomLab',
+    },
+    {
+        id: 'spatialiq',
+        owner: 'NeuroNetIQ',
+        repo: 'SpatialIQ',
+        productName: 'SpatialIQ',
+        githubFullName: 'NeuroNetIQ/SpatialIQ',
+    },
+    {
+        id: 'surveyiq',
+        owner: 'NeuroNetIQ',
+        repo: 'SurveyMappingMono',
+        productName: 'SurveyIQ',
+        githubFullName: 'NeuroNetIQ/SurveyMappingMono',
+    },
+];
+const BY_FULL_NAME = new Map(exports.SOFTWARE_INDEX_TARGETS.map((target) => [target.githubFullName.toLowerCase(), target]));
+function matchSoftwareIndexTarget(repoFullName) {
+    const key = repoFullName.trim().toLowerCase();
+    return BY_FULL_NAME.get(key) ?? null;
+}
+function otherSoftwareIndexTargets(repoFullName) {
+    const self = matchSoftwareIndexTarget(repoFullName);
+    if (self === null) {
+        return exports.SOFTWARE_INDEX_TARGETS;
+    }
+    return exports.SOFTWARE_INDEX_TARGETS.filter((target) => target.id !== self.id);
+}

package/dist/constants/step-tools.d.ts

@@ -0,0 +1,32 @@
+export type WorkflowToolId = 'web_search' | 'file_search' | 'db_introspect' | 'db_validate_migration' | 'repo_scan' | 'repo_get_file_tree' | 'code_write_proposal' | 'github_create_pr_proposal' | 'knowledge_query' | 'query_route_inventory' | 'query_workflow_registry' | 'query_code_relationships';
+export interface WorkflowToolDef {
+    readonly id: WorkflowToolId;
+    readonly description: string;
+    /** True for tools that propose changes but never directly mutate prod (this sprint). */
+    readonly proposalOnly: boolean;
+    /** Tools that perform any kind of write — even proposal-only. */
+    readonly category: 'read' | 'propose' | 'mutate';
+}
+export declare const WORKFLOW_TOOLS: Record<WorkflowToolId, WorkflowToolDef>;
+/** Tools allowed PER WORKFLOW STEP. SSOT — no route file may hardcode tools. */
+export declare const STEP_TOOL_REGISTRY: {
+    readonly specify: readonly ["web_search", "file_search"];
+    readonly plan: readonly ["web_search", "file_search"];
+    readonly schema: readonly ["db_introspect", "db_validate_migration"];
+    readonly repository: readonly ["repo_scan", "repo_get_file_tree", "query_route_inventory", "query_workflow_registry", "query_code_relationships"];
+    readonly implement: readonly ["code_write_proposal", "github_create_pr_proposal"];
+    readonly knowledge: readonly ["file_search", "knowledge_query"];
+    readonly api: readonly [];
+    readonly ui: readonly [];
+    readonly constitution: readonly [];
+    readonly tasks: readonly [];
+    readonly review: readonly [];
+    readonly compliance: readonly [];
+    readonly analytics: readonly [];
+    readonly pipeline: readonly [];
+};
+export type WorkflowStepIdWithTools = keyof typeof STEP_TOOL_REGISTRY;
+/** Resolve the allowed tool list for a workflow step. Returns [] for unknown steps. */
+export declare function getToolsForStep(stepId: string): ReadonlyArray<WorkflowToolId>;
+/** Prior workflow step (by workflow_step_id) used for OpenAI previous_response_id chaining. */
+export declare const STEP_CHAIN_PARENT: Readonly<Record<string, string | undefined>>;