Merge pull request #103 from constructive-io/fix/broken-skill-links

fix: repair 11 broken cross-references + add constructive-pnpm to indexes

Author: pyramation

.agents/skills/constructive-platform/references/blueprint-definition-format.md

@@ -100,7 +100,7 @@ For default storage policies and the full policy format, see [storage-policies.m
 
 **Table map integration:** Entity tables created by Phase 0 are added to the internal `table_map`, so subsequent `tables` and `relations` can reference them by name (e.g. `"target_table": "channels"`).
 
-See the [`constructive-sdk-entities`](../constructive-sdk-entities/SKILL.md) skill for the full entity types reference.
+See the [`constructive-sdk-entities`](../../constructive-sdk-entities/SKILL.md) skill for the full entity types reference.
 
 ## Table Entries
 
@@ -314,7 +314,7 @@ Each entry grants every role in `roles[]` the cross-product of all `privileges[]
 | `policy_name` | string | No | Custom policy name |
 | `policy_role` | string | No | Role the policy applies to |
 
-See the [constructive-safegres](../constructive-safegres/SKILL.md) skill for all 14 Authz* policy types and their config shapes.
+See the [constructive-safegres](../../constructive-safegres/SKILL.md) skill for all 14 Authz* policy types and their config shapes.
 
 **`entity_type` resolution:** For membership-based policies (`AuthzMembership`, `AuthzEntityMembership`, `AuthzRelatedEntityMembership`, `AuthzPeerOwnership`, `AuthzRelatedPeerOwnership`), you can use `"entity_type": "channel"` (the prefix string) instead of `"membership_type": 3` (a hardcoded integer). The RLS parser resolves the prefix to the correct `membership_type` integer via `memberships_module` lookup. This is recommended for dynamic types (3+) where the int depends on provisioning order. Both forms continue to work.
 

.agents/skills/constructive-platform/references/blueprints.md

@@ -248,6 +248,6 @@ No special handling is needed — blueprints compose the existing primitives.
 ## Cross-References
 
 - **Definition format:** See [blueprint-definition-format.md](./blueprint-definition-format.md) for the blueprint definition format spec
-- **Safegres policies:** See [constructive-safegres](../constructive-safegres/SKILL.md) for Authz* policy types used in `policies[]`
-- **Codegen:** See [constructive-graphql](../constructive-sdk-graphql/SKILL.md) for generating typed SDK from provisioned tables
+- **Safegres policies:** See [constructive-safegres](../../constructive-safegres/SKILL.md) for Authz* policy types used in `policies[]`
+- **Codegen:** See [constructive-sdk-graphql](../../constructive-sdk-graphql/SKILL.md) for generating typed SDK from provisioned tables
 - **Server config:** See [server-config.md](./server-config.md) for running introspection and codegen

.agents/skills/constructive-platform/references/storage-policies.md

@@ -333,13 +333,13 @@ Any `Authz*` node type from the registry can be used. The most relevant ones for
 | `AuthzAllowAll` | No restrictions (use sparingly) | — | All three |
 | `AuthzDenyAll` | Lock down completely (admin override only) | — | All three |
 
-See the [`constructive-safegres`](../constructive-safegres/SKILL.md) skill for the full list of 14 Authz* types and their config shapes.
+See the [`constructive-safegres`](../../constructive-safegres/SKILL.md) skill for the full list of 14 Authz* types and their config shapes.
 
 ## Cross-references
 
-- **Safegres protocol (Authz* types):** [`constructive-safegres`](../constructive-safegres/SKILL.md)
-- **Custom entities & provisioning:** [`constructive-sdk-entities`](../constructive-sdk-entities/SKILL.md)
+- **Safegres protocol (Authz* types):** [`constructive-safegres`](../../constructive-safegres/SKILL.md)
+- **Custom entities & provisioning:** [`constructive-sdk-entities`](../../constructive-sdk-entities/SKILL.md)
 - **Blueprint definition format:** [blueprint-definition-format.md](./blueprint-definition-format.md)
-- **Upload flow (GraphQL mutations, client library):** [`constructive-sdk-uploads`](../constructive-sdk-uploads/SKILL.md)
+- **Upload flow (GraphQL mutations, client library):** [`constructive-sdk-uploads`](../../constructive-sdk-uploads/SKILL.md)
 - **Multi-scope bucket resolution:** `multi-scope-bucket-resolution` skill in `constructive-db`
 - **SQL-level security details:** `constructive-db-security-sql` skill in `constructive-db`

.agents/skills/constructive-sdk-graphql/SKILL.md

@@ -84,7 +84,7 @@ const results = await db.article.findMany({
 }).execute();
 ```
 
-`searchScore` is computed server-side — no need to select individual score fields. See [search.md](./references/search.md) for all strategies and combined patterns.
+`searchScore` is computed server-side — no need to select individual score fields. See [search-composite.md](./references/search-composite.md) for all strategies and combined patterns.
 
 ## Quick Start: Pagination
 
@@ -145,7 +145,7 @@ See [codegen-hooks-patterns.md](./references/codegen-hooks-patterns.md) for adva
 | **PostGIS** | Location queries, geofencing, proximity | Depends on operator |
 | **Unified** | Multi-signal ranking via `unifiedSearch` + `searchScore` | Higher = more relevant (0..1) |
 
-See [search.md](./references/search.md) for the decision matrix and combined query patterns.
+See [search-composite.md](./references/search-composite.md) for the decision matrix and combined query patterns.
 
 ## Reference Guide
 
@@ -177,7 +177,7 @@ See [search.md](./references/search.md) for the decision matrix and combined que
 
 | Reference | Topic | Consult When |
 |-----------|-------|--------------|
-| [search.md](./references/search.md) | Search overview, decision matrix, combined patterns | Choosing a strategy, combining algorithms, score fields |
+| [search-composite.md](./references/search-composite.md) | Search overview, decision matrix, combined patterns | Choosing a strategy, combining algorithms, score fields |
 | [search-tsvector.md](./references/search-tsvector.md) | TSVector full-text search | Creating tsvector columns, GIN indexes, querying |
 | [search-bm25.md](./references/search-bm25.md) | BM25 ranked search | Creating BM25 indexes, querying with negative scores |
 | [search-trigram.md](./references/search-trigram.md) | Trigram fuzzy matching | `similarTo`, `wordSimilarTo`, `@trgmSearch` smart tag |

AGENTS.md

@@ -13,6 +13,7 @@ A collection of skills for AI coding agents working with Constructive tooling. S
 | **constructive-features** | *(router)* | Feature catalog routing to the authoritative skill for every capability |
 | **constructive-platform** | safegres, services-schemas, deployment, server-config, functions, cnc-execution-engine, constructive-env | Platform core |
 | **pgpm** | github-workflows-pgpm | Database migrations, CLI, Docker, CI/CD |
+| **constructive-pnpm** | *(standalone)* | PNPM workspace management, dist-folder publishing, dependency management |
 | **constructive-sdk-graphql** | graphql-codegen, sdk-search, graphql-query | SDK codegen (ORM, hooks, CLI), runtime queries, search, pagination |
 | **constructive-starter-kits** | boilerplate-pgpm-init, boilerplate-nextjs-app, boilerplate-authoring | Project scaffolding via `pgpm init` |
 | **constructive-frontend** | constructive-ui, crud-stack, meta-forms | UI components, Stack cards, dynamic forms |

CLAUDE.md

@@ -15,6 +15,7 @@ A collection of skills for AI coding agents working with Constructive tooling. S
 | **constructive-safegres** | Safegres authorization protocol — all 14 Authz* policy types, config shapes, semantics, permissive/restrictive composition |
 | **constructive-setup** | Monorepo setup — install dependencies, start PostgreSQL via pgpm Docker, bootstrap users, build, run tests, local email services |
 | **pgpm** | PostgreSQL Package Manager — migrations, CLI, Docker, CI/CD workflows |
+| **constructive-pnpm** | PNPM workspace management — monorepo config, dist-folder publishing with makage/lerna, dependency management |
 | **constructive-sdk-graphql** | SDK GraphQL — codegen (hooks, ORM, CLI), runtime queries, search (all algorithms), pagination |
 | **constructive-sdk-entities** | Entity types — custom entities (channels, teams, data rooms), memberships, entity-scoped storage |
 | **constructive-sdk-uploads** | File uploads — presigned URL flow, bucket provisioning, upload-client, deduplication |