@decantr/core - npm Package Compare versions

Comparing version 3.8.2 to 3.9.0

dist/index.d.ts

 import { EssenceV4, StructurePage, EssenceFile } from '@decantr/essence-spec';
-import { Pattern, ResolvedPreset, Theme, ContentResolver } from '@decantr/registry';
+import { Pattern, ResolvedPreset, Theme, ContentResolver } from '@decantr/content';
 
@@ -474,2 +474,12 @@ type IRNodeType = 'app' | 'shell' | 'page' | 'pattern' | 'grid' | 'nav' | 'store';
 }
+interface GraphChangedFileImpact {
+    changedFiles: string[];
+    matchedFiles: Array<{
+        file: string;
+        sourceNodeIds: string[];
+    }>;
+    unresolvedFiles: string[];
+    sourceNodeIds: string[];
+    context: GraphImpactContext | null;
+}
 interface GraphStore {
@@ -513,2 +523,8 @@ open(projectRoot: string): Promise<void>;
 declare function buildGraphImpactContext(snapshot: GraphSnapshot | null | undefined, seed: string | string[], options?: BuildGraphImpactContextOptions): GraphImpactContext | null;
+/**
+ * Resolve Git-changed files to graph source nodes before traversing impact.
+ * Unresolved paths stay explicit so callers cannot mistake missing graph
+ * coverage for an empty governance delta.
+ */
+declare function buildChangedFileGraphImpact(snapshot: GraphSnapshot | null | undefined, changedFiles: string[], options?: BuildGraphImpactContextOptions): GraphChangedFileImpact;
 declare function buildGraphSnapshotFromEssence(essence: EssenceV4, options?: BuildGraphSnapshotFromEssenceOptions): GraphSnapshot;
@@ -938,3 +954,3 @@ declare function buildGraphSnapshotFromIR(ir: IRAppNode, options?: BuildGraphSnapshotFromIROptions): GraphSnapshot;
     /**
-     * The fully-resolved registry theme record, including `decorator_definitions`
+     * The fully-resolved content theme record, including `decorator_definitions`
      * and other rich theme data not carried in the lite IR `theme` node.
@@ -949,3 +965,3 @@ * Consumers (e.g. pack builders) need this to render decorator contracts
  *   1. Validate Essence against schema + guard rules
- *   2. Resolve all references (patterns, theme, wiring) from registry
+ *   2. Resolve all references (patterns, theme, wiring) from content
  *   3. Build framework-agnostic IR tree
@@ -1028,2 +1044,2 @@ *   4. Return IR (no code generation — that's the consumer's job)
 
-export { type BuildContractCapsuleOptions, type BuildGraphImpactContextOptions, type BuildGraphRouteContextOptions, type BuildGraphSnapshotFromEssenceOptions, type BuildGraphSnapshotFromIROptions, CONTRACT_CAPSULE_SCHEMA_URL, type CompileExecutionPackBundleOptions, type ContractCapsule, type ContractCapsuleFinding, type ContractCapsuleRoute, type ContractCapsuleSourceArtifact, type ContractCapsuleVocabularyItem, DEFAULT_CONTRACT_CAPSULE_SOURCE_ARTIFACT_LIMIT, EXECUTION_PACK_BUNDLE_SCHEMA_URL, EXECUTION_PACK_SCHEMA_URLS, type ExecutionPackAntiPattern, type ExecutionPackBase, type ExecutionPackBundle, type ExecutionPackExample, type ExecutionPackManifest, type ExecutionPackScope, type ExecutionPackSelector, type ExecutionPackSuccessCheck, type ExecutionPackTarget, type ExecutionPackTokenBudget, type ExecutionPackType, GRAPH_COMMON_SCHEMA_URL, GRAPH_DIFF_SCHEMA_URL, GRAPH_MANIFEST_SCHEMA_URL, GRAPH_NODE_TYPES, GRAPH_RELATIONS, GRAPH_SCHEMA_VERSION, GRAPH_SNAPSHOT_SCHEMA_URL, type GraphDiff, type GraphDiffOp, type GraphDiffOpType, type GraphDiffSummary, type GraphEdge, type GraphEdgeQuery, type GraphFinding, type GraphImpactContext, type GraphManifest, type GraphNode, type GraphNodeQuery, type GraphNodeType, type GraphRelation, type GraphRouteContext, type GraphSnapshot, type GraphStore, type GraphSubgraph, type GraphTraverseDirection, type GraphTraverseQuery, type IRAppNode, type IRBreakpointEntry, type IRCardWrapping, type IRGridNode, type IRHookType, type IRLayer, type IRNavItem, type IRNode, type IRNodeType, type IRPageNode, type IRPatternMeta, type IRPatternNode, type IRRoute, type IRShellConfig, type IRShellNode, type IRSpatial, type IRStoreNode, type IRTheme, type IRThemeDecoration, type IRVisualEffect, type IRWiring, type IRWiringSignal, type MemoryGraphStoreSeed, type MutationExecutionPack, type MutationPackBuilderOptions, type MutationPackData, type MutationPackKind, PACK_MANIFEST_SCHEMA_URL, type PackManifestEntry, type PackManifestMutationEntry, type PackManifestPageEntry, type PackManifestSectionEntry, type PageExecutionPack, type PagePackBuilderOptions, type PagePackData, type PagePackInput, type PagePackPattern, type PipelineOptions, type PipelineResult, type RealizationAdapter, type RealizationInteractionPlaceholder, type RealizationMockDataSeed, type RealizationPlan, type RealizationRoute, type ResolvedEssence, type ResolvedPage, type ReviewExecutionPack, type ReviewPackBuilderOptions, type ReviewPackData, type ReviewPackKind, SELECTED_EXECUTION_PACK_SCHEMA_URL, type ScaffoldExecutionPack, type ScaffoldPackBuilderOptions, type ScaffoldPackData, type ScaffoldPackRoute, type SectionExecutionPack, type SectionPackBuilderOptions, type SectionPackData, type SectionPackInput, type SectionPackRoute, type SelectedExecutionPack, type SelectedExecutionPackResponse, type SourceArtifact, buildContractCapsuleFromSnapshot, buildGraphImpactContext, buildGraphRouteContext, buildGraphSnapshotFromEssence, buildGraphSnapshotFromIR, buildMutationPack, buildPageIR, buildPagePack, buildReviewPack, buildScaffoldPack, buildSectionPack, compileExecutionPackBundle, compileRealizationPlan, compileSelectedExecutionPack, countPatterns, createMemoryGraphStore, diffGraphSnapshots, findNodes, graphContractHash, graphPayloadRecord, graphPayloadString, listPackPages, listPackSections, normalizeGraphSnapshot, pascalCase, renderExecutionPackMarkdown, resolveEssence, resolvePackAdapter, resolveVisualEffects, runPipeline, selectExecutionPackFromBundle, sortGraphEdges, sortGraphNodes, summarizeGraphDiff, validateIR, walkIR };
+export { type BuildContractCapsuleOptions, type BuildGraphImpactContextOptions, type BuildGraphRouteContextOptions, type BuildGraphSnapshotFromEssenceOptions, type BuildGraphSnapshotFromIROptions, CONTRACT_CAPSULE_SCHEMA_URL, type CompileExecutionPackBundleOptions, type ContractCapsule, type ContractCapsuleFinding, type ContractCapsuleRoute, type ContractCapsuleSourceArtifact, type ContractCapsuleVocabularyItem, DEFAULT_CONTRACT_CAPSULE_SOURCE_ARTIFACT_LIMIT, EXECUTION_PACK_BUNDLE_SCHEMA_URL, EXECUTION_PACK_SCHEMA_URLS, type ExecutionPackAntiPattern, type ExecutionPackBase, type ExecutionPackBundle, type ExecutionPackExample, type ExecutionPackManifest, type ExecutionPackScope, type ExecutionPackSelector, type ExecutionPackSuccessCheck, type ExecutionPackTarget, type ExecutionPackTokenBudget, type ExecutionPackType, GRAPH_COMMON_SCHEMA_URL, GRAPH_DIFF_SCHEMA_URL, GRAPH_MANIFEST_SCHEMA_URL, GRAPH_NODE_TYPES, GRAPH_RELATIONS, GRAPH_SCHEMA_VERSION, GRAPH_SNAPSHOT_SCHEMA_URL, type GraphChangedFileImpact, type GraphDiff, type GraphDiffOp, type GraphDiffOpType, type GraphDiffSummary, type GraphEdge, type GraphEdgeQuery, type GraphFinding, type GraphImpactContext, type GraphManifest, type GraphNode, type GraphNodeQuery, type GraphNodeType, type GraphRelation, type GraphRouteContext, type GraphSnapshot, type GraphStore, type GraphSubgraph, type GraphTraverseDirection, type GraphTraverseQuery, type IRAppNode, type IRBreakpointEntry, type IRCardWrapping, type IRGridNode, type IRHookType, type IRLayer, type IRNavItem, type IRNode, type IRNodeType, type IRPageNode, type IRPatternMeta, type IRPatternNode, type IRRoute, type IRShellConfig, type IRShellNode, type IRSpatial, type IRStoreNode, type IRTheme, type IRThemeDecoration, type IRVisualEffect, type IRWiring, type IRWiringSignal, type MemoryGraphStoreSeed, type MutationExecutionPack, type MutationPackBuilderOptions, type MutationPackData, type MutationPackKind, PACK_MANIFEST_SCHEMA_URL, type PackManifestEntry, type PackManifestMutationEntry, type PackManifestPageEntry, type PackManifestSectionEntry, type PageExecutionPack, type PagePackBuilderOptions, type PagePackData, type PagePackInput, type PagePackPattern, type PipelineOptions, type PipelineResult, type RealizationAdapter, type RealizationInteractionPlaceholder, type RealizationMockDataSeed, type RealizationPlan, type RealizationRoute, type ResolvedEssence, type ResolvedPage, type ReviewExecutionPack, type ReviewPackBuilderOptions, type ReviewPackData, type ReviewPackKind, SELECTED_EXECUTION_PACK_SCHEMA_URL, type ScaffoldExecutionPack, type ScaffoldPackBuilderOptions, type ScaffoldPackData, type ScaffoldPackRoute, type SectionExecutionPack, type SectionPackBuilderOptions, type SectionPackData, type SectionPackInput, type SectionPackRoute, type SelectedExecutionPack, type SelectedExecutionPackResponse, type SourceArtifact, buildChangedFileGraphImpact, buildContractCapsuleFromSnapshot, buildGraphImpactContext, buildGraphRouteContext, buildGraphSnapshotFromEssence, buildGraphSnapshotFromIR, buildMutationPack, buildPageIR, buildPagePack, buildReviewPack, buildScaffoldPack, buildSectionPack, compileExecutionPackBundle, compileRealizationPlan, compileSelectedExecutionPack, countPatterns, createMemoryGraphStore, diffGraphSnapshots, findNodes, graphContractHash, graphPayloadRecord, graphPayloadString, listPackPages, listPackSections, normalizeGraphSnapshot, pascalCase, renderExecutionPackMarkdown, resolveEssence, resolvePackAdapter, resolveVisualEffects, runPipeline, selectExecutionPackFromBundle, sortGraphEdges, sortGraphNodes, summarizeGraphDiff, validateIR, walkIR };

package.json

 {
-  "name": "@decantr/core",
-  "version": "3.8.2",
-  "description": "Decantr core — execution-pack, typed graph, and Contract capsule primitives",
-  "keywords": [
-    "decantr",
-    "decantr-ai",
-    "ai-coding",
-    "frontend-governance",
-    "ai-frontend-governance",
-    "design-contracts",
-    "typed-graph",
-    "contract-capsule",
-    "execution-packs",
-    "ui-generation",
-    "scaffolding"
-  ],
   "author": "Decantr AI",
-  "license": "MIT",
   "bugs": {
     "url": "https://github.com/decantr-ai/decantr/issues"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/decantr-ai/decantr.git",
-    "directory": "packages/core"
+  "dependencies": {
+    "@decantr/content": "3.9.0",
+    "@decantr/essence-spec": "3.8.1"
   },
-  "homepage": "https://decantr.ai",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "description": "Decantr core — execution-pack, typed graph, and Contract capsule primitives",
+  "devDependencies": {},
+  "engines": {
+    "node": ">=20.19.0"
+  },
   "exports": {
@@ -37,16 +20,16 @@ ".": {
     },
+    "./schema/contract-capsule.v1.json": "./schema/contract-capsule.v1.json",
+    "./schema/execution-pack-bundle.v1.json": "./schema/execution-pack-bundle.v1.json",
     "./schema/execution-pack.common.v1.json": "./schema/execution-pack.common.v1.json",
+    "./schema/graph-diff.v1.json": "./schema/graph-diff.v1.json",
+    "./schema/graph-manifest.v1.json": "./schema/graph-manifest.v1.json",
+    "./schema/graph-snapshot.v1.json": "./schema/graph-snapshot.v1.json",
+    "./schema/graph.common.v1.json": "./schema/graph.common.v1.json",
+    "./schema/mutation-pack.v1.json": "./schema/mutation-pack.v1.json",
+    "./schema/pack-manifest.v1.json": "./schema/pack-manifest.v1.json",
+    "./schema/page-pack.v1.json": "./schema/page-pack.v1.json",
+    "./schema/review-pack.v1.json": "./schema/review-pack.v1.json",
     "./schema/scaffold-pack.v1.json": "./schema/scaffold-pack.v1.json",
     "./schema/section-pack.v1.json": "./schema/section-pack.v1.json",
-    "./schema/page-pack.v1.json": "./schema/page-pack.v1.json",
-    "./schema/mutation-pack.v1.json": "./schema/mutation-pack.v1.json",
-    "./schema/review-pack.v1.json": "./schema/review-pack.v1.json",
-    "./schema/pack-manifest.v1.json": "./schema/pack-manifest.v1.json",
-    "./schema/execution-pack-bundle.v1.json": "./schema/execution-pack-bundle.v1.json",
-    "./schema/selected-execution-pack.v1.json": "./schema/selected-execution-pack.v1.json",
-    "./schema/graph.common.v1.json": "./schema/graph.common.v1.json",
-    "./schema/graph-snapshot.v1.json": "./schema/graph-snapshot.v1.json",
-    "./schema/graph-manifest.v1.json": "./schema/graph-manifest.v1.json",
-    "./schema/graph-diff.v1.json": "./schema/graph-diff.v1.json",
-    "./schema/contract-capsule.v1.json": "./schema/contract-capsule.v1.json"
+    "./schema/selected-execution-pack.v1.json": "./schema/selected-execution-pack.v1.json"
   },
@@ -57,19 +40,36 @@ "files": [
   ],
-  "engines": {
-    "node": ">=20.19.0"
-  },
+  "homepage": "https://decantr.ai",
+  "keywords": [
+    "decantr",
+    "decantr-ai",
+    "ai-coding",
+    "frontend-governance",
+    "ai-frontend-governance",
+    "design-contracts",
+    "typed-graph",
+    "contract-capsule",
+    "execution-packs",
+    "ui-generation",
+    "scaffolding"
+  ],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "name": "@decantr/core",
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@decantr/essence-spec": "3.8.1",
-    "@decantr/registry": "3.8.1"
+  "repository": {
+    "directory": "packages/core",
+    "type": "git",
+    "url": "git+https://github.com/decantr-ai/decantr.git"
   },
-  "devDependencies": {},
   "scripts": {
     "build": "tsup",
+    "preversion": "pnpm build && pnpm test",
     "test": "vitest run",
-    "test:watch": "vitest",
-    "preversion": "pnpm build && pnpm test"
-  }
-}
+    "test:watch": "vitest"
+  },
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "version": "3.9.0"
+}

README.md

@@ -8,3 +8,3 @@ # @decantr/core
 
-Most teams should use `@decantr/cli`, `@decantr/registry`, or `@decantr/mcp-server` directly. `@decantr/core` is part of the supported Decantr public foundation surface, but it is intentionally lower-level than the usual integration entrypoints.
+Most teams should use `@decantr/cli`, `@decantr/content`, or `@decantr/mcp-server` directly. `@decantr/core` is part of the supported Decantr public foundation surface, but it is intentionally lower-level than the usual integration entrypoints. `@decantr/registry` remains only for Decantr 3.x compatibility imports.
 
@@ -29,3 +29,3 @@ ## Install
 - IR and pipeline helpers used by higher-level Decantr surfaces
-- Decantr 3 typed graph types, graph constants, Essence/IR-to-graph snapshot derivation, temporal snapshot/diff shapes, source import/reference edges, contract capsule derivation with a bounded source-artifact path index, deterministic hybrid route/impact ranking, behavior-obligation LocalRule projection support through existing graph shapes, evidence/proof ingestion, test-coverage hint edges, node impact context extraction, and an in-memory `GraphStore` adapter
+- Decantr 3 typed graph types, graph constants, Essence/IR-to-graph snapshot derivation, temporal snapshot/diff shapes, source import/reference edges, contract capsule derivation with a bounded source-artifact path index, deterministic hybrid route/impact ranking, canonical changed-file graph impact resolution, behavior-obligation LocalRule projection support through existing graph shapes, evidence/proof ingestion, test-coverage hint edges, node impact context extraction, and an in-memory `GraphStore` adapter
 
@@ -32,0 +32,0 @@ In the current workflow architecture, `@decantr/core` owns the canonical adapter labels used by compiled packs, while runnable greenfield bootstrap adapters are resolved in the CLI on top of those labels.

No alert changes

Improved metrics

Total package byte prevSize

445359

1.54%

Lines of code

5967

1.12%

Dependency changes

• + Added

  @decantr/content@3.9.0

• + Added

  @decantr/content@3.9.0
  (transitive)

• - Removed

  @decantr/registry@3.8.1

• - Removed

  @decantr/content@3.8.1
  (transitive)

• - Removed

  @decantr/registry@3.8.1
  (transitive)