{"_id":"@civaapple/qi-introspection","_rev":"2-4cf683127678ffb3517d20b131aaae0c","name":"@civaapple/qi-introspection","dist-tags":{"latest":"0.5.1"},"versions":{"0.5.0":{"name":"@civaapple/qi-introspection","version":"0.5.0","license":"MIT","_id":"@civaapple/qi-introspection@0.5.0","maintainers":[{"name":"civaapple","email":"civaapple@gmail.com"}],"homepage":"https://github.com/civaapple-alt/qi#readme","bugs":{"url":"https://github.com/civaapple-alt/qi/issues"},"dist":{"shasum":"4b79b88c72c3b21edb43370515925fdbd8b8ac61","tarball":"https://registry.npmjs.org/@civaapple/qi-introspection/-/qi-introspection-0.5.0.tgz","fileCount":24,"integrity":"sha512-O+hAkS1VthtNH+q5GKNzHCWAIEfg1jnEUyiGYiJwQDhtMMRYeoxTjUosIQy2yAkPpsB8kFle3eQxfqQ8aq2CAw==","signatures":[{"sig":"MEQCICHePcRmXM3bng19+WtrG1TtRnUOEpF8G5/3egoRdrWdAiA25eaQ64yz4Ch8HowDKXwFc2Ks+XMy12IFniT+rDStzQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@civaapple%2fqi-introspection@0.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":169683},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=22.19.0"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"9ae76a92cdcce130958d3f93c6ab5ba20149d424","_npmUser":{"name":"civaapple","email":"civaapple@gmail.com"},"repository":{"url":"git+https://github.com/civaapple-alt/qi.git","type":"git","directory":"packages/introspection"},"_npmVersion":"11.16.0","description":"Versioned self-model and read-only introspection adapters for Qi","directories":{},"_nodeVersion":"24.18.0","dependencies":{"@sinclair/typebox":"0.34.52","@civaapple/qi-tools":"0.5.0","@civaapple/qi-context":"0.5.0"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/qi-introspection_0.5.0_1785137656885_0.2712334559974472","host":"s3://npm-registry-packages-npm-production"}},"0.5.1":{"name":"@civaapple/qi-introspection","version":"0.5.1","description":"Versioned self-model and read-only introspection adapters for Qi","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"engines":{"node":">=22.19.0"},"dependencies":{"@civaapple/qi-context":"0.5.1","@civaapple/qi-kernel":"0.5.1","@civaapple/qi-protocol":"0.5.1","@civaapple/qi-tools":"0.5.1","@sinclair/typebox":"0.34.52"},"repository":{"type":"git","url":"git+https://github.com/civaapple-alt/qi.git","directory":"packages/introspection"},"homepage":"https://github.com/civaapple-alt/qi#readme","bugs":{"url":"https://github.com/civaapple-alt/qi/issues"},"license":"MIT","publishConfig":{"access":"public","provenance":true},"gitHead":"8b042be6fb43eda223b619286e9b3e5cb1e1c439","_id":"@civaapple/qi-introspection@0.5.1","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-f3PpVzug0I2du82QKRNrGjPdQbQAnXd7wMosdPbtVkQkvoNAdoNvYdWhE98qOGx/TZdj1awVIByy2u2rm655pQ==","shasum":"af2e2cacd8a23ce862fae5ff2d302caac0040749","tarball":"https://registry.npmjs.org/@civaapple/qi-introspection/-/qi-introspection-0.5.1.tgz","fileCount":28,"unpackedSize":209799,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@civaapple%2fqi-introspection@0.5.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCYj8uX3/OucsVVCvuWqlX1C1F45A8KSGaxNql5gPQrpQIhAJLDMkCP9XuwVqeOQ8XVLx2Nr/dgmk8kibJRwmfRynXE"}]},"_npmUser":{"name":"civaapple","email":"civaapple@gmail.com"},"directories":{},"maintainers":[{"name":"civaapple","email":"civaapple@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/qi-introspection_0.5.1_1785149317172_0.8000468931673141"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-27T07:34:16.742Z","modified":"2026-07-27T10:48:37.725Z","0.5.0":"2026-07-27T07:34:17.025Z","0.5.1":"2026-07-27T10:48:37.355Z"},"bugs":{"url":"https://github.com/civaapple-alt/qi/issues"},"license":"MIT","homepage":"https://github.com/civaapple-alt/qi#readme","repository":{"type":"git","url":"git+https://github.com/civaapple-alt/qi.git","directory":"packages/introspection"},"description":"Versioned self-model and read-only introspection adapters for Qi","maintainers":[{"name":"civaapple","email":"civaapple@gmail.com"}],"readme":"# `@civaapple/qi-introspection`\n\nVersion **0.5.1**. Package maturity: **internal public-package preview**.\n\nThis package gives Qi and contributors one versioned, machine-readable view of Qi's identity, package\nownership, invariants, architecture decisions, maturity, release gaps, and verification commands.\n\n## Purpose\n\n- Validate and query `QiSelfModel`.\n- Produce bounded Context blocks with explicit provenance and an authority disclaimer.\n- Provide the read-only `qi_introspect` Tool definition.\n- Provide bounded, read-only projections for Qi to inspect Sessions in its current project.\n- Detect drift between the self model, workspace packages, package READMEs, and the consolidated decision record.\n\n## Non-goals\n\n- Self knowledge does not grant a Capability Lease.\n- The package cannot edit source, policy, credentials, Session history, or release metadata.\n- It cannot promote package maturity or certify semantic/product success.\n- It does not load every design document into every prompt.\n\n## Quick start\n\n```sh\nnpm install @civaapple/qi-introspection\n```\n\n```ts\nimport {\n  createQiSelfContext,\n  qiSelfModel,\n  queryQiSelfModel,\n} from \"@civaapple/qi-introspection\";\n\nconsole.log(qiSelfModel.release);\nconsole.log(queryQiSelfModel(\"packages\"));\n\nconst context = createQiSelfContext([\"identity\", \"invariants\", \"gaps\"]);\n```\n\nRegister `createQiIntrospectionTool()` through an ordinary `ToolRegistry`. Execution still requires a\nmatching read lease for `qi:self-model:<section>`.\n\n`inspectQiSession(source, query)` lists project Sessions or narrows one Session to Runs, a selected/latest Run,\nproblems, the last Step, or one Step/Action. Summary and detail projections retain IDs, event sequence bounds,\nstatus, error codes, and any durable edit freshness rebase while bounding text, results, and lists and reporting\nevery omission.\n`createQiSessionInspectionTool(source, currentSessionId)` exposes the same semantics as `qi_session_inspect`.\nThe CLI injects only its current project EventStore; callers cannot supply a database path or cross-project root.\n\n## Public API\n\n- `QiSelfModelSchema` and `parseQiSelfModel()`\n- `qiSelfModel`\n- `queryQiSelfModel()`\n- `createQiSelfContext()`\n- `createQiIntrospectionTool()`\n- `inspectQiSession()` and `createQiSessionInspectionTool()`\n- `QiSessionInspectionQuery`, `QiSessionInspectionResult`, and `QiSessionInspectionSource`\n\n## Change guidance\n\nUpdate the self model when package ownership, architecture decisions, maturity, verification, or release blockers\nchange.\nCanonical design and executable evidence remain the source of truth; conflicts are reported rather than hidden.\n\n## Verification\n\n`tests/introspection.test.mjs` verifies schema parsing, package/README and decision coverage, bounded Context,\nread-only Tool identity, and denial without an explicit lease.\n","readmeFilename":"README.md"}