cwtools-shared 0.2.2 → 0.2.3

package/dist/knowledge/rules.js

@@ -49,6 +49,9 @@ async function queryRulesWithHost(host, args) {
             : args.category === 'modifier'
                 ? cache.modifiers
                 : cache.scopeChanges;
+    const dottedScopeChain = args.name && args.category === 'scope_change'
+        ? buildDottedScopeChainRule(args.name, args.scope, cache.scopeChanges)
+        : undefined;
     if (args.name) {
         const needle = normalizeRuleNameQuery(args.name, args.category);
         const filtered = rules
@@ -69,6 +72,12 @@ async function queryRulesWithHost(host, args) {
             rules = filtered;
         }
     }
+    if (dottedScopeChain) {
+        rules = [
+            dottedScopeChain,
+            ...rules.filter(rule => rule.name !== dottedScopeChain.name),
+        ];
+    }
     if (args.scope) {
         const scope = args.scope.toLowerCase();
         rules = rules.filter(rule => rule.scopes.length === 0
@@ -1519,6 +1528,70 @@ function normalizeRuleNameQuery(name, category) {
     const parts = lowered.split('.').map(part => part.trim()).filter(Boolean);
     return parts[parts.length - 1] ?? lowered;
 }
+function buildDottedScopeChainRule(query, contextScope, scopeChanges) {
+    const rawParts = query.trim().split('.').map(normalizeScopeName).filter(Boolean);
+    if (rawParts.length < 2)
+        return undefined;
+    const contextPointers = new Set(['from', 'prev', 'root', 'this']);
+    const first = rawParts[0];
+    const startsWithPointer = contextPointers.has(first);
+    const initialScope = startsWithPointer ? contextScope?.trim().toLowerCase() : first;
+    const linkNames = rawParts.slice(1);
+    if (!initialScope || linkNames.length === 0)
+        return undefined;
+    const hops = [];
+    let currentScope = initialScope;
+    for (const linkName of linkNames) {
+        const link = scopeChanges.find(rule => rule.name.toLowerCase() === linkName
+            && !!rule.hardFacts?.pushScope
+            && scopeListContains(rule.hardFacts.supportedScopes ?? rule.scopes, currentScope));
+        const outputScope = link?.hardFacts?.pushScope?.trim().toLowerCase();
+        if (!link || !outputScope)
+            return undefined;
+        hops.push({ link, inputScope: currentScope, outputScope });
+        currentScope = outputScope;
+    }
+    if (hops.length === 0)
+        return undefined;
+    const normalizedQuery = rawParts.join('.');
+    const syntax = `${normalizedQuery} = { ... }`;
+    const source = hops[0].link;
+    const hopText = hops.map(hop => `${hop.inputScope}.${hop.link.name} -> ${hop.outputScope}`).join('; ');
+    const linkHints = hops.map((hop) => ({
+        text: `Dotted scope chain hop '${hop.inputScope}.${hop.link.name}' is legal because links.cwt declares '${hop.link.name}' with input scope '${hop.inputScope}' and output scope '${hop.outputScope}'.`,
+        source: 'links.cwt',
+        file: hop.link.sourceFile,
+        line: hop.link.sourceLine,
+        confidence: 'hint',
+    }));
+    return {
+        name: normalizedQuery,
+        description: `Legal dotted scope chain from ${initialScope} to ${currentScope}. Hops: ${hopText}.`,
+        scopes: [initialScope],
+        syntax,
+        category: 'scope_change',
+        sourceFile: source.sourceFile,
+        sourceLine: source.sourceLine,
+        hardFacts: {
+            category: 'scope_change',
+            supportedScopes: [initialScope],
+            pushScope: currentScope,
+            valueReferences: [],
+            syntax,
+            cwtSource: source.sourceFile && source.sourceLine
+                ? { file: source.sourceFile, line: source.sourceLine }
+                : undefined,
+        },
+        semanticHints: linkHints.slice(0, 8),
+    };
+}
+function scopeListContains(scopes, scope) {
+    const lowerScope = scope.toLowerCase();
+    return scopes.some(candidate => {
+        const lower = candidate.toLowerCase();
+        return lower === lowerScope || lower === 'all' || lower === 'any';
+    });
+}
 function scoreRuleNameMatch(name, needle) {
     const lower = name.toLowerCase();
     if (lower === needle)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cwtools-shared",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Shared protocol and tool contracts for the CWTools MCP server",
   "license": "MIT",
   "repository": {