@skill-map/cli 0.37.0 → 0.39.0

package/dist/kernel/index.d.ts

@@ -1,15 +1,15 @@
 /**
  * Extension registry, six kinds, first-class, loaded through a single API.
  *
- * The `Extension` shape is aligned with `spec/schemas/extensions/base.schema.json`.
+ * The `IExtension` shape is aligned with `spec/schemas/extensions/base.schema.json`.
  * Kind-specific manifests (provider / extractor / analyzer / action / formatter /
  * hook) extend this base structurally; the registry stores the base view
  * and each kind's code carries its own fuller type where needed.
  *
  * **Spec § A.6, qualified ids.** Every extension is keyed in the registry
- * by `<pluginId>/<id>` (e.g. `core/annotations`, `core/slash`,
- * `my-plugin/my-extractor`). `Extension.id` carries the **short** id as authored;
- * `Extension.pluginId` carries the namespace; the registry composes the
+ * by `<pluginId>/<id>` (e.g. `core/annotations`, `core/slash-command`,
+ * `my-plugin/my-extractor`). `IExtension.id` carries the **short** id as authored;
+ * `IExtension.pluginId` carries the namespace; the registry composes the
  * qualifier internally and exposes lookup APIs that operate on either form
  * (qualified for direct lookup, kind-scoped listing for enumeration).
  *
@@ -19,7 +19,7 @@
  */
 type ExtensionKind = 'provider' | 'extractor' | 'analyzer' | 'action' | 'formatter' | 'hook';
 declare const EXTENSION_KINDS: readonly ExtensionKind[];
