diff --git a/CHANGELOG.md b/CHANGELOG.md index c091248..a59a77d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,13 @@ # Changelog +## [1.1.1] - 2026-08-09 + +### Fixed + +- publish under the collision-safe npm name `@danielesuga/prodocs` while + retaining the `prodocs` command; +- document the scoped global-install and `npx` commands. + All notable changes to ProDocs are documented here. The project follows [Semantic Versioning](https://semver.org/) and [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). @@ -132,7 +140,8 @@ All notable changes to ProDocs are documented here. The project follows - Project-root containment for configured sources and generated output. - Versioned JSON Schemas for configuration and knowledge graph artifacts. -[Unreleased]: https://github.com/boyeesu/prodocs/compare/v1.1.0...HEAD +[Unreleased]: https://github.com/boyeesu/prodocs/compare/v1.1.1...HEAD +[1.1.1]: https://github.com/boyeesu/prodocs/compare/v1.1.0...v1.1.1 [1.1.0]: https://github.com/boyeesu/prodocs/compare/v1.0.0...v1.1.0 [1.0.0]: https://github.com/boyeesu/prodocs/compare/v0.2.0...v1.0.0 [0.2.0]: https://github.com/boyeesu/prodocs/compare/v0.1.0...v0.2.0 diff --git a/README.md b/README.md index e6d7208..07a2d4f 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,7 @@ providers can propose cited prose only after explicit network approval. ProDocs supports Node.js 20, 22, and 24 on Linux, macOS, and Windows. ```bash -npm install --global prodocs +npm install --global @danielesuga/prodocs cd /path/to/your/repository prodocs init diff --git a/docs/ADOPTION.md b/docs/ADOPTION.md index d7c1000..3d0f49e 100644 --- a/docs/ADOPTION.md +++ b/docs/ADOPTION.md @@ -6,7 +6,7 @@ consent-based so repository content never becomes analytics data. ## First session ```sh -npm install --global prodocs +npm install --global @danielesuga/prodocs prodocs tutorial --output prodocs-tutorial cd prodocs-tutorial prodocs sync diff --git a/docs/MATURITY.md b/docs/MATURITY.md index 4093e1f..643e1c0 100644 --- a/docs/MATURITY.md +++ b/docs/MATURITY.md @@ -1,7 +1,7 @@ # Code maturity assessment Assessment date: 2026-08-02 -Target: ProDocs `1.1.0`, Node.js CLI and JavaScript library +Target: ProDocs `1.1.1`, Node.js CLI and JavaScript library ## Executive summary diff --git a/docs/SUPPLY_CHAIN.md b/docs/SUPPLY_CHAIN.md index def20c4..b7cd937 100644 --- a/docs/SUPPLY_CHAIN.md +++ b/docs/SUPPLY_CHAIN.md @@ -5,7 +5,7 @@ ## Metadata - **Scan Date**: 2026-08-09 14:31 WAT -- **Project**: ProDocs 1.1.0 +- **Project**: ProDocs 1.1.1 - **Repositories Scanned**: 3 direct dependency repositories - **Total Dependencies**: 6 production packages excluding ProDocs - **Scan Duration**: approximately 2 minutes diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md index 0c8f597..4026fe1 100644 --- a/docs/TROUBLESHOOTING.md +++ b/docs/TROUBLESHOOTING.md @@ -6,8 +6,8 @@ knowledge health without sending data anywhere. ## `prodocs` is not found -Install globally with `npm install --global prodocs`, or use -`npx prodocs@`. Node.js 20 or newer is required. +Install globally with `npm install --global @danielesuga/prodocs`, or use +`npx @danielesuga/prodocs@`. Node.js 20 or newer is required. ## No files are indexed diff --git a/docs/prodocs/CODE_MAP.md b/docs/prodocs/CODE_MAP.md index 0adb069..b04d129 100644 --- a/docs/prodocs/CODE_MAP.md +++ b/docs/prodocs/CODE_MAP.md @@ -53,7 +53,7 @@ not prose claims. | [`test/collectors.test.js`](../../test/collectors.test.js) | JavaScript | 336 | @boyeesu | fixtures (value, L12) | | [`test/config.test.js`](../../test/config.test.js) | JavaScript | 151 | @boyeesu | — | | [`test/context.test.js`](../../test/context.test.js) | JavaScript | 174 | @boyeesu | hashes (value, L11)
node (function, L19)
edge (function, L39)
graph (function, L51) | -| [`test/package.test.js`](../../test/package.test.js) | JavaScript | 213 | @boyeesu | npmCli (value, L8)
execute (function, L20)
executeNpm (function, L49) | +| [`test/package.test.js`](../../test/package.test.js) | JavaScript | 214 | @boyeesu | npmCli (value, L8)
execute (function, L20)
executeNpm (function, L49) | | [`test/paths.test.js`](../../test/paths.test.js) | JavaScript | 44 | @boyeesu | — | | [`test/render.test.js`](../../test/render.test.js) | JavaScript | 64 | @boyeesu | graph (function, L9) | | [`test/roadmap.test.js`](../../test/roadmap.test.js) | JavaScript | 807 | @boyeesu | executeFile (value, L45)
project (function, L47)
config (function, L57) | diff --git a/docs/prodocs/SYSTEM_OVERVIEW.md b/docs/prodocs/SYSTEM_OVERVIEW.md index 04f6ef6..316fee5 100644 --- a/docs/prodocs/SYSTEM_OVERVIEW.md +++ b/docs/prodocs/SYSTEM_OVERVIEW.md @@ -9,11 +9,11 @@ | Signal | Value | | --- | --- | | Source files | 53 | -| Lines indexed | 8969 | +| Lines indexed | 8970 | | Symbols indexed | 280 | | Internal relationships | 392 | | Languages | JavaScript (52), TypeScript (1) | -| Evidence snapshot | `c4954720e45a` | +| Evidence snapshot | `5bf468818e97` | ## Entrypoints @@ -42,4 +42,4 @@ - Agents should read `knowledge.json` or run `prodocs context --path --json`. - CI should run `prodocs check` to reject stale generated documentation. -Generated at 2026-08-09T13:47:32.853Z. +Generated at 2026-08-09T14:07:41.484Z. diff --git a/docs/prodocs/knowledge.json b/docs/prodocs/knowledge.json index 1e75701..12f3b28 100644 --- a/docs/prodocs/knowledge.json +++ b/docs/prodocs/knowledge.json @@ -1,13 +1,13 @@ { "schemaVersion": 2, - "generatedAt": "2026-08-09T13:47:32.853Z", - "sourceHash": "c4954720e45abaa47eedc9c1cc7339a85ae0f0c93c483ce33b5d25e5ae7166fb", + "generatedAt": "2026-08-09T14:07:41.484Z", + "sourceHash": "5bf468818e9705d5befe2746cb0128cebf8f46d4b24c1503abef9fcc7a1075b9", "knowledgeHash": "5dbba2bd8dca744e6931eb3d10ec98e69d5cc46498dea74a83de2419d80e4053", - "inputHash": "ee93b337f58848babf9c4acb1349762dc2ac1bfab3bc9a0ffbacce16bd92e8c3", + "inputHash": "c48497c0449cb9a38da206a8435a8decb187e6c1e0f099809dcc536e2b1c86dc", "root": ".", "stats": { "files": 53, - "lines": 8969, + "lines": 8970, "symbols": 280, "edges": 392, "languages": { @@ -901,7 +901,7 @@ "type": "file", "path": "src/constants.js", "language": "JavaScript", - "contentHash": "8e07bba642b4b4d8b21fae3cf81d2ee8c529699071ef2be9488a08bb7ac68922", + "contentHash": "94f163b802dacdff391ae6fa6276a136721061e2595f6484bb1dc518924f2702", "lines": 115, "owner": "@boyeesu", "entrypoint": false, @@ -2134,7 +2134,7 @@ "type": "file", "path": "test/collectors.test.js", "language": "JavaScript", - "contentHash": "60158fb5d27a1d3400277378fe4f3a086464477dda4b1dd747fb15a2e0f57c1c", + "contentHash": "5ae51be57b000a133e9c52f7d35809a95312ae4649332e0905bcadfd67762644", "lines": 336, "owner": "@boyeesu", "entrypoint": false, @@ -2212,8 +2212,8 @@ "type": "file", "path": "test/package.test.js", "language": "JavaScript", - "contentHash": "adca7c990731b38b3984bc7b9e4180668d8453325a669f987014d882998fc1aa", - "lines": 213, + "contentHash": "84a743550108e8f11a6747434e8fc6fa0ee22caf81bfec96b392aaef104fb2c6", + "lines": 214, "owner": "@boyeesu", "entrypoint": false, "publicSurface": false, diff --git a/docs/prodocs/manifest.json b/docs/prodocs/manifest.json index 9cf1734..686510a 100644 --- a/docs/prodocs/manifest.json +++ b/docs/prodocs/manifest.json @@ -1,12 +1,12 @@ { "schemaVersion": 2, - "sourceHash": "c4954720e45abaa47eedc9c1cc7339a85ae0f0c93c483ce33b5d25e5ae7166fb", + "sourceHash": "5bf468818e9705d5befe2746cb0128cebf8f46d4b24c1503abef9fcc7a1075b9", "knowledgeHash": "5dbba2bd8dca744e6931eb3d10ec98e69d5cc46498dea74a83de2419d80e4053", - "inputHash": "ee93b337f58848babf9c4acb1349762dc2ac1bfab3bc9a0ffbacce16bd92e8c3", - "generatedAt": "2026-08-09T13:47:32.853Z", + "inputHash": "c48497c0449cb9a38da206a8435a8decb187e6c1e0f099809dcc536e2b1c86dc", + "generatedAt": "2026-08-09T14:07:41.484Z", "stats": { "files": 53, - "lines": 8969, + "lines": 8970, "symbols": 280, "edges": 392, "languages": { diff --git a/docs/prodocs/views/coding-agents.md b/docs/prodocs/views/coding-agents.md index 2ad3991..a6afaf8 100644 --- a/docs/prodocs/views/coding-agents.md +++ b/docs/prodocs/views/coding-agents.md @@ -23,5 +23,5 @@ - **Evidence-backed knowledge kernel** (`feature:evidence-kernel`, supported) — [source](../knowledge/features/evidence-kernel.md) - **Repository content is untrusted data** (`invariant:untrusted-repository`, supported) — [source](../knowledge/invariants/untrusted-repository.md) -Evidence snapshot: `c4954720e45a`; knowledge snapshot: +Evidence snapshot: `5bf468818e97`; knowledge snapshot: `5dbba2bd8dca`. diff --git a/docs/prodocs/views/operations.md b/docs/prodocs/views/operations.md index ddbe129..fa16a5e 100644 --- a/docs/prodocs/views/operations.md +++ b/docs/prodocs/views/operations.md @@ -10,5 +10,5 @@ Verification steps require an explicit content-bound approval hash before execution. -Evidence snapshot: `c4954720e45a`; knowledge snapshot: +Evidence snapshot: `5bf468818e97`; knowledge snapshot: `5dbba2bd8dca`. diff --git a/docs/prodocs/views/product.md b/docs/prodocs/views/product.md index d4afc6a..5d7bb84 100644 --- a/docs/prodocs/views/product.md +++ b/docs/prodocs/views/product.md @@ -16,5 +16,5 @@ - **Core workflows remain local-first** (`claim:local-first`, supported) — [source](../knowledge/claims/local-first.md) -Evidence snapshot: `c4954720e45a`; knowledge snapshot: +Evidence snapshot: `5bf468818e97`; knowledge snapshot: `5dbba2bd8dca`. diff --git a/docs/prodocs/views/security.md b/docs/prodocs/views/security.md index e431bbf..650bfc9 100644 --- a/docs/prodocs/views/security.md +++ b/docs/prodocs/views/security.md @@ -15,5 +15,5 @@ - 1 indexed path(s) contain instruction-like text requiring review. - 0 authored item(s) need evidence. -Evidence snapshot: `c4954720e45a`; knowledge snapshot: +Evidence snapshot: `5bf468818e97`; knowledge snapshot: `5dbba2bd8dca`. diff --git a/docs/prodocs/views/support.md b/docs/prodocs/views/support.md index e83c901..984670f 100644 --- a/docs/prodocs/views/support.md +++ b/docs/prodocs/views/support.md @@ -17,5 +17,5 @@ - **Verify ProDocs for production** (`runbook:production-verification`, supported) — [source](../knowledge/runbooks/production-verification.md) -Evidence snapshot: `c4954720e45a`; knowledge snapshot: +Evidence snapshot: `5bf468818e97`; knowledge snapshot: `5dbba2bd8dca`. diff --git a/docs/prodocs/views/technical.md b/docs/prodocs/views/technical.md index 7a5967c..b40f4c5 100644 --- a/docs/prodocs/views/technical.md +++ b/docs/prodocs/views/technical.md @@ -27,5 +27,5 @@ - **Repository content is untrusted data** (`invariant:untrusted-repository`, supported) — [source](../knowledge/invariants/untrusted-repository.md) - **Verify ProDocs for production** (`runbook:production-verification`, supported) — [source](../knowledge/runbooks/production-verification.md) -Evidence snapshot: `c4954720e45a`; knowledge snapshot: +Evidence snapshot: `5bf468818e97`; knowledge snapshot: `5dbba2bd8dca`. diff --git a/package-lock.json b/package-lock.json index 5a76dca..6ab97ca 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { - "name": "prodocs", - "version": "1.1.0", + "name": "@danielesuga/prodocs", + "version": "1.1.1", "lockfileVersion": 3, "requires": true, "packages": { "": { - "name": "prodocs", - "version": "1.1.0", + "name": "@danielesuga/prodocs", + "version": "1.1.1", "license": "Apache-2.0", "dependencies": { "@babel/parser": "7.28.5", diff --git a/package.json b/package.json index da884d9..aeacf76 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { - "name": "prodocs", - "version": "1.1.0", + "name": "@danielesuga/prodocs", + "version": "1.1.1", "description": "Evidence-backed documentation and context infrastructure for codebases and coding agents.", "type": "module", "author": "ProDocs contributors", diff --git a/src/constants.js b/src/constants.js index e37a1e0..ca7af7a 100644 --- a/src/constants.js +++ b/src/constants.js @@ -1,4 +1,4 @@ -export const VERSION = "1.1.0"; +export const VERSION = "1.1.1"; export const DEFAULT_CONFIG = { $schema: diff --git a/test/collectors.test.js b/test/collectors.test.js index 9e6319c..8b60ead 100644 --- a/test/collectors.test.js +++ b/test/collectors.test.js @@ -7,7 +7,7 @@ import { createCollectorRegistry, defaultCollectorRegistry, defineCollector -} from "prodocs/collectors"; +} from "@danielesuga/prodocs/collectors"; const fixtures = [ { diff --git a/test/package.test.js b/test/package.test.js index 43d732c..c82aefa 100644 --- a/test/package.test.js +++ b/test/package.test.js @@ -161,6 +161,7 @@ test("published package installs and completes the documented workflow", async ( const installedCli = path.join( consumer, "node_modules", + "@danielesuga", "prodocs", "bin", "prodocs.js"