@shapeshift-labs/frontier-swarm 0.5.3 → 0.5.5

package/README.md

@@ -45,7 +45,13 @@ The published Frontier package family is generated from one shared package catal
 - [`@shapeshift-labs/frontier-lang-rust`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-rust): Rust projection adapter for Frontier Lang semantic documents, including structs, aliases, and action stubs.
 - [`@shapeshift-labs/frontier-lang-python`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-python): Python projection adapter for Frontier Lang semantic documents, including dataclasses, typed patch records, and action stubs.
 - [`@shapeshift-labs/frontier-lang-c`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-c): C header projection adapter for Frontier Lang semantic documents, including structs and action prototypes.
-- [`@shapeshift-labs/frontier-lang-compiler`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-compiler): Compiler facade for Frontier Lang source documents, including parse, check, hash, diagnostics, and projection to TypeScript, JavaScript, Rust, Python, and C.
+- [`@shapeshift-labs/frontier-lang-compiler`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-compiler): Compiler facade for Frontier Lang source documents, including parse, check, hash, diagnostics, projection to TypeScript, JavaScript, Rust, Python, and C, and native source-import adapters for semantic merge evidence.
+- [`@shapeshift-labs/frontier-lang-swift`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-swift): Swift source-language importer package for Frontier Lang semantic documents, including package-level metadata, SwiftSyntax adapter helpers, native import results, and semantic sidecar generation for SwiftSyntax/SwiftParser-shaped syntax trees.
+- [`@shapeshift-labs/frontier-lang-kotlin`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-kotlin): Kotlin PSI source-language importer package for Frontier Lang semantic documents, including package-level metadata, Kotlin PSI adapter helpers, native import results, and semantic sidecar generation for Kotlin PSI/KtFile-shaped syntax trees.
+- [`@shapeshift-labs/frontier-lang-java`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-java): Java source-language importer package for Frontier Lang semantic documents, including package-level metadata, Java AST adapter helpers, native import results, and semantic sidecar generation for javac/JDT/JavaParser-shaped ASTs.
+- [`@shapeshift-labs/frontier-lang-go`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-go): Go source-language importer package for Frontier Lang semantic documents, including package-level metadata, Go AST adapter helpers, native import results, and semantic sidecar generation for go/ast File or Package trees.
+- [`@shapeshift-labs/frontier-lang-csharp`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-csharp): C# Roslyn source-language importer package for Frontier Lang semantic documents, including package-level metadata, Roslyn adapter helpers, native import results, and semantic sidecar generation for SyntaxTree/SyntaxNode-shaped ASTs.
+- [`@shapeshift-labs/frontier-lang-clang`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-clang): Clang AST source-language importer package for Frontier Lang semantic documents, including package-level metadata, Clang AST JSON adapter helpers, native import results, and semantic sidecar generation for C/C++ translation units.
 - [`@shapeshift-labs/frontier-lang-cli`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-cli): Command line interface for parsing, checking, hashing, and emitting Frontier Lang projects.
 - [`@shapeshift-labs/frontier-lang`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang): Umbrella package for Frontier Lang kernel, parser, checker, and projection adapters.
 - [`@shapeshift-labs/frontier-kv`](https://www.npmjs.com/package/@shapeshift-labs/frontier-kv): Serializable in-memory key/value state for Frontier apps, including TTL, versioned compare-and-set, batched patch mutations, scans, watchers, snapshots, JSONL event evidence, and replay verification.
@@ -133,6 +139,12 @@ Package source repositories:
 - [`siliconjungle/-shapeshift-labs-frontier-lang-python`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-python)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-c`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-c)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-compiler`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-compiler)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-swift`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-swift)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-kotlin`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-kotlin)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-java`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-java)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-go`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-go)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-csharp`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-csharp)
+- [`siliconjungle/-shapeshift-labs-frontier-lang-clang`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-clang)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-cli`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-cli)
 - [`siliconjungle/-shapeshift-labs-frontier-lang`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang)
 - [`siliconjungle/-shapeshift-labs-frontier-kv`](https://github.com/siliconjungle/-shapeshift-labs-frontier-kv)
@@ -270,7 +282,7 @@ The scale APIs are runtime-neutral and serializable:
 - `createSwarmReviewPlan` samples or requires reviewer assignments,
 - `createSwarmMergePlan` blocks jobs with failed checks, required reviews, ownership violations, or conflicting changed paths,
 - job results include merge-readiness classification: `discovery-only`, `patch-candidate`, `verified-patch`, `rejected`, or `blocked`,
-- job results, merge bundles, queue overlays, and merge indexes can carry `semanticImport` summaries for imported symbols, semantic ownership regions, source projection readiness, and empty sidecar detection,
+- job results, merge bundles, queue overlays, and merge indexes can carry `semanticImport` summaries for imported symbols, semantic ownership regions, source projection/native compile readiness, and empty sidecar detection,
 - `ownershipRegions` allow hot files to be split into semantic regions such as `content.docs.*` or `adminSettings.quota.*`; merge conflict detection compares explicit changed regions when both sides report them and falls back to path conflicts when either side omits regions,
 - `createSwarmMergeBundle` builds a compact worker `merge.json` shape with touched owned files, patch path, evidence, verification, queue items satisfied, risk, and disposition,
 - `createSwarmQueueOverlay` and `deriveSwarmQueueStatus` keep central queue files immutable while deriving status from worker result overlays,
@@ -280,6 +292,7 @@ The scale APIs are runtime-neutral and serializable:
 - `createSwarmReviewerLanePlan` turns risky/conflicting merge bundles into reviewer-lane tasks,
 - `createSwarmRunStoreShards` describes sharded event/result/checkpoint paths for large run stores,
 - `createSwarmMergeAdmission` limits ready merges by count, touched paths/regions, and risk budget,
+- `createSwarmCoordinatorDashboard` and `querySwarmCoordinatorDashboard` combine merge index entries, queue overlays, evidence indexes, admission decisions, duplicate groups, semantic sidecar summaries, source citations, and worker liveness into one coordinator-query surface with a compact merge score per job,
 - `createSwarmPatchStackPlan` clusters compatible bundles into candidate patch stacks by lane, path, region, disposition, and risk so reviewers can evaluate batches instead of individual worker directories,
 - `createSwarmContextPack` gives workers compact task context: relevant files, API maps, known failures, focused/oracle commands, expected evidence, exclusions, evidence schema, playbooks, and explicit dead ends to avoid,
 - `createSwarmOracleCorpus` indexes deterministic reference artifacts such as traces, snapshots, classifications, expected outputs, or fixtures without assuming a project domain,

package/dist/index.d.ts

@@ -89,6 +89,8 @@ export declare const FRONTIER_SWARM_LANE_PLAYBOOK_KIND = "frontier.swarm.lane-pl
 export declare const FRONTIER_SWARM_LANE_PLAYBOOK_VERSION = 1;
 export declare const FRONTIER_SWARM_PATCH_STACK_PLAN_KIND = "frontier.swarm.patch-stack-plan";
 export declare const FRONTIER_SWARM_PATCH_STACK_PLAN_VERSION = 1;
+export declare const FRONTIER_SWARM_COORDINATOR_DASHBOARD_KIND = "frontier.swarm.coordinator-dashboard";
+export declare const FRONTIER_SWARM_COORDINATOR_DASHBOARD_VERSION = 1;
 export declare const FRONTIER_SWARM_DEFAULT_CODEX_COMPUTE_ID = "codex.gpt-5.5.xhigh";
 export declare const FRONTIER_SWARM_DEFAULT_MODEL = "gpt-5.5";
 export declare const FRONTIER_SWARM_DEFAULT_REASONING_EFFORT = "xhigh";
@@ -111,6 +113,8 @@ export type FrontierSwarmBlackboardEntryKind = 'fact' | 'divergence' | 'rejected
 export type FrontierSwarmProgressStatus = 'not-started' | 'declared' | 'implemented' | 'structure-verified' | 'visual-verified' | 'functional-verified' | 'collaboration-verified' | 'accepted' | 'rejected' | 'blocked' | string;
 export type FrontierSwarmAutoReviewFindingKind = 'stub-risk' | 'missing-evidence' | 'ownership-violation' | 'overlarge-patch' | 'weak-evidence' | 'strict-source-policy' | string;
 export type FrontierSwarmRebaseStatus = 'clean-apply' | 'textual-conflict' | 'semantic-overlap' | 'stale-evidence' | 'needs-rerun' | string;
+export type FrontierSwarmCoordinatorLiveness = 'running' | 'finished' | 'missing' | 'unknown' | string;
+export type FrontierSwarmCoordinatorAdmissionStatus = 'admitted' | 'deferred' | 'not-admissible' | 'unknown' | string;
 export interface FrontierSwarmComputeInput {
     id: string;
     kind?: FrontierSwarmComputeKind;
@@ -1005,6 +1009,15 @@ export interface FrontierSwarmSourceProjectionSummaryInput {
     needsReview?: number;
     blocked?: number;
 }
+export interface FrontierSwarmNativeCompileSummaryInput {
+    total?: number;
+    emitted?: number;
+    preserved?: number;
+    targetStubs?: number;
+    ready?: number;
+    needsReview?: number;
+    blocked?: number;
+}
 export interface FrontierSwarmSemanticImportSummaryInput {
     total?: number;
     selected?: number;
@@ -1020,6 +1033,7 @@ export interface FrontierSwarmSemanticImportSummaryInput {
     semanticIndex?: FrontierSwarmSemanticIndexSummaryInput;
     semanticSidecars?: FrontierSwarmSemanticSidecarSummaryInput;
     sourceProjections?: FrontierSwarmSourceProjectionSummaryInput;
+    nativeCompiles?: FrontierSwarmNativeCompileSummaryInput;
     readiness?: FrontierSwarmSemanticImportCounterInput;
     metadata?: unknown;
 }
@@ -1045,6 +1059,15 @@ export interface FrontierSwarmSourceProjectionSummary {
     needsReview: number;
     blocked: number;
 }
+export interface FrontierSwarmNativeCompileSummary {
+    total: number;
+    emitted: number;
+    preserved: number;
+    targetStubs: number;
+    ready: number;
+    needsReview: number;
+    blocked: number;
+}
 export interface FrontierSwarmSemanticImportSummary {
     total: number;
     selected: number;
@@ -1060,6 +1083,7 @@ export interface FrontierSwarmSemanticImportSummary {
     semanticIndex: FrontierSwarmSemanticIndexSummary;
     semanticSidecars: FrontierSwarmSemanticSidecarSummary;
     sourceProjections: FrontierSwarmSourceProjectionSummary;
+    nativeCompiles: FrontierSwarmNativeCompileSummary;
     readiness: Record<string, number>;
     metadata?: JsonObject;
 }
@@ -2445,6 +2469,140 @@ export interface FrontierSwarmPatchStack {
     conflicts: FrontierSwarmMergeConflict[];
     gateHints: string[];
 }
+export interface FrontierSwarmCoordinatorProcessInput {
+    pid?: number;
+    role?: string;
+    jobId?: string;
+    runId?: string;
+    status?: FrontierSwarmCoordinatorLiveness;
+    startedAt?: number;
+    lastSeenAt?: number;
+    command?: readonly string[];
+    metadata?: unknown;
+}
+export interface FrontierSwarmCoordinatorProcess {
+    pid?: number;
+    role: string;
+    jobId?: string;
+    runId?: string;
+    status: FrontierSwarmCoordinatorLiveness;
+    startedAt?: number;
+    lastSeenAt?: number;
+    command: string[];
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmCoordinatorSourceCitation {
+    path: string;
+    kind: string;
+    symbol?: string;
+    region?: string;
+    confidence?: number;
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmCoordinatorDashboardInput {
+    id?: string;
+    plan?: FrontierSwarmPlan;
+    run?: FrontierSwarmRun;
+    bundles?: readonly FrontierSwarmMergeBundle[];
+    mergeIndex?: FrontierSwarmMergeIndex;
+    queueOverlay?: FrontierSwarmQueueOverlay;
+    evidenceIndex?: FrontierSwarmEvidenceIndex;
+    admission?: FrontierSwarmMergeAdmission;
+    processes?: readonly FrontierSwarmCoordinatorProcessInput[];
+    generatedAt?: number;
+    metadata?: unknown;
+}
+export interface FrontierSwarmCoordinatorDashboard {
+    kind: typeof FRONTIER_SWARM_COORDINATOR_DASHBOARD_KIND;
+    version: typeof FRONTIER_SWARM_COORDINATOR_DASHBOARD_VERSION;
+    id: string;
+    runId?: string;
+    planId?: string;
+    generatedAt: number;
+    jobs: FrontierSwarmCoordinatorJob[];
+    duplicateGroups: FrontierSwarmCoordinatorDuplicateGroup[];
+    processes: FrontierSwarmCoordinatorProcess[];
+    byLane: Record<string, string[]>;
+    byDisposition: Record<string, string[]>;
+    byLiveness: Record<string, string[]>;
+    mergeIndex?: FrontierSwarmMergeIndex;
+    queueOverlay?: FrontierSwarmQueueOverlay;
+    evidenceIndex?: FrontierSwarmEvidenceIndex;
+    admission?: FrontierSwarmMergeAdmission;
+    summary: {
+        jobCount: number;
+        readyToApplyCount: number;
+        needsHumanPortCount: number;
+        failedEvidenceCount: number;
+        staleAgainstHeadCount: number;
+        duplicateGroupCount: number;
+        semanticSidecarCount: number;
+        semanticRegionCount: number;
+        averageMergeScore: number;
+    };
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmCoordinatorJob {
+    jobId: string;
+    taskId?: string;
+    lane?: string;
+    title?: string;
+    status: FrontierSwarmJobStatus;
+    liveness: FrontierSwarmCoordinatorLiveness;
+    mergeReadiness: FrontierSwarmMergeReadiness;
+    disposition: FrontierSwarmMergeDisposition;
+    riskLevel: FrontierSwarmRiskLevel;
+    mergeScore: number;
+    mergeScoreReasons: string[];
+    admissionStatus: FrontierSwarmCoordinatorAdmissionStatus;
+    admissionReasons: string[];
+    staleAgainstHead: boolean;
+    duplicateGroupId?: string;
+    duplicateOf?: string;
+    changedPaths: string[];
+    changedRegions: string[];
+    semanticRegions: string[];
+    ownershipViolations: string[];
+    patchPath?: string;
+    evidencePaths: string[];
+    primaryEvidencePath?: string;
+    sourceCitations: FrontierSwarmCoordinatorSourceCitation[];
+    tests: {
+        passed: number;
+        failed: number;
+        requiredFailed: number;
+    };
+    semanticImport?: FrontierSwarmSemanticImportSummary;
+    generatedAt: number;
+}
+export interface FrontierSwarmCoordinatorDuplicateGroup {
+    id: string;
+    key: string;
+    jobIds: string[];
+    reason: string;
+}
+export interface FrontierSwarmCoordinatorDashboardQuery {
+    jobId?: string;
+    lane?: string;
+    disposition?: FrontierSwarmMergeDisposition;
+    liveness?: FrontierSwarmCoordinatorLiveness;
+    admissionStatus?: FrontierSwarmCoordinatorAdmissionStatus;
+    pathIncludes?: string;
+    region?: string;
+    hasSemanticImport?: boolean;
+    hasSemanticRegions?: boolean;
+    staleAgainstHead?: boolean;
+    duplicateOnly?: boolean;
+    minMergeScore?: number;
+    maxMergeScore?: number;
+}
+export interface FrontierSwarmCoordinatorDashboardQueryResult {
+    jobs: FrontierSwarmCoordinatorJob[];
+    summary: {
+        jobCount: number;
+        averageMergeScore: number;
+    };
+}
 export interface FrontierSwarmProof {
     kind: typeof FRONTIER_SWARM_PROOF_KIND;
     version: typeof FRONTIER_SWARM_PROOF_VERSION;
@@ -2516,6 +2674,8 @@ export declare function checkSwarmUsageGovernor(governorInput: FrontierSwarmUsag
 }): FrontierSwarmUsageGovernorDecision;
 export declare function createSwarmLanePlaybook(input: FrontierSwarmLanePlaybookInput): FrontierSwarmLanePlaybook;
 export declare function createSwarmPatchStackPlan(input: FrontierSwarmPatchStackPlanInput): FrontierSwarmPatchStackPlan;
+export declare function createSwarmCoordinatorDashboard(input?: FrontierSwarmCoordinatorDashboardInput): FrontierSwarmCoordinatorDashboard;
+export declare function querySwarmCoordinatorDashboard(dashboard: FrontierSwarmCoordinatorDashboard, query?: FrontierSwarmCoordinatorDashboardQuery): FrontierSwarmCoordinatorDashboardQueryResult;
 export declare function resolveSwarmCompute(manifestInput: FrontierSwarmManifest | FrontierSwarmManifestInput, taskInput: FrontierSwarmTask | FrontierSwarmTaskInput): FrontierSwarmCompute;
 export declare function createSwarmProof(input: FrontierSwarmManifest | FrontierSwarmPlan | FrontierSwarmRun, options?: {
     generatedAt?: number;