@suss/adapter-python 0.3.2-0

package/grammar/NOTICE

@@ -0,0 +1,28 @@
+tree-sitter-python.wasm in this directory is built from the
+tree-sitter-python grammar, version 0.23.6:
+
+  https://github.com/tree-sitter/tree-sitter-python
+
+Its license, reproduced in full:
+
+The MIT License (MIT)
+
+Copyright (c) 2016 Max Brunsfeld
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/grammar/README.md

@@ -0,0 +1,37 @@
+# grammar/
+
+`tree-sitter-python.wasm` is the compiled Python grammar for
+[web-tree-sitter](https://www.npmjs.com/package/web-tree-sitter). It is
+a checked-in binary asset, not a build output: `src/parser.ts` loads it
+by path at run time (`Language.load(...)`), so the file has to exist on
+disk next to the compiled adapter, the same way `web-tree-sitter` ships
+its own core `.wasm` next to its JS.
+
+The adapter depends only on `web-tree-sitter` (pure WASM, no native
+bindings, no install script). It does not depend on the
+`tree-sitter-python` npm package, because that package's `install`
+script runs `node-gyp-build` to load a native binding, which is
+unnecessary here and the kind of native-toolchain surface the
+language-adapters proposal rules out. This file is the one part of
+that package v0 actually needs, taken out on its own.
+
+Provenance, so a grammar bump is a deliberate, checkable act:
+
+- Source: `tree-sitter-python` npm package, version `0.23.6`.
+- File: `tree-sitter-python.wasm` from the package root (built by that
+  package's own `tree-sitter build --wasm`, published pre-built).
+- SHA-256: `8c93692fb368e288a5824cee55773c9b3602804f513bda48c97661e52e9c2da2`.
+
+tree-sitter-python is MIT-licensed. [`NOTICE`](./NOTICE) in this
+directory reproduces its copyright and permission notice in full, and
+ships in the published tarball alongside the `.wasm` file (both live
+under `grammar/`, which the package's `files` field includes), so the
+attribution its license requires travels with the binary it covers.
+
+To pick up a newer grammar: `npm pack tree-sitter-python@<version>`,
+extract it, copy `tree-sitter-python.wasm` here, update the version and
+hash above, check `NOTICE` still matches that version's `LICENSE` file,
+and re-run the adapter's test suite. A grammar change that renames or
+restructures a node type used in `src/ast.ts` will fail loudly there.
+The fuzzer's parse-failure-rate reporting (per the language-adapters
+proposal) is the longer-term signal for when a bump is worth doing.

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@suss/adapter-python",
+  "version": "0.3.2-0",
+  "type": "module",
+  "description": "Python language adapter for suss — parses source with tree-sitter (WASM), resolves names with a lexical binder, and emits raw extractions for the suss pipeline.",
+  "keywords": [
+    "suss",
+    "behavioral-summary",
+    "static-analysis",
+    "python",
+    "tree-sitter",
+    "ast"
+  ],
+  "license": "Apache-2.0",
+  "author": "Nimbus Cloud AI LLC",
+  "homepage": "https://github.com/nimbuscloud-ai/suss/tree/main/packages/adapter/python#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nimbuscloud-ai/suss.git",
+    "directory": "packages/adapter/python"
+  },
+  "bugs": {
+    "url": "https://github.com/nimbuscloud-ai/suss/issues"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "grammar",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@suss/behavioral-ir": "0.3.2",
+    "@suss/datalog": "0.3.2",
+    "@suss/extractor": "0.3.2",
+    "web-tree-sitter": "^0.26.11"
+  },
+  "devDependencies": {
+    "@types/node": "*",
+    "tsup": "*",
+    "typescript": "*",
+    "vitest": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}