pi-revit 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to pi-revit are documented here.
+Format follows [Keep a Changelog](https://keepachangelog.com/); version headers use
+`## [x.y.z] - YYYY-MM-DD` so tooling (and Pi's changelog parser format) can read them.
+
+Every published version gets an entry with **Added** / **Changed** / **Fixed** sections
+describing what the user will notice — not internal refactors.
+
+## [0.2.4] - 2026-07-20
+
+### Added
+- This changelog. It ships inside the npm package and gets a `## [x.y.z]` entry with
+  **Added / Changed / Fixed** sections for every release, so updates report what actually
+  changed instead of just a version number.
+
+## [0.2.3] - 2026-07-20
+
+### Changed
+- `search_api_docs`: results with the same short name in different namespaces are now
+  disambiguated with their full namespace, so `Category` vs internal schedule types
+  can't be confused.
+
+### Fixed
+- Removed a hardcoded example from the overload note that could mislead the model into
+  copying a signature that didn't apply.
+
+## [0.2.2] - 2026-07-20
+
+### Added
+- `search_api_docs`: exception documentation ("Throws:") is now shown for matched members.
+- Overload-targeted queries: a query containing `(` matches against rendered signatures.
+
+### Changed
+- Overloads now rank simplest-first (fewest parameters), so the common form appears on top.
+
+## [0.2.1] - 2026-07-16
+
+### Added
+- Extension/add-in version handshake: `ping` reports both versions and warns when the
+  npm extension and the installed Revit add-in are out of sync (partial-update detection).
+
+## [0.2.0] - 2026-07-15
+
+### Changed
+- SKILL.md: documents the top-match inline docs behaviour and the automatic
+  `Models\<title>\exports` output location so the agent uses them without prompting.
+
+## [0.1.9] - 2026-07-15
+
+### Added
+- `search_api_docs` indexes every Revit API enum and surfaces `<remarks>` documentation.
+
+### Changed
+- The top match's full documentation is placed directly in the tool's text output
+  (where model attention is strongest) instead of only in the structured payload.
+
+## [0.1.8] - 2026-07-13
+
+### Added
+- Automatic per-model output sorting: exports, captures, and scripts land under
+  `Models\<model title>\` in the workspace, keyed to the source document.
+
+## [0.1.7] - 2026-07-13
+
+### Fixed
+- npm-install uninstall flow no longer blocks itself on its own installation folder.
+
+## [0.1.6] - 2026-07-13
+
+### Changed
+- The global launcher installs next to the user's permanent pi under npx.
+
+## [0.1.5] - 2026-07-13
+
+### Fixed
+- Uninstall of the npm-installed Pi package.
+- Workspace paths containing non-ASCII characters.
+
+First version published to npm.
+
+## [0.1.0] - 2026-06-17
+
+Initial public release: Revit bridge add-in (Revit 2025/2026/2027) plus Pi extension with
+`ping`, `get_model_overview`, `get_elements`, `get_element_details`, `set_parameters`,
+`manage_selection`, `capture_view`, `export_documents`, `execute_csharp`, and
+`search_api_docs`.

package/package.json

@@ -1,55 +1,56 @@
-{
-  "name": "pi-revit",
-  "version": "0.2.2",
-  "description": "Native Pi connector for Autodesk Revit. Run npx.cmd -y pi-revit for the full Windows install.",
-  "author": "Ahmad Altahlawi",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Triavision-ai/pi-revit.git"
-  },
-  "bugs": {
-    "url": "https://github.com/Triavision-ai/pi-revit/issues"
-  },
-  "homepage": "https://github.com/Triavision-ai/pi-revit#readme",
-  "keywords": [
-    "pi-package",
-    "pi-extension",
-    "revit",
-    "bim",
-    "autodesk",
-    "revit-api"
-  ],
-  "bin": {
-    "pi-revit": "bin/pi-revit.js"
-  },
-  "scripts": {
-    "deploy": "powershell -ExecutionPolicy Bypass -File scripts/deploy.ps1",
-    "setup": "powershell -ExecutionPolicy Bypass -File scripts/setup-workspace.ps1",
-    "uninstall:revit": "powershell -ExecutionPolicy Bypass -File scripts/uninstall.ps1"
-  },
-  "files": [
-    "bin/",
-    "extensions/",
-    "skills/",
-    "scripts/",
-    "src/",
-    "workspace/",
-    "README.md"
-  ],
-  "pi": {
-    "extensions": [
-      "./extensions/pi-revit/index.ts"
-    ],
-    "skills": [
-      "./skills"
-    ]
-  },
-  "engines": {
-    "node": ">=20.3"
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "*",
-    "typebox": "*"
-  }
-}
+{
+  "name": "pi-revit",
+  "version": "0.2.4",
+  "description": "Native Pi connector for Autodesk Revit. Run npx.cmd -y pi-revit for the full Windows install.",
+  "author": "Ahmad Altahlawi",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Triavision-ai/pi-revit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Triavision-ai/pi-revit/issues"
+  },
+  "homepage": "https://github.com/Triavision-ai/pi-revit#readme",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "revit",
+    "bim",
+    "autodesk",
+    "revit-api"
+  ],
+  "bin": {
+    "pi-revit": "bin/pi-revit.js"
+  },
+  "scripts": {
+    "deploy": "powershell -ExecutionPolicy Bypass -File scripts/deploy.ps1",
+    "setup": "powershell -ExecutionPolicy Bypass -File scripts/setup-workspace.ps1",
+    "uninstall:revit": "powershell -ExecutionPolicy Bypass -File scripts/uninstall.ps1"
+  },
+  "files": [
+    "bin/",
+    "extensions/",
+    "skills/",
+    "scripts/",
+    "src/",
+    "workspace/",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions/pi-revit/index.ts"
+    ],
+    "skills": [
+      "./skills"
+    ]
+  },
+  "engines": {
+    "node": ">=20.3"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  }
+}

package/src/Revit/Tools/SearchApiDocs.cs

@@ -183,10 +183,22 @@ namespace RevitBridge.Tools
             else
             {
                 markdown.Append(total == top.Count ? $"{total} match(es)." : $"top {top.Count} of {total} matches.");
+
+                // Same-named members from different namespaces (XYZ exists in
+                // Autodesk.Revit.DB and in helper namespaces) render identical
+                // signatures; disambiguate those lines with their full container path.
+                var ambiguous = top
+                    .GroupBy(member => member.Signature, StringComparer.Ordinal)
+                    .Where(group => group.Count() > 1)
+                    .Select(group => group.Key)
+                    .ToHashSet(StringComparer.Ordinal);
+
                 for (int i = 0; i < top.Count; i++)
                 {
                     var member = top[i];
                     string origin = member.Since is null ? member.Assembly : $"{member.Assembly}, since {member.Since}";
+                    if (ambiguous.Contains(member.Signature))
+                        origin += $", in {ContainingPath(member)}";
                     string line = $"\n{i + 1}. **{member.Signature}** — {KindLabel(member)} ({origin}) — {FirstSentence(member.Summary) ?? "(no summary)"}";
                     if (markdown.Length + line.Length > MaxMarkdownChars)
                     {
@@ -220,7 +232,14 @@ namespace RevitBridge.Tools
             if (member.Exceptions is { Count: > 0 } exceptions)
                 lines.Add($"\n   throws: {string.Join("; ", exceptions.Select(pair => $"{pair.Key} — {Cap(pair.Value, MaxParamDocChars)}"))}");
             if (overloadCount > 1)
-                lines.Add($"\n   note: {member.Composite} has {overloadCount} overload(s) listed; full docs shown for the simplest top-ranked one. To target another, continue the query past a parenthesis with parameter types, e.g. '{member.Composite}(Document, '.");
+            {
+                // The targeting example must be the query form the signature matcher
+                // actually accepts, so it is cut from the displayed signature itself —
+                // 'new XYZ(' for constructors, 'Wall.Create(' for methods.
+                int paren = member.Signature.IndexOf('(');
+                string example = paren >= 0 ? member.Signature[..(paren + 1)] : member.Composite + "(";
+                lines.Add($"\n   note: {member.Composite} has {overloadCount} overload(s) listed; full docs shown for the simplest top-ranked one. To target another, continue the query past a parenthesis with its parameter types, e.g. '{example}'.");
+            }
             foreach (string line in lines)
             {
                 if (markdown.Length + line.Length > MaxMarkdownChars)
@@ -229,6 +248,16 @@ namespace RevitBridge.Tools
             }
         }
 
+        /// <summary>Namespace-qualified container for disambiguating display lines:
+        /// the type itself for types, the declaring type's full path for members.</summary>
+        private static string ContainingPath(ApiMember member)
+        {
+            if (member.Kind == 'T')
+                return member.FullName;
+            int dot = member.FullName.LastIndexOf('.');
+            return dot > 0 ? member.FullName[..dot] : member.FullName;
+        }
+
         private static string KindLabel(ApiMember member) => member.IsConstructor ? "constructor" : member.Kind switch
         {
             'T' => "type",