@weftlet/core 0.3.0 → 0.4.0

package/README.md

@@ -8,4 +8,22 @@ AI development agents.
 The core package has no runtime dependencies. Install `@weftlet/toolkit` for the CLI,
 MCP server, extraction, storage and graph queries.
 
+Repository adapters should construct physical-file nodes with the public factory:
+
+```ts
+import { repositoryFileNode } from '@weftlet/core';
+
+const file = repositoryFileNode('src/worker.spec.ts');
+// { id: 'component:file:src/worker.spec.ts', label: 'src/worker.spec.ts', kind: 'Evidence' }
+```
+
+Markdown/MDX/text documents use `document:<path>` and `Document`; `.spec.<extension>` and
+`.test.<extension>` files use `component:file:<path>` and `Evidence`; other files use that
+file prefix and `Component`. Extension matching ignores case, while path spelling is retained.
+Supply a repository-relative path using the repository's canonical spelling. This pure mapping
+does not resolve paths, read files, detect every testing convention or approve product intent.
+Keep business-concept identities separate. Adapters can add attributes without changing the
+factory's `id` or `kind`; use the same node for mocked/DI/decorator-bearing tests and production
+sources. This API is available starting with 0.4.0; it is absent from 0.3.0.
+
 Licensed under Apache-2.0; see LICENSE and NOTICE for attribution.

package/dist/core.d.ts

@@ -171,7 +171,7 @@ export interface ImpactScanRequest {
     readonly continuation?: string;
 }
 export interface ContextPack {
-    readonly snapshot: Pick<SnapshotManifest, 'snapshotId' | 'commitSha' | 'contentDigest' | 'configurationDigest' | 'scope' | 'baseSha' | 'overlayDigest' | 'overlayCapture'>;
+    readonly snapshot: Pick<SnapshotManifest, 'snapshotId' | 'commitSha' | 'contentDigest' | 'configurationDigest' | 'scope' | 'baseSha' | 'overlayDigest' | 'overlayCapture'> & Partial<Pick<SnapshotManifest, 'extractorVersions'>>;
     readonly evidenceState?: {
         readonly currentCommit?: string;
         readonly excludedWorkingChanges: readonly string[];
@@ -180,6 +180,8 @@ export interface ContextPack {
         readonly overlayFreshness?: 'current' | 'stale' | 'unknown';
         readonly stale: boolean;
         readonly configurationMatches: boolean;
+        readonly extractionCompatible?: boolean;
+        readonly incompatibleExtractors?: readonly string[];
         readonly eligibleForCurrentDiffValidation: false;
     };
     readonly capabilities: readonly GraphNode[];

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from './core.js';
 export * from './util.js';
+export * from './repository-nodes.js';

package/dist/index.js

@@ -1,2 +1,4 @@
+// Modified for standalone extraction; see docs/extraction-manifest.json.
 export * from './core.js';
 export * from './util.js';
+export * from './repository-nodes.js';

package/dist/repository-nodes.d.ts

@@ -0,0 +1,7 @@
+import type { GraphNode } from './core.js';
+/**
+ * Canonical physical-file identity, shared by toolkit extractors and repository adapters.
+ * The caller supplies a repository-relative path with its intended spelling. This pure
+ * mapping does not resolve paths or establish existence, intent, ownership or approval.
+ */
+export declare function repositoryFileNode(path: string): GraphNode;

package/dist/repository-nodes.js

@@ -0,0 +1,11 @@
+/**
+ * Canonical physical-file identity, shared by toolkit extractors and repository adapters.
+ * The caller supplies a repository-relative path with its intended spelling. This pure
+ * mapping does not resolve paths or establish existence, intent, ownership or approval.
+ */
+export function repositoryFileNode(path) {
+    if (/\.(?:md|mdx|txt)$/i.test(path))
+        return { id: `document:${path}`, kind: 'Document', label: path };
+    return { id: `component:file:${path}`, label: path,
+        kind: /\.(spec|test)\.[^.]+$/i.test(path) ? 'Evidence' : 'Component' };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weftlet/core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Neutral contracts and deterministic utilities for commit-keyed context graphs",
   "license": "Apache-2.0",
   "type": "module",