-interface Extension {
+interface IExtension {
     /** Short (unqualified) extension id, injected by the loader from the leaf folder name. */
     id: string;
     /** Owning plugin namespace, injected by the loader from the plugin folder name. */
@@ -42,18 +42,18 @@ declare class DuplicateExtensionError extends Error {
 declare class Registry {
     #private;
     constructor();
-    register(ext: Extension): void;
+    register(ext: IExtension): void;
     /**
      * Lookup by qualified id (`<pluginId>/<id>`). Returns `undefined` when
      * no extension of that kind is registered under the qualifier.
      */
-    get(kind: ExtensionKind, qualifiedId: string): Extension | undefined;
+    get(kind: ExtensionKind, qualifiedId: string): IExtension | undefined;
     /**
      * Convenience wrapper that composes the qualified id for the caller.
      * Equivalent to `get(kind, qualifiedExtensionId(pluginId, id))`.
      */
-    find(kind: ExtensionKind, pluginId: string, id: string): Extension | undefined;
-    all(kind: ExtensionKind): Extension[];
+    find(kind: ExtensionKind, pluginId: string, id: string): IExtension | undefined;
+    all(kind: ExtensionKind): IExtension[];
     count(kind: ExtensionKind): number;
     totalCount(): number;
 }
@@ -207,7 +207,7 @@ interface IRegisteredViewContribution {
 }
 /**
  * Common fields on every setting declaration. The discriminated union
- * `ISettingDeclaration` extends one of these per `type` value.
+ * `TSettingDeclaration` extends one of these per `type` value.
  */
 interface ISettingCommon {
     /** Required. Short human-readable label. English-only. */
@@ -297,7 +297,7 @@ interface ISetting_KeyValueList extends ISettingCommon {
  *
  * Mirror of `input-types.schema.json#/$defs/ISettingDeclaration`.
  */
-type ISettingDeclaration = ISetting_StringList | ISetting_SingleString | ISetting_BooleanFlag | ISetting_Integer | ISetting_EnumPick | ISetting_EnumMultipick | ISetting_PathGlob | ISetting_Regex | ISetting_Secret | ISetting_KeyValueList;
+type TSettingDeclaration = ISetting_StringList | ISetting_SingleString | ISetting_BooleanFlag | ISetting_Integer | ISetting_EnumPick | ISetting_EnumMultipick | ISetting_PathGlob | ISetting_Regex | ISetting_Secret | ISetting_KeyValueList;
 /**
  * Runtime value type for a setting, derived from its declaration. The
  * kernel exposes settings to extractors as `Record<string, TSettingValue>`
@@ -378,7 +378,7 @@ interface IExtensionBase {
      * `ctx.settings.<settingId>`. Settings are read once at extension
      * invocation; changing a setting requires `sm scan` to re-emit.
      */
-    settings?: Record<string, ISettingDeclaration>;
+    settings?: Record<string, TSettingDeclaration>;
     /**
      * Resolved values of the settings declared above, populated by the
      * orchestrator from project config + user overrides. Runtime-only,
@@ -490,7 +490,7 @@ interface IExtensionBase {
  * This alias survives because:
  *   - claude-specific code legitimately wants to switch on the four
  *     hard-coded values (filter widgets, kind-aware UI cards, the
- *     `validate-all` built-in rule that maps each kind to its
+ *     `schema-violation` built-in rule that maps each kind to its
  *     frontmatter schema);
  *   - sorting helpers want a stable `KIND_ORDER` for the canonical
  *     catalog;
@@ -560,7 +560,7 @@ interface LinkLocation {
  * target), or when the same extractor walks an extractor-internal
  * dedup boundary. Today the merged edge's `trigger` / `location`
  * mirror the FIRST occurrence; the array carries every site so the
- * `core/redundant-target-reference` analyzer can flag multi-form
+ * `core/reference-redundant` analyzer can flag multi-form
  * references and rename operations can find every author surface.
  */
 interface LinkOccurrence {
@@ -722,7 +722,7 @@ interface Link {
      * same `(source, target, kind, normalizedTrigger)` key. Empty / absent
      * for legacy emits or for synthetic links (frontmatter-driven
      * references, sidecar annotations) that have no body position. The
-     * `core/redundant-target-reference` analyzer walks this array to
+     * `core/reference-redundant` analyzer walks this array to
      * detect multi-form references to the same target from one body.
      */
     occurrences?: LinkOccurrence[];
@@ -1302,7 +1302,7 @@ interface IKvStoreWrapper {
  * `write(table, row)`. Plugin authors narrow at the call site based on
  * the storage mode declared in their `plugin.json`.
  */
-type IPluginStore = IKvStoreWrapper | IDedicatedStoreWrapper;
+type TPluginStore = IKvStoreWrapper | IDedicatedStoreWrapper;
 declare function makeKvStoreWrapper(opts: {
     pluginId: string;
     schema: IPluginStorageSchema | undefined;
@@ -1338,7 +1338,7 @@ declare function makePluginStore(opts: {
     plugin: IDiscoveredPlugin;
     persistKv?: IKvStorePersist;
     persistDedicated?: IDedicatedStorePersist;
-}): IPluginStore | undefined;
+}): TPluginStore | undefined;
 
 /**
  * Row-level filter for `port.scans.findNodes(...)` (driven by
@@ -1468,6 +1468,14 @@ interface IIssueRow {
  *   - `nodePath`, keeps issues whose `nodeIds` JSON array contains the
  *     given path (correlated EXISTS over `json_each`). Absent / null
  *     skips the filter.
+ *   - `nodePaths`, multi-node variant of `nodePath`: keeps issues
+ *     whose `nodeIds` JSON array intersects the given set (correlated
+ *     EXISTS over `json_each` with an `IN(...)` predicate). Used by
+ *     the linked-nodes panel to fetch issues for the focused node +
+ *     its neighbours in one round-trip instead of pulling the whole
+ *     table. Empty array matches zero rows; absent skips the filter.
+ *     Combines with `nodePath` (intersection); when both are set, the
+ *     `nodePath` predicate is AND-ed with `nodePaths`.
  *
  * Pagination is mandatory; the route layer fills the defaults via
  * `parsePagination`. `total` in `IIssueListResult` reports the total
@@ -1485,6 +1493,7 @@ interface IIssueListFilter {
     severities?: readonly string[];
     analyzerIds?: readonly string[];
     nodePath?: string | null;
+    nodePaths?: readonly string[];
     offset: number;
     limit: number;
 }
@@ -2147,7 +2156,7 @@ interface IProvider extends IExtensionBase {
      *
      * Two consumers share the catalog:
      *
-     *   1. The `core/reserved-name` analyzer scans every user node and
+     *   1. The `core/name-reserved` analyzer scans every user node and
      *      emits a `warn` issue when the node's normalised identifiers
      *      (per `IProviderKind.identifiers`) intersect the reserved list
      *      for its provider + kind. The user file is silently shadowed
@@ -2424,7 +2433,7 @@ interface IAnalyzerContext {
      * Step 9.6.6, raw parsed sidecar root keyed by `node.path`. Populated
      * by the orchestrator alongside the public `Node.sidecar` overlay so
      * analyzers that inspect plugin namespaces (e.g. the built-in
-     * `core/unknown-field` Analyzer) can walk the full tree without
+     * `core/annotation-field-unknown` Analyzer) can walk the full tree without
      * re-reading the file from disk. Absent (or `undefined` per node)
      * when no sidecar accompanies the node, or when the sidecar failed
      * to parse. Treat as read-only.
@@ -2454,7 +2463,7 @@ interface IAnalyzerContext {
     /**
      * Absolute paths of `*.md` files under the project's
      * `.skill-map/jobs/` that no `state_jobs.filePath` references, the
-     * built-in `core/job-orphan-file` analyzer projects each as a `warn`
+     * built-in `core/job-file-orphan` analyzer projects each as a `warn`
      * issue. Pre-computed by the driving adapter (CLI / BFF) inside its
      * already-open storage transaction (mirrors the `orphanSidecars`
      * pattern: detection lives outside the analyzer, the analyzer only
@@ -2469,7 +2478,7 @@ interface IAnalyzerContext {
      * adapter walks each configured path before the scan and collects
      * every existing file's absolute path here. Files in this set are
      * NOT indexed as graph nodes, the only consumer is
-     * `core/broken-ref`, which suppresses its `warn` issue when a
+     * `core/reference-broken`, which suppresses its `warn` issue when a
      * path-style link target falls into the set. Absent / empty when
      * the operator left `scan.referencePaths` empty or when the
      * adapter does not maintain the side index. Treat as read-only.
@@ -2483,7 +2492,7 @@ interface IAnalyzerContext {
      * computed once per scan by the orchestrator (mirroring the same
      * set threaded to the post-walk confidence-lift transform), so
      * analyzers consume it without re-deriving every node's
-     * identifiers. The single consumer today is `core/reserved-name`,
+     * identifiers. The single consumer today is `core/name-reserved`,
      * which projects one warn issue per entry; future analyzers MAY
      * read the set for cross-rule cohesion (e.g. an action that
      * suggests rename targets). Absent for legacy callers (older
@@ -2494,7 +2503,7 @@ interface IAnalyzerContext {
      * Absolute path of the scan's project root (cwd of the invocation).
      * Threaded into the analyzer pass so an analyzer that needs to
      * resolve a relative `link.target` to an absolute filesystem path
-     * (today only `core/broken-ref`, when consulting
+     * (today only `core/reference-broken`, when consulting
      * `referenceablePaths`) does not have to derive it from
      * `nodes[0].path` heuristics. Absent for legacy callers (older
      * `runScan` sites that never wired the field through). Always an
@@ -2992,7 +3001,7 @@ declare function runExtractorsForNode(opts: {
      * don't track plugin storage can omit it; the resulting `ctx.store`
      * stays `undefined` (the existing contract).
      */
-    pluginStores?: ReadonlyMap<string, IPluginStore>;
+    pluginStores?: ReadonlyMap<string, TPluginStore>;
 }): Promise<{
     internalLinks: Link[];
     externalLinks: Link[];
@@ -3144,7 +3153,7 @@ interface RunScanOptions {
     /**
      * Step 9.6.6, runtime catalog of plugin-contributed annotation keys
      * (the same shape `kernel.getRegisteredAnnotationKeys()` returns).
-     * Threaded into the rule pass so `core/unknown-field` can
+     * Threaded into the rule pass so `core/annotation-field-unknown` can
      * legitimise registered plugin namespaces / root keys without
      * re-walking the manifests. Absent → empty catalog (every plugin
      * key is treated as unknown). Built-in catalog from
@@ -3257,12 +3266,12 @@ interface RunScanOptions {
      * its own persist callback) and lets tests inject a captured-call
      * mock without spinning up a DB.
      */
-    pluginStores?: ReadonlyMap<string, IPluginStore>;
+    pluginStores?: ReadonlyMap<string, TPluginStore>;
     /**
      * Pre-computed absolute paths of orphan job MD files (files under
      * `.skill-map/jobs/` whose absolute path appears nowhere in
      * `state_jobs.filePath`). Threaded into the rule pass so the
-     * built-in `core/job-orphan-file` rule can project each as a `warn`
+     * built-in `core/job-file-orphan` rule can project each as a `warn`
      * issue without the kernel reaching for the storage port or doing
      * its own FS walk. The driving adapter (CLI, BFF) computes this
      * inside its already-open storage transaction via
@@ -3277,7 +3286,7 @@ interface RunScanOptions {
      * Side set of absolute file paths the operator opted into for
      * link-validation purposes via `scan.referencePaths`. Threaded
      * through to `IAnalyzerContext.referenceablePaths` so the built-in
-     * `core/broken-ref` rule can suppress its `warn` for path-style
+     * `core/reference-broken` rule can suppress its `warn` for path-style
      * links whose target lands in the set. Files are NOT walked by
      * the kernel, the driving adapter populates the set before
      * calling `runScan`. Absent / empty when the operator left
@@ -4298,4 +4307,4 @@ interface Kernel {
 }
 declare function createKernel(): Kernel;
 
-export { type Confidence, DuplicateExtensionError, EXTENSION_KINDS, type ExecutionFailureReason, type ExecutionKind, type ExecutionRecord, type ExecutionRunner, type ExecutionStatus, ExportQueryError, type Extension, type ExtensionKind, type FilesystemPort, HOOK_TRIGGERS, type HistoryStats, type HistoryStatsErrorRates, type HistoryStatsExecutionsPerPeriod, type HistoryStatsPerActionRate, type HistoryStatsTokensPerAction, type HistoryStatsTopNode, type HistoryStatsTotals, type IAction, type IActionContext, type IActionPrecondition, type IActionResult, type IAnalyzer, type IAnalyzerContext, type IAnnotationContribution, type ICreateFsWatcherOptions, type IDedicatedStorePersist, type IDedicatedStoreWrapper, type IDiscoveredPlugin, type IEnrichmentRecord, type IExportQuery, type IExportSubset, type IExtensionBase, type IExternalRef, type IExtractor, type IExtractorCallbacks, type IExtractorContext, type IExtractorRunRecord, type IFormatter, type IFormatterContext, type IFsWatcher, type IHook, type IHookContext, type IHookDispatcher, type IIssueRow, type IKvStorePersist, type IKvStoreWrapper, type ILoadedExtension, type INodeBundle, type INodeChange, type INodeCounts, type INodeFilter, type IPersistOptions, type IPersistedEnrichment, type IPluginManifest, type IPluginStorageSchema, type IPluginStore, type IProvider, type IRawNode, type IRegisteredAnnotationKey, type IRegisteredViewContribution, type IRunOptions, type IRunResult, type IScanDelta, type ISettingDeclaration, type ITransactionalStorage, type IViewContribution, type IWalkOptions, type IWatchBatch, type IWatchEvent, InMemoryProgressEmitter, type Issue, type IssueFix, KV_SCHEMA_KEY, type Kernel, LOG_LEVELS, type Link, type LinkKind, type LinkLocation, type LinkOccurrence, type LinkTrigger, type LogRecord, type LoggerPort, type Node, type NodeKind, type NodeStat, type PluginLoaderPort, type ProgressEmitterPort, type ProgressEvent, Registry, type RenameOp, type RunScanOptions, type RunnerPort, type ScanResult, type ScanScannedBy, type ScanStats, type Severity, SilentLogger, type Stability, type StoragePort, type TActionWrite, type TExecutionMode, type TGranularity, type THookFilter, type THookTrigger, type TInputTypeName, type TLogLevel, type TLogMethodLevel, type TNodeChangeReason, type TPluginLoadStatus, type TPluginStorage, type TProgressListener, type TSettingValue, type TSeverity, type TSlotName, type TWatchEventKind, type TripleSplit, applyExportQuery, computeScanDelta, configureLogger, createChokidarWatcher, createKernel, detectRenamesAndOrphans, getActiveLogger, isEmptyDelta, isLogLevel, log, logLevelRank, makeDedicatedStoreWrapper, makeEvent, makeHookDispatcher, makeKvStoreWrapper, makePluginStore, mergeNodeWithEnrichments, parseExportQuery, parseLogLevel, qualifiedExtensionId, resetLogger, runExtractorsForNode, runScan, runScanWithRenames };
+export { type Confidence, DuplicateExtensionError, EXTENSION_KINDS, type ExecutionFailureReason, type ExecutionKind, type ExecutionRecord, type ExecutionRunner, type ExecutionStatus, ExportQueryError, type ExtensionKind, type FilesystemPort, HOOK_TRIGGERS, type HistoryStats, type HistoryStatsErrorRates, type HistoryStatsExecutionsPerPeriod, type HistoryStatsPerActionRate, type HistoryStatsTokensPerAction, type HistoryStatsTopNode, type HistoryStatsTotals, type IAction, type IActionContext, type IActionPrecondition, type IActionResult, type IAnalyzer, type IAnalyzerContext, type IAnnotationContribution, type ICreateFsWatcherOptions, type IDedicatedStorePersist, type IDedicatedStoreWrapper, type IDiscoveredPlugin, type IEnrichmentRecord, type IExportQuery, type IExportSubset, type IExtension, type IExtensionBase, type IExternalRef, type IExtractor, type IExtractorCallbacks, type IExtractorContext, type IExtractorRunRecord, type IFormatter, type IFormatterContext, type IFsWatcher, type IHook, type IHookContext, type IHookDispatcher, type IIssueRow, type IKvStorePersist, type IKvStoreWrapper, type ILoadedExtension, type INodeBundle, type INodeChange, type INodeCounts, type INodeFilter, type IPersistOptions, type IPersistedEnrichment, type IPluginManifest, type IPluginStorageSchema, type IProvider, type IRawNode, type IRegisteredAnnotationKey, type IRegisteredViewContribution, type IRunOptions, type IRunResult, type IScanDelta, type ITransactionalStorage, type IViewContribution, type IWalkOptions, type IWatchBatch, type IWatchEvent, InMemoryProgressEmitter, type Issue, type IssueFix, KV_SCHEMA_KEY, type Kernel, LOG_LEVELS, type Link, type LinkKind, type LinkLocation, type LinkOccurrence, type LinkTrigger, type LogRecord, type LoggerPort, type Node, type NodeKind, type NodeStat, type PluginLoaderPort, type ProgressEmitterPort, type ProgressEvent, Registry, type RenameOp, type RunScanOptions, type RunnerPort, type ScanResult, type ScanScannedBy, type ScanStats, type Severity, SilentLogger, type Stability, type StoragePort, type TActionWrite, type TExecutionMode, type TGranularity, type THookFilter, type THookTrigger, type TInputTypeName, type TLogLevel, type TLogMethodLevel, type TNodeChangeReason, type TPluginLoadStatus, type TPluginStorage, type TPluginStore, type TProgressListener, type TSettingDeclaration, type TSettingValue, type TSeverity, type TSlotName, type TWatchEventKind, type TripleSplit, applyExportQuery, computeScanDelta, configureLogger, createChokidarWatcher, createKernel, detectRenamesAndOrphans, getActiveLogger, isEmptyDelta, isLogLevel, log, logLevelRank, makeDedicatedStoreWrapper, makeEvent, makeHookDispatcher, makeKvStoreWrapper, makePluginStore, mergeNodeWithEnrichments, parseExportQuery, parseLogLevel, qualifiedExtensionId, resetLogger, runExtractorsForNode, runScan, runScanWithRenames };

package/dist/kernel/index.js

@@ -43,7 +43,7 @@ var DuplicateExtensionError = class extends Error {
   }
 };
 var Registry = class {
-  /** kind → qualifiedId → Extension. */
+  /** kind → qualifiedId → IExtension. */
   #byKind;
   constructor() {
     this.#byKind = new Map(
@@ -101,7 +101,7 @@ import cl100k_base from "js-tiktoken/ranks/cl100k_base";
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.37.0",
+  version: "0.39.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -184,7 +184,7 @@ var package_default = {
     semver: "7.7.4",
     "smol-toml": "1.6.1",
     typanion: "3.14.0",
-    ws: "8.20.0"
+    ws: "8.21.0"
   },
   devDependencies: {
     "@eslint/js": "10.0.1",
@@ -700,7 +700,7 @@ import { join as join6 } from "path";
 
 // core/config/helper.ts
 import { homedir as osHomedir } from "os";
-import { isAbsolute as isAbsolute2, join as join5, resolve as resolve6 } from "path";
+import { isAbsolute as isAbsolute2, join as join5, resolve as resolve6, sep } from "path";
 
 // kernel/config/loader.ts
 import { existsSync as existsSync3, readFileSync as readFileSync5 } from "fs";
@@ -1426,7 +1426,8 @@ function recomputeLinkCounts(nodes, links) {
   for (const link of links) {
     const source = byPath2.get(link.source);
     if (source) source.linksOutCount += 1;
-    const target = byPath2.get(link.target);
+    const targetKey = link.resolvedTarget ?? link.target;
+    const target = byPath2.get(targetKey);
     if (target) target.linksInCount += 1;
   }
 }
@@ -2205,7 +2206,7 @@ function detectRenamesAndOrphans(prior, current, issues, silenced) {
 
 // kernel/scan/walk-content.ts
 import { readFile, readdir, lstat } from "fs/promises";
-import { join as join7, relative as relative2, sep } from "path";
+import { join as join7, relative as relative2, sep as sep2 } from "path";
 
 // kernel/scan/ignore.ts
 import { existsSync as existsSync6, readFileSync as readFileSync7 } from "fs";
@@ -2362,7 +2363,7 @@ async function* walkContent(roots, options) {
   const extensions = options.extensions;
   for (const root of roots) {
     for await (const file of walkRoot(root, root, filter, extensions)) {
-      const relPath = relative2(root, file).split(sep).join("/");
+      const relPath = relative2(root, file).split(sep2).join("/");
       let raw;
       try {
         raw = await readFile(file, "utf8");
@@ -2394,7 +2395,7 @@ async function* walkRoot(root, current, filter, extensions) {
   for (const entry of entries) {
     const name = entry.name;
     const full = join7(current, name);
-    const rel = relative2(root, full).split(sep).join("/");
+    const rel = relative2(root, full).split(sep2).join("/");
     if (filter.ignores(rel)) continue;
     if (entry.isSymbolicLink()) continue;
     if (entry.isDirectory()) {
@@ -2550,7 +2551,7 @@ function computeDriftStatus(args) {
 
 // kernel/sidecar/discover-orphans.ts
 import { existsSync as existsSync8, readdirSync as readdirSync3, statSync as statSync3 } from "fs";
-import { join as join8, relative as relative3, sep as sep2 } from "path";
+import { join as join8, relative as relative3, sep as sep3 } from "path";
 function discoverOrphanSidecars(roots, shouldSkip) {
   const out = [];
   for (const root of roots) {
@@ -2567,7 +2568,7 @@ function walk(root, current, shouldSkip, out) {
   }
   for (const entry of entries) {
     const full = join8(current, entry.name);
-    const rel = relative3(root, full).split(sep2).join("/");
+    const rel = relative3(root, full).split(sep3).join("/");
     if (shouldSkip(rel)) continue;
     if (entry.isSymbolicLink()) continue;
     if (entry.isDirectory()) {
@@ -3340,7 +3341,7 @@ function resolveActiveProviderOption(optionValue, roots) {
 }
 
 // kernel/scan/watcher.ts
-import { resolve as resolve12, relative as relative4, sep as sep3 } from "path";
+import { resolve as resolve12, relative as relative4, sep as sep4 } from "path";
 import chokidar from "chokidar";
 function createChokidarWatcher(opts) {
   const absRoots = opts.roots.map((r) => resolve12(opts.cwd, r));
@@ -3438,8 +3439,8 @@ function relativePathFromRoots2(absolute, absRoots) {
   for (const root of absRoots) {
     const rel = relative4(root, absolute);
     if (rel === "" || rel === ".") return "";
-    if (!rel.startsWith("..") && !rel.startsWith(`..${sep3}`)) {
-      return rel.split(sep3).join("/");
+    if (!rel.startsWith("..") && !rel.startsWith(`..${sep4}`)) {
+      return rel.split(sep4).join("/");
     }
   }
   return null;