npm - @lssm/example.wealth-snapshot - Versions diffs - 0.0.0-canary-20251219202229 → 0.0.0-canary-20251220015515 - Mend

@lssm/example.wealth-snapshot 0.0.0-canary-20251219202229 → 0.0.0-canary-20251220015515

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (66) hide show

package/dist/libs/contracts/dist/capabilities/openbanking.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"openbanking.js","names":[],"sources":["../../../../../../../libs/contracts/dist/capabilities/openbanking.js"],"sourcesContent":["import { StabilityEnum } from \"../ownership.js\";\n\n//#region src/capabilities/openbanking.ts\nconst OWNERS = [\"platform.finance\"];\nconst TAGS = [\"open-banking\", \"finance\"];\nconst openBankingAccountsReadCapability = {\n\tmeta: {\n\t\tkey: \"openbanking.accounts.read\",\n\t\tversion: 1,\n\t\tkind: \"integration\",\n\t\ttitle: \"Open Banking Accounts (Read)\",\n\t\tdescription: \"Provides read-only access to linked bank accounts, including account summaries and metadata.\",\n\t\tdomain: \"finance\",\n\t\towners: [...OWNERS],\n\t\ttags: [...TAGS],\n\t\tstability: StabilityEnum.Experimental\n\t},\n\tprovides: [\n\t\t{\n\t\t\tsurface: \"operation\",\n\t\t\tname: \"openbanking.accounts.list\",\n\t\t\tversion: 1,\n\t\t\tdescription: \"List bank accounts linked to a Powens open banking connection.\"\n\t\t},\n\t\t{\n\t\t\tsurface: \"operation\",\n\t\t\tname: \"openbanking.accounts.get\",\n\t\t\tversion: 1,\n\t\t\tdescription: \"Retrieve the canonical bank account record for a specific account.\"\n\t\t},\n\t\t{\n\t\t\tsurface: \"operation\",\n\t\t\tname: \"openbanking.accounts.sync\",\n\t\t\tversion: 1,\n\t\t\tdescription: \"Trigger a refresh of bank account metadata from the open banking provider.\"\n\t\t}\n\t]\n};\nconst openBankingTransactionsReadCapability = {\n\tmeta: {\n\t\tkey: \"openbanking.transactions.read\",\n\t\tversion: 1,\n\t\tkind: \"integration\",\n\t\ttitle: \"Open Banking Transactions (Read)\",\n\t\tdescription: \"Enables retrieval of transaction history for linked bank accounts via open banking providers.\",\n\t\tdomain: \"finance\",\n\t\towners: [...OWNERS],\n\t\ttags: [...TAGS, \"transactions\"],\n\t\tstability: StabilityEnum.Experimental\n\t},\n\tprovides: [{\n\t\tsurface: \"operation\",\n\t\tname: \"openbanking.transactions.list\",\n\t\tversion: 1,\n\t\tdescription: \"List transactions for a given bank account with optional date filtering.\"\n\t}, {\n\t\tsurface: \"operation\",\n\t\tname: \"openbanking.transactions.sync\",\n\t\tversion: 1,\n\t\tdescription: \"Synchronise transactions from the open banking provider into the canonical ledger.\"\n\t}]\n};\nconst openBankingBalancesReadCapability = {\n\tmeta: {\n\t\tkey: \"openbanking.balances.read\",\n\t\tversion: 1,\n\t\tkind: \"integration\",\n\t\ttitle: \"Open Banking Balances (Read)\",\n\t\tdescription: \"Allows querying of current and available balances for linked bank accounts via open banking providers.\",\n\t\tdomain: \"finance\",\n\t\towners: [...OWNERS],\n\t\ttags: [...TAGS, \"balances\"],\n\t\tstability: StabilityEnum.Experimental\n\t},\n\tprovides: [{\n\t\tsurface: \"operation\",\n\t\tname: \"openbanking.balances.get\",\n\t\tversion: 1,\n\t\tdescription: \"Retrieve the latest known balances for a specified bank account.\"\n\t}, {\n\t\tsurface: \"operation\",\n\t\tname: \"openbanking.balances.refresh\",\n\t\tversion: 1,\n\t\tdescription: \"Force a balance refresh from the open banking provider.\"\n\t}]\n};\nfunction registerOpenBankingCapabilities(registry) {\n\treturn registry.register(openBankingAccountsReadCapability).register(openBankingTransactionsReadCapability).register(openBankingBalancesReadCapability);\n}\n\n//#endregion\nexport { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities }~~;\n//# sourceMappingURL=openbanking.js.map~~"],"mappings":";;;AAGA,MAAM,SAAS,CAAC,mBAAmB;AACnC,MAAM,OAAO,CAAC,gBAAgB,UAAU;AACxC,MAAM,oCAAoC;CACzC,MAAM;EACL,KAAK;EACL,SAAS;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM,CAAC,GAAG,KAAK;EACf,WAAW,cAAc;EACzB;CACD,UAAU;EACT;GACC,SAAS;GACT,MAAM;GACN,SAAS;GACT,aAAa;GACb;EACD;GACC,SAAS;GACT,MAAM;GACN,SAAS;GACT,aAAa;GACb;EACD;GACC,SAAS;GACT,MAAM;GACN,SAAS;GACT,aAAa;GACb;EACD;CACD;AACD,MAAM,wCAAwC;CAC7C,MAAM;EACL,KAAK;EACL,SAAS;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM,CAAC,GAAG,MAAM,eAAe;EAC/B,WAAW,cAAc;EACzB;CACD,UAAU,CAAC;EACV,SAAS;EACT,MAAM;EACN,SAAS;EACT,aAAa;EACb,EAAE;EACF,SAAS;EACT,MAAM;EACN,SAAS;EACT,aAAa;EACb,CAAC;CACF;AACD,MAAM,oCAAoC;CACzC,MAAM;EACL,KAAK;EACL,SAAS;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM,CAAC,GAAG,MAAM,WAAW;EAC3B,WAAW,cAAc;EACzB;CACD,UAAU,CAAC;EACV,SAAS;EACT,MAAM;EACN,SAAS;EACT,aAAa;EACb,EAAE;EACF,SAAS;EACT,MAAM;EACN,SAAS;EACT,aAAa;EACb,CAAC;CACF"}
1	+ {"version":3,"file":"openbanking.js","names":[],"sources":["../../../../../../../libs/contracts/dist/capabilities/openbanking.js"],"sourcesContent":["import { StabilityEnum } from \"../ownership.js\";\n\n//#region src/capabilities/openbanking.ts\nconst OWNERS = [\"platform.finance\"];\nconst TAGS = [\"open-banking\", \"finance\"];\nconst openBankingAccountsReadCapability = {\n\tmeta: {\n\t\tkey: \"openbanking.accounts.read\",\n\t\tversion: 1,\n\t\tkind: \"integration\",\n\t\ttitle: \"Open Banking Accounts (Read)\",\n\t\tdescription: \"Provides read-only access to linked bank accounts, including account summaries and metadata.\",\n\t\tdomain: \"finance\",\n\t\towners: [...OWNERS],\n\t\ttags: [...TAGS],\n\t\tstability: StabilityEnum.Experimental\n\t},\n\tprovides: [\n\t\t{\n\t\t\tsurface: \"operation\",\n\t\t\tname: \"openbanking.accounts.list\",\n\t\t\tversion: 1,\n\t\t\tdescription: \"List bank accounts linked to a Powens open banking connection.\"\n\t\t},\n\t\t{\n\t\t\tsurface: \"operation\",\n\t\t\tname: \"openbanking.accounts.get\",\n\t\t\tversion: 1,\n\t\t\tdescription: \"Retrieve the canonical bank account record for a specific account.\"\n\t\t},\n\t\t{\n\t\t\tsurface: \"operation\",\n\t\t\tname: \"openbanking.accounts.sync\",\n\t\t\tversion: 1,\n\t\t\tdescription: \"Trigger a refresh of bank account metadata from the open banking provider.\"\n\t\t}\n\t]\n};\nconst openBankingTransactionsReadCapability = {\n\tmeta: {\n\t\tkey: \"openbanking.transactions.read\",\n\t\tversion: 1,\n\t\tkind: \"integration\",\n\t\ttitle: \"Open Banking Transactions (Read)\",\n\t\tdescription: \"Enables retrieval of transaction history for linked bank accounts via open banking providers.\",\n\t\tdomain: \"finance\",\n\t\towners: [...OWNERS],\n\t\ttags: [...TAGS, \"transactions\"],\n\t\tstability: StabilityEnum.Experimental\n\t},\n\tprovides: [{\n\t\tsurface: \"operation\",\n\t\tname: \"openbanking.transactions.list\",\n\t\tversion: 1,\n\t\tdescription: \"List transactions for a given bank account with optional date filtering.\"\n\t}, {\n\t\tsurface: \"operation\",\n\t\tname: \"openbanking.transactions.sync\",\n\t\tversion: 1,\n\t\tdescription: \"Synchronise transactions from the open banking provider into the canonical ledger.\"\n\t}]\n};\nconst openBankingBalancesReadCapability = {\n\tmeta: {\n\t\tkey: \"openbanking.balances.read\",\n\t\tversion: 1,\n\t\tkind: \"integration\",\n\t\ttitle: \"Open Banking Balances (Read)\",\n\t\tdescription: \"Allows querying of current and available balances for linked bank accounts via open banking providers.\",\n\t\tdomain: \"finance\",\n\t\towners: [...OWNERS],\n\t\ttags: [...TAGS, \"balances\"],\n\t\tstability: StabilityEnum.Experimental\n\t},\n\tprovides: [{\n\t\tsurface: \"operation\",\n\t\tname: \"openbanking.balances.get\",\n\t\tversion: 1,\n\t\tdescription: \"Retrieve the latest known balances for a specified bank account.\"\n\t}, {\n\t\tsurface: \"operation\",\n\t\tname: \"openbanking.balances.refresh\",\n\t\tversion: 1,\n\t\tdescription: \"Force a balance refresh from the open banking provider.\"\n\t}]\n};\nfunction registerOpenBankingCapabilities(registry) {\n\treturn registry.register(openBankingAccountsReadCapability).register(openBankingTransactionsReadCapability).register(openBankingBalancesReadCapability);\n}\n\n//#endregion\nexport { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities };"],"mappings":";;;AAGA,MAAM,SAAS,CAAC,mBAAmB;AACnC,MAAM,OAAO,CAAC,gBAAgB,UAAU;AACxC,MAAM,oCAAoC;CACzC,MAAM;EACL,KAAK;EACL,SAAS;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM,CAAC,GAAG,KAAK;EACf,WAAW,cAAc;EACzB;CACD,UAAU;EACT;GACC,SAAS;GACT,MAAM;GACN,SAAS;GACT,aAAa;GACb;EACD;GACC,SAAS;GACT,MAAM;GACN,SAAS;GACT,aAAa;GACb;EACD;GACC,SAAS;GACT,MAAM;GACN,SAAS;GACT,aAAa;GACb;EACD;CACD;AACD,MAAM,wCAAwC;CAC7C,MAAM;EACL,KAAK;EACL,SAAS;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM,CAAC,GAAG,MAAM,eAAe;EAC/B,WAAW,cAAc;EACzB;CACD,UAAU,CAAC;EACV,SAAS;EACT,MAAM;EACN,SAAS;EACT,aAAa;EACb,EAAE;EACF,SAAS;EACT,MAAM;EACN,SAAS;EACT,aAAa;EACb,CAAC;CACF;AACD,MAAM,oCAAoC;CACzC,MAAM;EACL,KAAK;EACL,SAAS;EACT,MAAM;EACN,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM,CAAC,GAAG,MAAM,WAAW;EAC3B,WAAW,cAAc;EACzB;CACD,UAAU,CAAC;EACV,SAAS;EACT,MAAM;EACN,SAAS;EACT,aAAa;EACb,EAAE;EACF,SAAS;EACT,MAAM;EACN,SAAS;EACT,aAAa;EACb,CAAC;CACF"}

package/dist/libs/contracts/dist/contract-registry/schemas.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"schemas.js","names":[],"sources":["../../../../../../../libs/contracts/dist/contract-registry/schemas.js"],"sourcesContent":["import { StabilityEnum } from \"../ownership.js\";\nimport z from \"zod\";\n\n//#region src/contract-registry/schemas.ts\nconst ContractRegistryItemTypeValues = [\n\t\"contractspec:operation\",\n\t\"contractspec:event\",\n\t\"contractspec:presentation\",\n\t\"contractspec:form\",\n\t\"contractspec:feature\",\n\t\"contractspec:workflow\",\n\t\"contractspec:template\",\n\t\"contractspec:integration\",\n\t\"contractspec:data-view\",\n\t\"contractspec:migration\",\n\t\"contractspec:telemetry\",\n\t\"contractspec:experiment\",\n\t\"contractspec:app-config\",\n\t\"contractspec:knowledge\"\n];\nconst ContractRegistryItemTypeSchema = z.enum(ContractRegistryItemTypeValues);\nconst ContractRegistryFileSchema = z.object({\n\tpath: z.string().min(1),\n\ttype: z.string().min(1),\n\tcontent: z.string().optional()\n});\nconst ContractRegistryItemSchema = z.object({\n\tname: z.string().min(1),\n\ttype: ContractRegistryItemTypeSchema,\n\tversion: z.number().int().nonnegative(),\n\ttitle: z.string().min(1),\n\tdescription: z.string().min(1),\n\tmeta: z.object({\n\t\tstability: z.enum([\n\t\t\tStabilityEnum.Idea,\n\t\t\tStabilityEnum.InCreation,\n\t\t\tStabilityEnum.Experimental,\n\t\t\tStabilityEnum.Beta,\n\t\t\tStabilityEnum.Stable,\n\t\t\tStabilityEnum.Deprecated\n\t\t]),\n\t\towners: z.array(z.string().min(1)).default([]),\n\t\ttags: z.array(z.string().min(1)).default([])\n\t}),\n\tdependencies: z.array(z.string().min(1)).optional(),\n\tregistryDependencies: z.array(z.string().min(1)).optional(),\n\tfiles: z.array(ContractRegistryFileSchema).min(1),\n\tschema: z.object({\n\t\tinput: z.unknown().optional(),\n\t\toutput: z.unknown().optional()\n\t}).optional()\n});\nconst ContractRegistryManifestSchema = z.object({\n\t$schema: z.string().min(1).optional(),\n\tname: z.string().min(1),\n\thomepage: z.string().min(1).optional(),\n\titems: z.array(ContractRegistryItemSchema)\n});\n\n//#endregion\nexport { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema }~~;\n//# sourceMappingURL=schemas.js.map~~"],"mappings":";;;;AAoBA,MAAM,iCAAiC,EAAE,KAhBF;CACtC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAC4E;AAC7E,MAAM,6BAA6B,EAAE,OAAO;CAC3C,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,SAAS,EAAE,QAAQ,CAAC,UAAU;CAC9B,CAAC;AACF,MAAM,6BAA6B,EAAE,OAAO;CAC3C,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,MAAM;CACN,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;CACvC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE;CACxB,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE;CAC9B,MAAM,EAAE,OAAO;EACd,WAAW,EAAE,KAAK;GACjB,cAAc;GACd,cAAc;GACd,cAAc;GACd,cAAc;GACd,cAAc;GACd,cAAc;GACd,CAAC;EACF,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;EAC9C,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;EAC5C,CAAC;CACF,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU;CACnD,sBAAsB,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU;CAC3D,OAAO,EAAE,MAAM,2BAA2B,CAAC,IAAI,EAAE;CACjD,QAAQ,EAAE,OAAO;EAChB,OAAO,EAAE,SAAS,CAAC,UAAU;EAC7B,QAAQ,EAAE,SAAS,CAAC,UAAU;EAC9B,CAAC,CAAC,UAAU;CACb,CAAC;AACF,MAAM,iCAAiC,EAAE,OAAO;CAC/C,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU;CACrC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU;CACtC,OAAO,EAAE,MAAM,2BAA2B;CAC1C,CAAC"}
1	+ {"version":3,"file":"schemas.js","names":[],"sources":["../../../../../../../libs/contracts/dist/contract-registry/schemas.js"],"sourcesContent":["import { StabilityEnum } from \"../ownership.js\";\nimport z from \"zod\";\n\n//#region src/contract-registry/schemas.ts\nconst ContractRegistryItemTypeValues = [\n\t\"contractspec:operation\",\n\t\"contractspec:event\",\n\t\"contractspec:presentation\",\n\t\"contractspec:form\",\n\t\"contractspec:feature\",\n\t\"contractspec:workflow\",\n\t\"contractspec:template\",\n\t\"contractspec:integration\",\n\t\"contractspec:data-view\",\n\t\"contractspec:migration\",\n\t\"contractspec:telemetry\",\n\t\"contractspec:experiment\",\n\t\"contractspec:app-config\",\n\t\"contractspec:knowledge\"\n];\nconst ContractRegistryItemTypeSchema = z.enum(ContractRegistryItemTypeValues);\nconst ContractRegistryFileSchema = z.object({\n\tpath: z.string().min(1),\n\ttype: z.string().min(1),\n\tcontent: z.string().optional()\n});\nconst ContractRegistryItemSchema = z.object({\n\tname: z.string().min(1),\n\ttype: ContractRegistryItemTypeSchema,\n\tversion: z.number().int().nonnegative(),\n\ttitle: z.string().min(1),\n\tdescription: z.string().min(1),\n\tmeta: z.object({\n\t\tstability: z.enum([\n\t\t\tStabilityEnum.Idea,\n\t\t\tStabilityEnum.InCreation,\n\t\t\tStabilityEnum.Experimental,\n\t\t\tStabilityEnum.Beta,\n\t\t\tStabilityEnum.Stable,\n\t\t\tStabilityEnum.Deprecated\n\t\t]),\n\t\towners: z.array(z.string().min(1)).default([]),\n\t\ttags: z.array(z.string().min(1)).default([])\n\t}),\n\tdependencies: z.array(z.string().min(1)).optional(),\n\tregistryDependencies: z.array(z.string().min(1)).optional(),\n\tfiles: z.array(ContractRegistryFileSchema).min(1),\n\tschema: z.object({\n\t\tinput: z.unknown().optional(),\n\t\toutput: z.unknown().optional()\n\t}).optional()\n});\nconst ContractRegistryManifestSchema = z.object({\n\t$schema: z.string().min(1).optional(),\n\tname: z.string().min(1),\n\thomepage: z.string().min(1).optional(),\n\titems: z.array(ContractRegistryItemSchema)\n});\n\n//#endregion\nexport { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema };"],"mappings":";;;;AAoBA,MAAM,iCAAiC,EAAE,KAhBF;CACtC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAC4E;AAC7E,MAAM,6BAA6B,EAAE,OAAO;CAC3C,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,SAAS,EAAE,QAAQ,CAAC,UAAU;CAC9B,CAAC;AACF,MAAM,6BAA6B,EAAE,OAAO;CAC3C,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,MAAM;CACN,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;CACvC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE;CACxB,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE;CAC9B,MAAM,EAAE,OAAO;EACd,WAAW,EAAE,KAAK;GACjB,cAAc;GACd,cAAc;GACd,cAAc;GACd,cAAc;GACd,cAAc;GACd,cAAc;GACd,CAAC;EACF,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;EAC9C,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;EAC5C,CAAC;CACF,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU;CACnD,sBAAsB,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU;CAC3D,OAAO,EAAE,MAAM,2BAA2B,CAAC,IAAI,EAAE;CACjD,QAAQ,EAAE,OAAO;EAChB,OAAO,EAAE,SAAS,CAAC,UAAU;EAC7B,QAAQ,EAAE,SAAS,CAAC,UAAU;EAC9B,CAAC,CAAC,UAAU;CACb,CAAC;AACF,MAAM,iCAAiC,EAAE,OAAO;CAC/C,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU;CACrC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvB,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU;CACtC,OAAO,EAAE,MAAM,2BAA2B;CAC1C,CAAC"}

package/dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"accessibility_wcag_compliance_specs.docblock.js","names":[],"sources":["../../../../../../../libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"./registry.js\";\n\n//#region src/docs/accessibility_wcag_compliance_specs.docblock.ts\nconst accessibility_wcag_compliance_specs_DocBlocks = [{\n\tid: \"docs.accessibility_wcag_compliance_specs\",\n\ttitle: \"Accessibility & WCAG Compliance — specs.md\",\n\tsummary: \"> Goal: Ship interfaces that are usable by everyone, by default. This spec sets non‑negotiable rules, checklists, and CI gates to meet WCAG\\xA02.2 AA (aim for AAA where low‑cost), align with EN\\xA0301\\xA0549 (EU), and keep parity on web (Next.js) and mobile (Expo/React\\xA0Native).\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/accessibility_wcag_compliance_specs\",\n\ttags: [\"accessibility_wcag_compliance_specs\"],\n\tbody: \"# Accessibility & WCAG Compliance — specs.md\\n\\n> Goal: Ship interfaces that are usable by everyone, by default. This spec sets non‑negotiable rules, checklists, and CI gates to meet WCAG\\xA02.2 AA (aim for AAA where low‑cost), align with EN\\xA0301\\xA0549 (EU), and keep parity on web (Next.js) and mobile (Expo/React\\xA0Native).\\n\\n---\\n\\n## 0) Scope & Principles\\n\\n- Standards: WCAG\\xA02.2\\xA0AA (incl. new 2.2 SCs: Focus Not Obscured, Focus Appearance, Target Size, Dragging Movements, Accessible Authentication, Redundant Entry). EN\\xA0301\\xA0549 compliance by conformance to WCAG.\\n- Principles: Perceivable, Operable, Understandable, Robust (POUR).\\n- Rule of ARIA: “No ARIA is better than bad ARIA.” Prefer native elements.\\n- Definition of Done (DoD): No Critical/Major a11y issues in CI; keyboard complete; SR (screen reader) smoke test passed; contrasts pass; acceptance criteria below satisfied.\\n- Repo Alignment: Web apps use Radix Primitives + shadcn wrappers centralized in `packages/lssm/libs/ui-kit-web`. Prefer those components over per‑app duplicates (`packages//apps//src/components/ui`). When missing, add to `ui-kit-web` first, then adopt app‑side.\\n\\n---\\n\\n## 1) Design Requirements (Design System & Tokens)\\n\\n1.1 Color & Contrast\\n\\n- Body text, icons essential to meaning: ≥\\xA04.5:1; large text (≥\\xA018.66px regular / 14px bold): ≥\\xA03:1.\\n- Interactive states (default/hover/active/disabled/focus) must maintain contrast ≥\\xA03:1 against adjacent colors; text within components follows text ratios.\\n- Provide light & dark themes with tokens that guarantee minimums. Never rely solely on color to convey meaning; pair with text, shape, or icon.\\n\\n1.2 Focus Indicators (WCAG\\xA02.4.11/12)\\n\\n- Every interactive element has a visible focus with clear offset; indicator contrast ≥\\xA03:1 vs adjacent colors and indicator area ≥\\xA02\\xA0CSS\\xA0px thick.\\n- Focus must not be obscured by sticky headers/footers or scroll containers.\\n\\n1.3 Motion & Preferences\\n\\n- Respect `prefers-reduced-motion`: suppress large parallax, auto‑animations; provide instant alternatives.\\n- Avoid motion that could trigger vestibular issues; under PRM, use fade/scale under 150ms.\\n\\n1.4 Target Size (2.5.8)\\n\\n- Hit areas ≥\\xA024×24\\xA0CSS\\xA0px (web) and ≥\\xA044×44\\xA0dp (mobile) unless exempt.\\n\\n1.5 Typography & Layout\\n\\n- Support zoom to 400% without loss of content/functionality; responsive reflow at 320\\xA0CSS\\xA0px width.\\n- Maintain clear heading hierarchy (h1…h6), one h1 per view.\\n\\n- Repository baseline (Web): default body text uses Tailwind `text-lg` (≈18px). As of 2025‑09‑20, the repository bumped all Tailwind typography scale usages by +1 step (e.g., `text-sm`→`text-base`, `text-base`→`text-lg`, …, `text-8xl`→`text-9xl`). For long‑form content, default to `prose-lg`.\\n- Do not use `text-xs` for body copy. Reserve `text-sm` only for non‑essential meta (timestamps, fine print) while ensuring contrast and touch targets remain compliant.\\n- When increasing font size, ensure line height supports readability. Prefer Tailwind defaults or `leading-relaxed`/`leading-7` for body text where dense blocks appear.\\n\\n1.6 Iconography & Imagery\\n\\n- Decorative images: `alt=\\\"\\\"` or `aria-hidden=\\\"true\\\"`.\\n- Informative images: concise, specific alt; complex charts require a data table or long description.\\n\\n---\\n\\n## 2) Content Requirements (UX Writing)\\n\\n- Links say what happens (avoid “click here”).\\n- Buttons start with verbs; avoid ambiguous labels.\\n- Form labels are visible; placeholders are not labels.\\n- Error messages: human + programmatic association; avoid color‑only.\\n- Authentication: allow copy/paste, password managers, and avoid cognitive tests alone (3.3.7/3.3.8/3.3.9).\\n- Avoid CAPTCHAs that block users; if unavoidable, provide multiple alternatives (logic-free).\\n\\n---\\n\\n## 3) Engineering Requirements (Web — Next.js/React)\\n\\n> Use and extend `packages/lssm/libs/ui-kit-web` as the default UI surface. It wraps Radix primitives with sensible a11y defaults (focus rings, roles, keyboard, ARIA binding). When a gap exists, add it to `ui-kit-web` first.\\n\\n3.1 Semantics & Landmarks\\n\\n- Use native elements: `<button>`, `<a href>`, `<label for>`, `<fieldset>`, `<legend>`, `<table>`, etc.\\n- Landmarks per page: `header`, `nav`, `main`, `aside`, `footer`. Provide a Skip to main content link.\\n- Provide a Route Announcer (`aria-live=\\\"polite\\\"`) and move focus to page h1 after navigation.\\n\\n3.2 Keyboard\\n\\n- All functionality available with keyboard alone. Tab order follows DOM/visual order; no keyboard traps.\\n- Common bindings:\\n - Space/Enter → activate button; Enter on link;\\n - Esc closes dialogs/menus;\\n - Arrow keys for lists/menus/tablists with roving tabindex.\\n\\n3.3 Focus Management\\n\\n- On route change (Next.js), move focus to the page `<h1>` or container and announce via a live region.\\n- Dialogs/menus: trap focus inside; return focus to invoking control on close.\\n- Don’t steal focus except after explicit user action.\\n\\n3.4 Forms\\n\\n- Each input has a `<label>` or `aria-label`. Group related inputs with `<fieldset><legend>`.\\n- Associate errors via `aria-describedby` or inline IDs; announce with `role=\\\"alert\\\"` (assertive only for critical).\\n- Provide autocomplete tokens for known fields; show inline validation and do not block on onBlur alone.\\n\\n3.5 ARIA Usage\\n\\n- Only when needed; match patterns (dialog, menu, combobox, tablist, listbox) per ARIA Authoring Practices.\\n- Ensure name/role/value are programmatically determinable.\\n\\n3.6 Media\\n\\n- Videos: captions; provide transcripts for audio; audio descriptions for essential visual info.\\n- No auto‑playing audio. Auto‑playing video must be muted and pausable; provide controls.\\n\\n3.7 Tables & Data\\n\\n- Use `<th scope>` for headers; captions via `<caption>`; announce sorting via `aria-sort`.\\n- Provide CSV/JSON export where charts are primary.\\n\\n3.8 Performance & Robustness\\n\\n- Avoid content shifts that move focus; reserve space or use skeletons.\\n- Maintain accessible names through hydration/SSR; avoid `dangerouslySetInnerHTML` where possible.\\n\\n3.9 Next.js specifics\\n\\n- Use `next/link` for navigation; ensure links are links, not buttons.\\n- `next/image` must include alt (empty if decorative).\\n- Announce route changes with a global live region and shift focus to the new view.\\n\\n3.10 Accessibility library integration\\n\\n- Import `@lssm/lib.accessibility` at app root. It auto-imports its `styles.css` via the package entry; ensure bundlers keep CSS side effects. If your app tree-shakes CSS, explicitly import the stylesheet once in your root layout:\\n\\n```tsx\\n// app/layout.tsx\\nimport '@lssm/lib.accessibility'; // includes tokens and provider exports\\n// or if needed: import '@lssm/lib.accessibility/src/styles.css';\\n```\\n\\n- Wrap the app with `AccessibilityProvider` and include an element with `id=\\\"main\\\"` for the skip link target.\\n\\n---\\n\\n## 3b) lssm/ui-kit-web — Component Patterns & Defaults\\n\\n> Source: `packages/lssm/libs/ui-kit-web/ui/`\\n\\n- Button/Input/Textarea: Built‑in `focus-visible` rings; ensure visible labels via `FormLabel` or `aria-label`.\\n- Form* (`form.tsx`): `FormControl` wires `aria-invalid` and `aria-describedby` to `FormMessage` and `FormDescription`. Prefer `FormMessage` for inline errors. Add `role=\\\"alert\\\"` only for critical.\\n- Dialog/Sheet/Dropdown: Use Radix wrappers for focus‑trap and return‑focus. Provide `DialogTitle` + `DialogDescription` for name/description.\\n- Select/Combobox: Prefer `SelectTrigger` with visible label; for icon‑only triggers, supply `aria-label`. Document examples in each app.\\n- Tabs: Use `TabsList`, `TabsTrigger`, `TabsContent`; names are programmatically determinable.\\n- Toast/Toaster: Prefer non‑blocking announcements; map critical to assertive region; include action buttons with clear labels.\\n- Table: Use `TableCaption`; ensure `TableHead` cells use proper `scope`. Provide `aria-sort` on sortable headers.\\n- Utilities to add (repo action):\\n - `SkipLink` component and pattern in layouts.\\n - `RouteAnnouncer` (`aria-live=\\\"polite\\\"`) and FocusOnRouteChange helper.\\n - `VisuallyHidden` wrapper (Radix visually-hidden or minimal utility).\\n - `useReducedMotion` helper; honor in animated components.\\n - Touch‑size variants (≥44×44) for interactive atoms.\\n\\n---\\n\\n## 4) Engineering Requirements (Mobile — Expo/React\\xA0Native)\\n\\n- Set `accessibilityLabel`, `accessibilityHint`, and `accessibilityRole` on touchables.\\n- Ensure hit slop / min size ≥\\xA044×44\\xA0dp.\\n- Support Dynamic Type / font scaling; no clipped text at 200%.\\n- Respect Invert Colors and Reduce Motion; avoid flashing.\\n- Group related items with `accessibilityElements` ordering; hide decoration with `accessible={false}` or `importantForAccessibility=\\\"no-hide-descendants\\\"` when appropriate.\\n- Test with VoiceOver (iOS) and TalkBack (Android).\\n\\n---\\n\\n## 5) Component Patterns (Acceptance Rules)\\n\\nButtons & Links\\n\\n- Use `<button>` for actions, `<a href>` for navigation. Provide disabled states that are perceivable beyond color.\\n\\nNavigation\\n\\n- Provide Skip link. One primary nav landmark. Indicate current page (`aria-current=\\\"page\\\"`).\\n\\nMenus/Combobox/Autocomplete\\n\\n- Follow ARIA patterns: focus moves into list; `aria-expanded`, `aria-controls`, `aria-activedescendant` when applicable; Esc closes; typing filters.\\n\\nModals/Dialogs\\n\\n- `role=\\\"dialog\\\"` or `alertdialog` with label; focus trapped; background inert; Esc closes; return focus to trigger.\\n\\nTabs\\n\\n- `role=\\\"tablist\\\"`; tabs are in the tab order; arrow keys switch focus; content is `role=\\\"tabpanel\\\"` with `aria-labelledby`.\\n\\nToasts/Notifications\\n\\n- Non-critical: `aria-live=\\\"polite\\\"`; critical: `role=\\\"alert\\\"` sparingly.\\n\\nInfinite Scroll / “Load More”\\n\\n- Provide Load more control; announce new content to SR; preserve keyboard position.\\n\\nDrag & Drop (2.5.7)\\n\\n- Provide non‑drag alternative (e.g., move up/down buttons).\\n\\nCharts & Maps\\n\\n- Provide table alternative or textual summary; keyboard access to datapoints where interactive.\\n\\n---\\n\\n## 6) Testing & CI (Blocking Gates)\\n\\nStatic & Unit\\n\\n- `eslint-plugin-jsx-a11y` — error on violations.\\n- `jest-axe` — unit tests for components.\\n\\nAutomated Integration\\n\\n- `axe-core` via Playwright or Cypress on critical flows.\\n- `pa11y-ci` on key routes; threshold: 0 Critical / 0 Serious to merge.\\n- Lighthouse CI a11y score ≥\\xA095 on target pages.\\n\\nManual QA (per release)\\n\\n- Keyboard patrol: navigate primary flows without mouse.\\n- Screen reader smoke: NVDA (Windows) or VoiceOver (macOS/iOS) across login, navigation, forms, dialogs.\\n- Zoom & Reflow: 200–400% & 320\\xA0px width.\\n- Color/Contrast check: tokens in both themes.\\n\\nReporting\\n\\n- A11y issues labeled: `a11y-blocker`, `a11y-bug`, `a11y-enhancement` with WCAG ref.\\n\\n---\\n\\n## 7) Repository‑Specific Adoption Plan\\n\\n- Centralize UI usage on `packages/lssm/libs/ui-kit-web` and de‑duplicate per‑app `components/ui` where feasible.\\n- Introduce `SkipLink`, `RouteAnnouncer`, `FocusOnRouteChange`, and `VisuallyHidden` in `ui-kit-web`. Adopt in app layouts (`app/layout.tsx`) first.\\n- Add `useReducedMotion` and wire into animated components (e.g., `drawer`, `tooltip`, `carousel`).\\n- Add touch‑size variants to `Button`, `IconButton`, `TabsTrigger`, toggles.\\n- Document Select label patterns and error association in Forms.\\n\\n---\\n\\n## 8) Code Snippets\\n\\nSkip Link\\n\\n```html\\n<a\\n class=\\\"sr-only focus:not-sr-only focus-visible:outline focus-visible:ring-4 focus-visible:ring-offset-2\\\"\\n href=\\\"#main\\\"\\n >Skip to main content</a\\n>\\n<main id=\\\"main\\\">…</main>\\n```\\n\\nDialog (Radix + shadcn/ui) — essentials\\n\\n```tsx\\n// Ensure label, description, focus trap, and return focus on close remain intact\\n<Dialog>\\n <DialogTrigger asChild>\\n <button aria-haspopup=\\\"dialog\\\">Open settings</button>\\n </DialogTrigger>\\n <DialogContent aria-describedby=\\\"settings-desc\\\">\\n <DialogTitle>Settings</DialogTitle>\\n <p id=\\\"settings-desc\\\">Update your preferences.</p>\\n <DialogClose asChild>\\n <button>Close</button>\\n </DialogClose>\\n </DialogContent>\\n</Dialog>\\n```\\n\\nForm error association\\n\\n```tsx\\n<label htmlFor=\\\"email\\\">Email</label>\\n<input id=\\\"email\\\" name=\\\"email\\\" type=\\\"email\\\" aria-describedby=\\\"email-err\\\" />\\n<p id=\\\"email-err\\\" role=\\\"alert\\\">Enter a valid email.</p>\\n```\\n\\nRoute change announcement (Next.js)\\n\\n```tsx\\n// Add once at app root\\n<div\\n aria-live=\\\"polite\\\"\\n aria-atomic=\\\"true\\\"\\n id=\\\"route-announcer\\\"\\n className=\\\"sr-only\\\"\\n/>\\n```\\n\\n---\\n\\n## 9) Exceptions & Waivers\\n\\n- If a criterion cannot be met, file an issue with: context, attempted alternatives, WCAG reference, impact assessment, and a remediation date. Temporary waivers only.\\n\\n---\\n\\n## 10) Ownership\\n\\n- Design: maintains token contrast, component specs.\\n- Engineering: enforces CI gates, implements patterns.\\n- QA: runs manual checks per release.\\n- PM: blocks release if AA not met on user‑visible flows.\\n\\n---\\n\\n## 11) References (internalize; no external dependency at runtime)\\n\\n- WCAG\\xA02.2 (AA), EN\\xA0301\\xA0549. ARIA Authoring Practices. Platform HIG (Apple, Material).\\n- `packages/lssm/libs/ui-kit-web` as the canonical UI source for web.\\n\\n> Bottom line: Shipping means accessible by default. We don’t trade a11y for speed; we bake it into speed.\\n\\n---\\n\\n## 12) Adoption Status (2025-09-23)\\n\\n- web-artisan: AccessibilityProvider integrated; sr-only/forced-colors applied; 44x44 targets; forms announce errors; jest-axe and cypress-axe in place.\\n- web-strit: AccessibilityProvider integrated; forced-colors, sr-only; forms announce errors; 44x44 targets; contrast tokens and text-scale wired; jest-axe and cypress-axe in place.\\n- web-coliving: AccessibilityProvider integrated; forced-colors and focus visibility added; text-scale wired; landing pages converted to `Section`/stacks with text-lg defaults; CTA capture standardized; ESLint guard for text-xs in main content; jest-axe and cypress-axe in place. Next: audit icon-only controls and ensure 44x44 targets; add role=\\\"alert\\\" where critical.\\n\\n> CI gates: run eslint a11y, jest-axe on components, and cypress-axe on critical flows per app.\\n\\n---\\n\\n## 13) CI Hardening & Visual QA\\n\\n- Linting: Run eslint with jsx-a11y rules across all web apps; block on violations.\\n- Unit: Run jest-axe for ui-kit-web and app-level components.\\n- Integration: cypress-axe on key flows (auth, forms, dialogs, tables).\\n- Synthetic scans: pa11y-ci on critical pages (0 Critical/Serious policy).\\n- Performance/A11y audit: Lighthouse CI with a11y score >= 95 on target routes.\\n- Artifacts: Upload pa11y and Lighthouse reports per PR; annotate failures.\\n\\n### Recent additions (2025-09-26)\\n\\n- AutocompleteInput (groceries): Upgraded to ARIA combobox pattern with `aria-controls`, `aria-activedescendant`, `Escape`/`Tab` handling, and labelled listbox.\\n- Cypress a11y tests added for furniture and incidents modules on `/modules` and operators flows; checks run axe with critical/serious impacts.\\n\\n## 14) Accessibility Telemetry (PostHog)\\n\\n- Events (anonymized): a11y_pref_changed (text_scale, contrast_mode, reduce_motion), a11y_panel_opened.\\n- Properties: app, route, previous_value, new_value, timestamp.\\n- Dashboards: Adoption over time, per app/route; correlation with reduced bounce on forms.\\n- Privacy: No PII; aggregate only.\\n\"\n}];\nregisterDocBlocks(accessibility_wcag_compliance_specs_DocBlocks);\n\n//#endregion\nexport { accessibility_wcag_compliance_specs_DocBlocks };\n//# sourceMappingURL=accessibility_wcag_compliance_specs.docblock.js.map"],"mappings":";;;AAGA,MAAM,gDAAgD,CAAC;CACtD,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,sCAAsC;CAC7C,MAAM;CACN,CAAC;AACF,kBAAkB,8CAA8C"}
1	+ {"version":3,"file":"accessibility_wcag_compliance_specs.docblock.js","names":[],"sources":["../../../../../../../libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"./registry.js\";\n\n//#region src/docs/accessibility_wcag_compliance_specs.docblock.ts\nconst accessibility_wcag_compliance_specs_DocBlocks = [{\n\tid: \"docs.accessibility_wcag_compliance_specs\",\n\ttitle: \"Accessibility & WCAG Compliance — specs.md\",\n\tsummary: \"> Goal: Ship interfaces that are usable by everyone, by default. This spec sets non‑negotiable rules, checklists, and CI gates to meet WCAG\\xA02.2 AA (aim for AAA where low‑cost), align with EN\\xA0301\\xA0549 (EU), and keep parity on web (Next.js) and mobile (Expo/React\\xA0Native).\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/accessibility_wcag_compliance_specs\",\n\ttags: [\"accessibility_wcag_compliance_specs\"],\n\tbody: \"# Accessibility & WCAG Compliance — specs.md\\n\\n> Goal: Ship interfaces that are usable by everyone, by default. This spec sets non‑negotiable rules, checklists, and CI gates to meet WCAG\\xA02.2 AA (aim for AAA where low‑cost), align with EN\\xA0301\\xA0549 (EU), and keep parity on web (Next.js) and mobile (Expo/React\\xA0Native).\\n\\n---\\n\\n## 0) Scope & Principles\\n\\n- Standards: WCAG\\xA02.2\\xA0AA (incl. new 2.2 SCs: Focus Not Obscured, Focus Appearance, Target Size, Dragging Movements, Accessible Authentication, Redundant Entry). EN\\xA0301\\xA0549 compliance by conformance to WCAG.\\n- Principles: Perceivable, Operable, Understandable, Robust (POUR).\\n- Rule of ARIA: “No ARIA is better than bad ARIA.” Prefer native elements.\\n- Definition of Done (DoD): No Critical/Major a11y issues in CI; keyboard complete; SR (screen reader) smoke test passed; contrasts pass; acceptance criteria below satisfied.\\n- Repo Alignment: Web apps use Radix Primitives + shadcn wrappers centralized in `packages/lssm/libs/ui-kit-web`. Prefer those components over per‑app duplicates (`packages//apps//src/components/ui`). When missing, add to `ui-kit-web` first, then adopt app‑side.\\n\\n---\\n\\n## 1) Design Requirements (Design System & Tokens)\\n\\n1.1 Color & Contrast\\n\\n- Body text, icons essential to meaning: ≥\\xA04.5:1; large text (≥\\xA018.66px regular / 14px bold): ≥\\xA03:1.\\n- Interactive states (default/hover/active/disabled/focus) must maintain contrast ≥\\xA03:1 against adjacent colors; text within components follows text ratios.\\n- Provide light & dark themes with tokens that guarantee minimums. Never rely solely on color to convey meaning; pair with text, shape, or icon.\\n\\n1.2 Focus Indicators (WCAG\\xA02.4.11/12)\\n\\n- Every interactive element has a visible focus with clear offset; indicator contrast ≥\\xA03:1 vs adjacent colors and indicator area ≥\\xA02\\xA0CSS\\xA0px thick.\\n- Focus must not be obscured by sticky headers/footers or scroll containers.\\n\\n1.3 Motion & Preferences\\n\\n- Respect `prefers-reduced-motion`: suppress large parallax, auto‑animations; provide instant alternatives.\\n- Avoid motion that could trigger vestibular issues; under PRM, use fade/scale under 150ms.\\n\\n1.4 Target Size (2.5.8)\\n\\n- Hit areas ≥\\xA024×24\\xA0CSS\\xA0px (web) and ≥\\xA044×44\\xA0dp (mobile) unless exempt.\\n\\n1.5 Typography & Layout\\n\\n- Support zoom to 400% without loss of content/functionality; responsive reflow at 320\\xA0CSS\\xA0px width.\\n- Maintain clear heading hierarchy (h1…h6), one h1 per view.\\n\\n- Repository baseline (Web): default body text uses Tailwind `text-lg` (≈18px). As of 2025‑09‑20, the repository bumped all Tailwind typography scale usages by +1 step (e.g., `text-sm`→`text-base`, `text-base`→`text-lg`, …, `text-8xl`→`text-9xl`). For long‑form content, default to `prose-lg`.\\n- Do not use `text-xs` for body copy. Reserve `text-sm` only for non‑essential meta (timestamps, fine print) while ensuring contrast and touch targets remain compliant.\\n- When increasing font size, ensure line height supports readability. Prefer Tailwind defaults or `leading-relaxed`/`leading-7` for body text where dense blocks appear.\\n\\n1.6 Iconography & Imagery\\n\\n- Decorative images: `alt=\\\"\\\"` or `aria-hidden=\\\"true\\\"`.\\n- Informative images: concise, specific alt; complex charts require a data table or long description.\\n\\n---\\n\\n## 2) Content Requirements (UX Writing)\\n\\n- Links say what happens (avoid “click here”).\\n- Buttons start with verbs; avoid ambiguous labels.\\n- Form labels are visible; placeholders are not labels.\\n- Error messages: human + programmatic association; avoid color‑only.\\n- Authentication: allow copy/paste, password managers, and avoid cognitive tests alone (3.3.7/3.3.8/3.3.9).\\n- Avoid CAPTCHAs that block users; if unavoidable, provide multiple alternatives (logic-free).\\n\\n---\\n\\n## 3) Engineering Requirements (Web — Next.js/React)\\n\\n> Use and extend `packages/lssm/libs/ui-kit-web` as the default UI surface. It wraps Radix primitives with sensible a11y defaults (focus rings, roles, keyboard, ARIA binding). When a gap exists, add it to `ui-kit-web` first.\\n\\n3.1 Semantics & Landmarks\\n\\n- Use native elements: `<button>`, `<a href>`, `<label for>`, `<fieldset>`, `<legend>`, `<table>`, etc.\\n- Landmarks per page: `header`, `nav`, `main`, `aside`, `footer`. Provide a Skip to main content link.\\n- Provide a Route Announcer (`aria-live=\\\"polite\\\"`) and move focus to page h1 after navigation.\\n\\n3.2 Keyboard\\n\\n- All functionality available with keyboard alone. Tab order follows DOM/visual order; no keyboard traps.\\n- Common bindings:\\n - Space/Enter → activate button; Enter on link;\\n - Esc closes dialogs/menus;\\n - Arrow keys for lists/menus/tablists with roving tabindex.\\n\\n3.3 Focus Management\\n\\n- On route change (Next.js), move focus to the page `<h1>` or container and announce via a live region.\\n- Dialogs/menus: trap focus inside; return focus to invoking control on close.\\n- Don’t steal focus except after explicit user action.\\n\\n3.4 Forms\\n\\n- Each input has a `<label>` or `aria-label`. Group related inputs with `<fieldset><legend>`.\\n- Associate errors via `aria-describedby` or inline IDs; announce with `role=\\\"alert\\\"` (assertive only for critical).\\n- Provide autocomplete tokens for known fields; show inline validation and do not block on onBlur alone.\\n\\n3.5 ARIA Usage\\n\\n- Only when needed; match patterns (dialog, menu, combobox, tablist, listbox) per ARIA Authoring Practices.\\n- Ensure name/role/value are programmatically determinable.\\n\\n3.6 Media\\n\\n- Videos: captions; provide transcripts for audio; audio descriptions for essential visual info.\\n- No auto‑playing audio. Auto‑playing video must be muted and pausable; provide controls.\\n\\n3.7 Tables & Data\\n\\n- Use `<th scope>` for headers; captions via `<caption>`; announce sorting via `aria-sort`.\\n- Provide CSV/JSON export where charts are primary.\\n\\n3.8 Performance & Robustness\\n\\n- Avoid content shifts that move focus; reserve space or use skeletons.\\n- Maintain accessible names through hydration/SSR; avoid `dangerouslySetInnerHTML` where possible.\\n\\n3.9 Next.js specifics\\n\\n- Use `next/link` for navigation; ensure links are links, not buttons.\\n- `next/image` must include alt (empty if decorative).\\n- Announce route changes with a global live region and shift focus to the new view.\\n\\n3.10 Accessibility library integration\\n\\n- Import `@lssm/lib.accessibility` at app root. It auto-imports its `styles.css` via the package entry; ensure bundlers keep CSS side effects. If your app tree-shakes CSS, explicitly import the stylesheet once in your root layout:\\n\\n```tsx\\n// app/layout.tsx\\nimport '@lssm/lib.accessibility'; // includes tokens and provider exports\\n// or if needed: import '@lssm/lib.accessibility/src/styles.css';\\n```\\n\\n- Wrap the app with `AccessibilityProvider` and include an element with `id=\\\"main\\\"` for the skip link target.\\n\\n---\\n\\n## 3b) lssm/ui-kit-web — Component Patterns & Defaults\\n\\n> Source: `packages/lssm/libs/ui-kit-web/ui/`\\n\\n- Button/Input/Textarea: Built‑in `focus-visible` rings; ensure visible labels via `FormLabel` or `aria-label`.\\n- Form* (`form.tsx`): `FormControl` wires `aria-invalid` and `aria-describedby` to `FormMessage` and `FormDescription`. Prefer `FormMessage` for inline errors. Add `role=\\\"alert\\\"` only for critical.\\n- Dialog/Sheet/Dropdown: Use Radix wrappers for focus‑trap and return‑focus. Provide `DialogTitle` + `DialogDescription` for name/description.\\n- Select/Combobox: Prefer `SelectTrigger` with visible label; for icon‑only triggers, supply `aria-label`. Document examples in each app.\\n- Tabs: Use `TabsList`, `TabsTrigger`, `TabsContent`; names are programmatically determinable.\\n- Toast/Toaster: Prefer non‑blocking announcements; map critical to assertive region; include action buttons with clear labels.\\n- Table: Use `TableCaption`; ensure `TableHead` cells use proper `scope`. Provide `aria-sort` on sortable headers.\\n- Utilities to add (repo action):\\n - `SkipLink` component and pattern in layouts.\\n - `RouteAnnouncer` (`aria-live=\\\"polite\\\"`) and FocusOnRouteChange helper.\\n - `VisuallyHidden` wrapper (Radix visually-hidden or minimal utility).\\n - `useReducedMotion` helper; honor in animated components.\\n - Touch‑size variants (≥44×44) for interactive atoms.\\n\\n---\\n\\n## 4) Engineering Requirements (Mobile — Expo/React\\xA0Native)\\n\\n- Set `accessibilityLabel`, `accessibilityHint`, and `accessibilityRole` on touchables.\\n- Ensure hit slop / min size ≥\\xA044×44\\xA0dp.\\n- Support Dynamic Type / font scaling; no clipped text at 200%.\\n- Respect Invert Colors and Reduce Motion; avoid flashing.\\n- Group related items with `accessibilityElements` ordering; hide decoration with `accessible={false}` or `importantForAccessibility=\\\"no-hide-descendants\\\"` when appropriate.\\n- Test with VoiceOver (iOS) and TalkBack (Android).\\n\\n---\\n\\n## 5) Component Patterns (Acceptance Rules)\\n\\nButtons & Links\\n\\n- Use `<button>` for actions, `<a href>` for navigation. Provide disabled states that are perceivable beyond color.\\n\\nNavigation\\n\\n- Provide Skip link. One primary nav landmark. Indicate current page (`aria-current=\\\"page\\\"`).\\n\\nMenus/Combobox/Autocomplete\\n\\n- Follow ARIA patterns: focus moves into list; `aria-expanded`, `aria-controls`, `aria-activedescendant` when applicable; Esc closes; typing filters.\\n\\nModals/Dialogs\\n\\n- `role=\\\"dialog\\\"` or `alertdialog` with label; focus trapped; background inert; Esc closes; return focus to trigger.\\n\\nTabs\\n\\n- `role=\\\"tablist\\\"`; tabs are in the tab order; arrow keys switch focus; content is `role=\\\"tabpanel\\\"` with `aria-labelledby`.\\n\\nToasts/Notifications\\n\\n- Non-critical: `aria-live=\\\"polite\\\"`; critical: `role=\\\"alert\\\"` sparingly.\\n\\nInfinite Scroll / “Load More”\\n\\n- Provide Load more control; announce new content to SR; preserve keyboard position.\\n\\nDrag & Drop (2.5.7)\\n\\n- Provide non‑drag alternative (e.g., move up/down buttons).\\n\\nCharts & Maps\\n\\n- Provide table alternative or textual summary; keyboard access to datapoints where interactive.\\n\\n---\\n\\n## 6) Testing & CI (Blocking Gates)\\n\\nStatic & Unit\\n\\n- `eslint-plugin-jsx-a11y` — error on violations.\\n- `jest-axe` — unit tests for components.\\n\\nAutomated Integration\\n\\n- `axe-core` via Playwright or Cypress on critical flows.\\n- `pa11y-ci` on key routes; threshold: 0 Critical / 0 Serious to merge.\\n- Lighthouse CI a11y score ≥\\xA095 on target pages.\\n\\nManual QA (per release)\\n\\n- Keyboard patrol: navigate primary flows without mouse.\\n- Screen reader smoke: NVDA (Windows) or VoiceOver (macOS/iOS) across login, navigation, forms, dialogs.\\n- Zoom & Reflow: 200–400% & 320\\xA0px width.\\n- Color/Contrast check: tokens in both themes.\\n\\nReporting\\n\\n- A11y issues labeled: `a11y-blocker`, `a11y-bug`, `a11y-enhancement` with WCAG ref.\\n\\n---\\n\\n## 7) Repository‑Specific Adoption Plan\\n\\n- Centralize UI usage on `packages/lssm/libs/ui-kit-web` and de‑duplicate per‑app `components/ui` where feasible.\\n- Introduce `SkipLink`, `RouteAnnouncer`, `FocusOnRouteChange`, and `VisuallyHidden` in `ui-kit-web`. Adopt in app layouts (`app/layout.tsx`) first.\\n- Add `useReducedMotion` and wire into animated components (e.g., `drawer`, `tooltip`, `carousel`).\\n- Add touch‑size variants to `Button`, `IconButton`, `TabsTrigger`, toggles.\\n- Document Select label patterns and error association in Forms.\\n\\n---\\n\\n## 8) Code Snippets\\n\\nSkip Link\\n\\n```html\\n<a\\n class=\\\"sr-only focus:not-sr-only focus-visible:outline focus-visible:ring-4 focus-visible:ring-offset-2\\\"\\n href=\\\"#main\\\"\\n >Skip to main content</a\\n>\\n<main id=\\\"main\\\">…</main>\\n```\\n\\nDialog (Radix + shadcn/ui) — essentials\\n\\n```tsx\\n// Ensure label, description, focus trap, and return focus on close remain intact\\n<Dialog>\\n <DialogTrigger asChild>\\n <button aria-haspopup=\\\"dialog\\\">Open settings</button>\\n </DialogTrigger>\\n <DialogContent aria-describedby=\\\"settings-desc\\\">\\n <DialogTitle>Settings</DialogTitle>\\n <p id=\\\"settings-desc\\\">Update your preferences.</p>\\n <DialogClose asChild>\\n <button>Close</button>\\n </DialogClose>\\n </DialogContent>\\n</Dialog>\\n```\\n\\nForm error association\\n\\n```tsx\\n<label htmlFor=\\\"email\\\">Email</label>\\n<input id=\\\"email\\\" name=\\\"email\\\" type=\\\"email\\\" aria-describedby=\\\"email-err\\\" />\\n<p id=\\\"email-err\\\" role=\\\"alert\\\">Enter a valid email.</p>\\n```\\n\\nRoute change announcement (Next.js)\\n\\n```tsx\\n// Add once at app root\\n<div\\n aria-live=\\\"polite\\\"\\n aria-atomic=\\\"true\\\"\\n id=\\\"route-announcer\\\"\\n className=\\\"sr-only\\\"\\n/>\\n```\\n\\n---\\n\\n## 9) Exceptions & Waivers\\n\\n- If a criterion cannot be met, file an issue with: context, attempted alternatives, WCAG reference, impact assessment, and a remediation date. Temporary waivers only.\\n\\n---\\n\\n## 10) Ownership\\n\\n- Design: maintains token contrast, component specs.\\n- Engineering: enforces CI gates, implements patterns.\\n- QA: runs manual checks per release.\\n- PM: blocks release if AA not met on user‑visible flows.\\n\\n---\\n\\n## 11) References (internalize; no external dependency at runtime)\\n\\n- WCAG\\xA02.2 (AA), EN\\xA0301\\xA0549. ARIA Authoring Practices. Platform HIG (Apple, Material).\\n- `packages/lssm/libs/ui-kit-web` as the canonical UI source for web.\\n\\n> Bottom line: Shipping means accessible by default. We don’t trade a11y for speed; we bake it into speed.\\n\\n---\\n\\n## 12) Adoption Status (2025-09-23)\\n\\n- web-artisan: AccessibilityProvider integrated; sr-only/forced-colors applied; 44x44 targets; forms announce errors; jest-axe and cypress-axe in place.\\n- web-strit: AccessibilityProvider integrated; forced-colors, sr-only; forms announce errors; 44x44 targets; contrast tokens and text-scale wired; jest-axe and cypress-axe in place.\\n- web-coliving: AccessibilityProvider integrated; forced-colors and focus visibility added; text-scale wired; landing pages converted to `Section`/stacks with text-lg defaults; CTA capture standardized; ESLint guard for text-xs in main content; jest-axe and cypress-axe in place. Next: audit icon-only controls and ensure 44x44 targets; add role=\\\"alert\\\" where critical.\\n\\n> CI gates: run eslint a11y, jest-axe on components, and cypress-axe on critical flows per app.\\n\\n---\\n\\n## 13) CI Hardening & Visual QA\\n\\n- Linting: Run eslint with jsx-a11y rules across all web apps; block on violations.\\n- Unit: Run jest-axe for ui-kit-web and app-level components.\\n- Integration: cypress-axe on key flows (auth, forms, dialogs, tables).\\n- Synthetic scans: pa11y-ci on critical pages (0 Critical/Serious policy).\\n- Performance/A11y audit: Lighthouse CI with a11y score >= 95 on target routes.\\n- Artifacts: Upload pa11y and Lighthouse reports per PR; annotate failures.\\n\\n### Recent additions (2025-09-26)\\n\\n- AutocompleteInput (groceries): Upgraded to ARIA combobox pattern with `aria-controls`, `aria-activedescendant`, `Escape`/`Tab` handling, and labelled listbox.\\n- Cypress a11y tests added for furniture and incidents modules on `/modules` and operators flows; checks run axe with critical/serious impacts.\\n\\n## 14) Accessibility Telemetry (PostHog)\\n\\n- Events (anonymized): a11y_pref_changed (text_scale, contrast_mode, reduce_motion), a11y_panel_opened.\\n- Properties: app, route, previous_value, new_value, timestamp.\\n- Dashboards: Adoption over time, per app/route; correlation with reduced bounce on forms.\\n- Privacy: No PII; aggregate only.\\n\"\n}];\nregisterDocBlocks(accessibility_wcag_compliance_specs_DocBlocks);\n\n//#endregion\nexport { accessibility_wcag_compliance_specs_DocBlocks };"],"mappings":";;;AAGA,MAAM,gDAAgD,CAAC;CACtD,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,sCAAsC;CAC7C,MAAM;CACN,CAAC;AACF,kBAAkB,8CAA8C"}

package/dist/libs/contracts/dist/docs/meta.docs.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"meta.docs.js","names":[],"sources":["../../../../../../../libs/contracts/dist/docs/meta.docs.js"],"sourcesContent":["import { registerDocBlocks } from \"./registry.js\";\n\n//#region src/docs/meta.docs.ts\nconst metaDocs = [{\n\tid: \"docs.meta.docblocks-process\",\n\ttitle: \"DocBlocks process\",\n\tsummary: \"How to author goal/how/usage DocBlocks close to code.\",\n\tkind: \"reference\",\n\tvisibility: \"mixed\",\n\troute: \"/docs/meta/docblocks-process\",\n\ttags: [\"docs\", \"process\"],\n\tbody: `## DocBlocks authoring rules\n\n- Colocate docs beside implementation; avoid barrel /docs folders.\n- Split intent:\n - goal: why this exists (before implementation).\n - how: operational/runbook steps.\n - usage: quick checklist for consumers.\n- Use \\`visibility\\`: public \| internal \| mixed.\n- Prefer routes like \\`/docs/<domain>/<topic>/<kind>\\`; ids mirror that.\n- Keep body Markdown LLM-friendly; avoid HTML.\n- Add owners/tags/domain/stability when known.\n- For presentations/markdown outputs, rely on TransformEngine via DocRegistry.\n- No sourcePath; DocBlocks are canonical.`\n}];\nregisterDocBlocks(metaDocs);\n\n//#endregion\nexport { metaDocs }~~;\n//# sourceMappingURL=meta.docs.js.map~~"],"mappings":";;;AAGA,MAAM,WAAW,CAAC;CACjB,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,QAAQ,UAAU;CACzB,MAAM;;;;;;;;;;;;;CAaN,CAAC;AACF,kBAAkB,SAAS"}
1	+ {"version":3,"file":"meta.docs.js","names":[],"sources":["../../../../../../../libs/contracts/dist/docs/meta.docs.js"],"sourcesContent":["import { registerDocBlocks } from \"./registry.js\";\n\n//#region src/docs/meta.docs.ts\nconst metaDocs = [{\n\tid: \"docs.meta.docblocks-process\",\n\ttitle: \"DocBlocks process\",\n\tsummary: \"How to author goal/how/usage DocBlocks close to code.\",\n\tkind: \"reference\",\n\tvisibility: \"mixed\",\n\troute: \"/docs/meta/docblocks-process\",\n\ttags: [\"docs\", \"process\"],\n\tbody: `## DocBlocks authoring rules\n\n- Colocate docs beside implementation; avoid barrel /docs folders.\n- Split intent:\n - goal: why this exists (before implementation).\n - how: operational/runbook steps.\n - usage: quick checklist for consumers.\n- Use \\`visibility\\`: public \| internal \| mixed.\n- Prefer routes like \\`/docs/<domain>/<topic>/<kind>\\`; ids mirror that.\n- Keep body Markdown LLM-friendly; avoid HTML.\n- Add owners/tags/domain/stability when known.\n- For presentations/markdown outputs, rely on TransformEngine via DocRegistry.\n- No sourcePath; DocBlocks are canonical.`\n}];\nregisterDocBlocks(metaDocs);\n\n//#endregion\nexport { metaDocs };"],"mappings":";;;AAGA,MAAM,WAAW,CAAC;CACjB,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,QAAQ,UAAU;CACzB,MAAM;;;;;;;;;;;;;CAaN,CAAC;AACF,kBAAkB,SAAS"}

package/dist/libs/contracts/dist/docs/presentations.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"presentations.js","names":[],"sources":["../../../../../../../libs/contracts/dist/docs/presentations.js"],"sourcesContent":["//#region src/docs/presentations.ts\nconst DEFAULT_TARGETS = [\n\t\"markdown\",\n\t\"application/json\",\n\t\"application/xml\",\n\t\"react\"\n];\nfunction normalizeRoute(route) {\n\tif (!route.length) return \"/\";\n\tconst withLeading = route.startsWith(\"/\") ? route : `/${route}`;\n\treturn withLeading === \"/\" ? \"/\" : withLeading.replace(/\\/+$/, \"\");\n}\nfunction deriveRoute(block, routePrefix) {\n\tif (block.route) return normalizeRoute(block.route);\n\tconst prefix = routePrefix ?? \"/docs\";\n\tconst slug = block.id.replace(/^docs\\.?/, \"\").replace(/\\./g, \"/\").replace(/\\/+/g, \"/\");\n\treturn normalizeRoute(slug.startsWith(\"/\") ? slug : `${prefix}/${slug}`);\n}\nfunction buildName(block, namespace) {\n\treturn namespace ? `${namespace}.${block.id}` : block.id;\n}\nfunction docBlockToPresentationV2(block, options) {\n\tconst targets = options?.defaultTargets ?? DEFAULT_TARGETS;\n\tconst version = block.version ?? options?.defaultVersion ?? 1;\n\tconst stability = block.stability ?? options?.defaultStability ?? \"stable\";\n\treturn {\n\t\tmeta: {\n\t\t\tname: buildName(block, options?.namespace),\n\t\t\tversion,\n\t\t\tdescription: block.summary ?? block.title,\n\t\t\ttags: block.tags,\n\t\t\towners: block.owners,\n\t\t\tdomain: block.domain,\n\t\t\tstability\n\t\t},\n\t\tpolicy: block.visibility && block.visibility !== \"public\" ? { flags: [block.visibility] } : void 0,\n\t\tsource: {\n\t\t\ttype: \"blocknotejs\",\n\t\t\tdocJson: block.body\n\t\t},\n\t\ttargets\n\t};\n}\nfunction docBlockToPresentationSpec(block, options) {\n\tconst version = block.version ?? options?.defaultVersion ?? 1;\n\tconst stability = block.stability ?? options?.defaultStability ?? \"stable\";\n\treturn {\n\t\tmeta: {\n\t\t\tname: buildName(block, options?.namespace),\n\t\t\tversion,\n\t\t\tstability,\n\t\t\ttags: block.tags,\n\t\t\towners: block.owners,\n\t\t\tdescription: block.summary ?? block.title\n\t\t},\n\t\tcontent: {\n\t\t\tkind: \"markdown\",\n\t\t\tcontent: block.body\n\t\t}\n\t};\n}\nfunction docBlocksToPresentationRoutes(blocks, options) {\n\treturn blocks.map((block) => ({\n\t\tblock,\n\t\troute: deriveRoute(block, options?.routePrefix),\n\t\tdescriptor: docBlockToPresentationV2(block, options)\n\t}));\n}\nfunction docBlocksToPresentationSpecs(blocks, options) {\n\treturn blocks.map((block) => docBlockToPresentationSpec(block, options));\n}\nfunction mapDocRoutes(routes) {\n\treturn routes.map(({ route, descriptor }) => [route, descriptor]);\n}\n\n//#endregion\nexport { docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes }~~;\n//# sourceMappingURL=presentations.js.map~~"],"mappings":";AACA,MAAM,kBAAkB;CACvB;CACA;CACA;CACA;CACA;AACD,SAAS,eAAe,OAAO;AAC9B,KAAI,CAAC,MAAM,OAAQ,QAAO;CAC1B,MAAM,cAAc,MAAM,WAAW,IAAI,GAAG,QAAQ,IAAI;AACxD,QAAO,gBAAgB,MAAM,MAAM,YAAY,QAAQ,QAAQ,GAAG;;AAEnE,SAAS,YAAY,OAAO,aAAa;AACxC,KAAI,MAAM,MAAO,QAAO,eAAe,MAAM,MAAM;CACnD,MAAM,SAAS,eAAe;CAC9B,MAAM,OAAO,MAAM,GAAG,QAAQ,YAAY,GAAG,CAAC,QAAQ,OAAO,IAAI,CAAC,QAAQ,QAAQ,IAAI;AACtF,QAAO,eAAe,KAAK,WAAW,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO;;AAEzE,SAAS,UAAU,OAAO,WAAW;AACpC,QAAO,YAAY,GAAG,UAAU,GAAG,MAAM,OAAO,MAAM;;AAEvD,SAAS,yBAAyB,OAAO,SAAS;CACjD,MAAM,UAAU,SAAS,kBAAkB;CAC3C,MAAM,UAAU,MAAM,WAAW,SAAS,kBAAkB;CAC5D,MAAM,YAAY,MAAM,aAAa,SAAS,oBAAoB;AAClE,QAAO;EACN,MAAM;GACL,MAAM,UAAU,OAAO,SAAS,UAAU;GAC1C;GACA,aAAa,MAAM,WAAW,MAAM;GACpC,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,QAAQ,MAAM;GACd;GACA;EACD,QAAQ,MAAM,cAAc,MAAM,eAAe,WAAW,EAAE,OAAO,CAAC,MAAM,WAAW,EAAE,GAAG,KAAK;EACjG,QAAQ;GACP,MAAM;GACN,SAAS,MAAM;GACf;EACD;EACA;;AAEF,SAAS,2BAA2B,OAAO,SAAS;CACnD,MAAM,UAAU,MAAM,WAAW,SAAS,kBAAkB;CAC5D,MAAM,YAAY,MAAM,aAAa,SAAS,oBAAoB;AAClE,QAAO;EACN,MAAM;GACL,MAAM,UAAU,OAAO,SAAS,UAAU;GAC1C;GACA;GACA,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,aAAa,MAAM,WAAW,MAAM;GACpC;EACD,SAAS;GACR,MAAM;GACN,SAAS,MAAM;GACf;EACD;;AAEF,SAAS,8BAA8B,QAAQ,SAAS;AACvD,QAAO,OAAO,KAAK,WAAW;EAC7B;EACA,OAAO,YAAY,OAAO,SAAS,YAAY;EAC/C,YAAY,yBAAyB,OAAO,QAAQ;EACpD,EAAE"}
1	+ {"version":3,"file":"presentations.js","names":[],"sources":["../../../../../../../libs/contracts/dist/docs/presentations.js"],"sourcesContent":["//#region src/docs/presentations.ts\nconst DEFAULT_TARGETS = [\n\t\"markdown\",\n\t\"application/json\",\n\t\"application/xml\",\n\t\"react\"\n];\nfunction normalizeRoute(route) {\n\tif (!route.length) return \"/\";\n\tconst withLeading = route.startsWith(\"/\") ? route : `/${route}`;\n\treturn withLeading === \"/\" ? \"/\" : withLeading.replace(/\\/+$/, \"\");\n}\nfunction deriveRoute(block, routePrefix) {\n\tif (block.route) return normalizeRoute(block.route);\n\tconst prefix = routePrefix ?? \"/docs\";\n\tconst slug = block.id.replace(/^docs\\.?/, \"\").replace(/\\./g, \"/\").replace(/\\/+/g, \"/\");\n\treturn normalizeRoute(slug.startsWith(\"/\") ? slug : `${prefix}/${slug}`);\n}\nfunction buildName(block, namespace) {\n\treturn namespace ? `${namespace}.${block.id}` : block.id;\n}\nfunction docBlockToPresentationV2(block, options) {\n\tconst targets = options?.defaultTargets ?? DEFAULT_TARGETS;\n\tconst version = block.version ?? options?.defaultVersion ?? 1;\n\tconst stability = block.stability ?? options?.defaultStability ?? \"stable\";\n\treturn {\n\t\tmeta: {\n\t\t\tname: buildName(block, options?.namespace),\n\t\t\tversion,\n\t\t\tdescription: block.summary ?? block.title,\n\t\t\ttags: block.tags,\n\t\t\towners: block.owners,\n\t\t\tdomain: block.domain,\n\t\t\tstability\n\t\t},\n\t\tpolicy: block.visibility && block.visibility !== \"public\" ? { flags: [block.visibility] } : void 0,\n\t\tsource: {\n\t\t\ttype: \"blocknotejs\",\n\t\t\tdocJson: block.body\n\t\t},\n\t\ttargets\n\t};\n}\nfunction docBlockToPresentationSpec(block, options) {\n\tconst version = block.version ?? options?.defaultVersion ?? 1;\n\tconst stability = block.stability ?? options?.defaultStability ?? \"stable\";\n\treturn {\n\t\tmeta: {\n\t\t\tname: buildName(block, options?.namespace),\n\t\t\tversion,\n\t\t\tstability,\n\t\t\ttags: block.tags,\n\t\t\towners: block.owners,\n\t\t\tdescription: block.summary ?? block.title\n\t\t},\n\t\tcontent: {\n\t\t\tkind: \"markdown\",\n\t\t\tcontent: block.body\n\t\t}\n\t};\n}\nfunction docBlocksToPresentationRoutes(blocks, options) {\n\treturn blocks.map((block) => ({\n\t\tblock,\n\t\troute: deriveRoute(block, options?.routePrefix),\n\t\tdescriptor: docBlockToPresentationV2(block, options)\n\t}));\n}\nfunction docBlocksToPresentationSpecs(blocks, options) {\n\treturn blocks.map((block) => docBlockToPresentationSpec(block, options));\n}\nfunction mapDocRoutes(routes) {\n\treturn routes.map(({ route, descriptor }) => [route, descriptor]);\n}\n\n//#endregion\nexport { docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes };"],"mappings":";AACA,MAAM,kBAAkB;CACvB;CACA;CACA;CACA;CACA;AACD,SAAS,eAAe,OAAO;AAC9B,KAAI,CAAC,MAAM,OAAQ,QAAO;CAC1B,MAAM,cAAc,MAAM,WAAW,IAAI,GAAG,QAAQ,IAAI;AACxD,QAAO,gBAAgB,MAAM,MAAM,YAAY,QAAQ,QAAQ,GAAG;;AAEnE,SAAS,YAAY,OAAO,aAAa;AACxC,KAAI,MAAM,MAAO,QAAO,eAAe,MAAM,MAAM;CACnD,MAAM,SAAS,eAAe;CAC9B,MAAM,OAAO,MAAM,GAAG,QAAQ,YAAY,GAAG,CAAC,QAAQ,OAAO,IAAI,CAAC,QAAQ,QAAQ,IAAI;AACtF,QAAO,eAAe,KAAK,WAAW,IAAI,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO;;AAEzE,SAAS,UAAU,OAAO,WAAW;AACpC,QAAO,YAAY,GAAG,UAAU,GAAG,MAAM,OAAO,MAAM;;AAEvD,SAAS,yBAAyB,OAAO,SAAS;CACjD,MAAM,UAAU,SAAS,kBAAkB;CAC3C,MAAM,UAAU,MAAM,WAAW,SAAS,kBAAkB;CAC5D,MAAM,YAAY,MAAM,aAAa,SAAS,oBAAoB;AAClE,QAAO;EACN,MAAM;GACL,MAAM,UAAU,OAAO,SAAS,UAAU;GAC1C;GACA,aAAa,MAAM,WAAW,MAAM;GACpC,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,QAAQ,MAAM;GACd;GACA;EACD,QAAQ,MAAM,cAAc,MAAM,eAAe,WAAW,EAAE,OAAO,CAAC,MAAM,WAAW,EAAE,GAAG,KAAK;EACjG,QAAQ;GACP,MAAM;GACN,SAAS,MAAM;GACf;EACD;EACA;;AAEF,SAAS,2BAA2B,OAAO,SAAS;CACnD,MAAM,UAAU,MAAM,WAAW,SAAS,kBAAkB;CAC5D,MAAM,YAAY,MAAM,aAAa,SAAS,oBAAoB;AAClE,QAAO;EACN,MAAM;GACL,MAAM,UAAU,OAAO,SAAS,UAAU;GAC1C;GACA;GACA,MAAM,MAAM;GACZ,QAAQ,MAAM;GACd,aAAa,MAAM,WAAW,MAAM;GACpC;EACD,SAAS;GACR,MAAM;GACN,SAAS,MAAM;GACf;EACD;;AAEF,SAAS,8BAA8B,QAAQ,SAAS;AACvD,QAAO,OAAO,KAAK,WAAW;EAC7B;EACA,OAAO,YAAY,OAAO,SAAS,YAAY;EAC/C,YAAY,yBAAyB,OAAO,QAAQ;EACpD,EAAE"}

package/dist/libs/contracts/dist/docs/registry.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"registry.js","names":[],"sources":["../../../../../../../libs/contracts/dist/docs/registry.js"],"sourcesContent":["import { docBlockToPresentationSpec, docBlocksToPresentationRoutes } from \"./presentations.js\";\n\n//#region src/docs/registry.ts\nvar DocRegistry = class {\n\troutes = /* @__PURE__ */ new Map();\n\tconstructor(blocks = [], options) {\n\t\tblocks.forEach((block) => this.register(block, options));\n\t}\n\tregister(block, options) {\n\t\tconst [route] = docBlocksToPresentationRoutes([block], options);\n\t\tif (route) this.routes.set(block.id, route);\n\t\treturn this;\n\t}\n\tlist() {\n\t\treturn [...this.routes.values()];\n\t}\n\tget(id) {\n\t\treturn this.routes.get(id);\n\t}\n\ttoRouteTuples() {\n\t\treturn this.list().map(({ route, descriptor }) => [route, descriptor]);\n\t}\n\ttoPresentationSpecs(options) {\n\t\treturn this.list().map(({ block }) => docBlockToPresentationSpec(block, options));\n\t}\n};\nconst requiredFields = [\n\t\"id\",\n\t\"title\",\n\t\"body\",\n\t\"kind\",\n\t\"visibility\",\n\t\"route\"\n];\nconst defaultDocRegistry = new DocRegistry();\nfunction registerDocBlocks(blocks) {\n\tfor (const block of blocks) {\n\t\tfor (const field of requiredFields) if (!block[field]) throw new Error(`DocBlock ${block.id ?? \"<missing id>\"} missing field ${String(field)}`);\n\t\tdefaultDocRegistry.register(block);\n\t}\n}\nfunction listRegisteredDocBlocks() {\n\treturn defaultDocRegistry.list().map((r) => r.block);\n}\nfunction docId(id) {\n\tif (!defaultDocRegistry.get(id)) throw new Error(`DocBlock not registered: ${id}`);\n\treturn id;\n}\n\n//#endregion\nexport { DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks }~~;\n//# sourceMappingURL=registry.js.map~~"],"mappings":";;;AAGA,IAAI,cAAc,MAAM;CACvB,yBAAyB,IAAI,KAAK;CAClC,YAAY,SAAS,EAAE,EAAE,SAAS;AACjC,SAAO,SAAS,UAAU,KAAK,SAAS,OAAO,QAAQ,CAAC;;CAEzD,SAAS,OAAO,SAAS;EACxB,MAAM,CAAC,SAAS,8BAA8B,CAAC,MAAM,EAAE,QAAQ;AAC/D,MAAI,MAAO,MAAK,OAAO,IAAI,MAAM,IAAI,MAAM;AAC3C,SAAO;;CAER,OAAO;AACN,SAAO,CAAC,GAAG,KAAK,OAAO,QAAQ,CAAC;;CAEjC,IAAI,IAAI;AACP,SAAO,KAAK,OAAO,IAAI,GAAG;;CAE3B,gBAAgB;AACf,SAAO,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,iBAAiB,CAAC,OAAO,WAAW,CAAC;;CAEvE,oBAAoB,SAAS;AAC5B,SAAO,KAAK,MAAM,CAAC,KAAK,EAAE,YAAY,2BAA2B,OAAO,QAAQ,CAAC;;;AAGnF,MAAM,iBAAiB;CACtB;CACA;CACA;CACA;CACA;CACA;CACA;AACD,MAAM,qBAAqB,IAAI,aAAa;AAC5C,SAAS,kBAAkB,QAAQ;AAClC,MAAK,MAAM,SAAS,QAAQ;AAC3B,OAAK,MAAM,SAAS,eAAgB,KAAI,CAAC,MAAM,OAAQ,OAAM,IAAI,MAAM,YAAY,MAAM,MAAM,eAAe,iBAAiB,OAAO,MAAM,GAAG;AAC/I,qBAAmB,SAAS,MAAM"}
1	+ {"version":3,"file":"registry.js","names":[],"sources":["../../../../../../../libs/contracts/dist/docs/registry.js"],"sourcesContent":["import { docBlockToPresentationSpec, docBlocksToPresentationRoutes } from \"./presentations.js\";\n\n//#region src/docs/registry.ts\nvar DocRegistry = class {\n\troutes = /* @__PURE__ */ new Map();\n\tconstructor(blocks = [], options) {\n\t\tblocks.forEach((block) => this.register(block, options));\n\t}\n\tregister(block, options) {\n\t\tconst [route] = docBlocksToPresentationRoutes([block], options);\n\t\tif (route) this.routes.set(block.id, route);\n\t\treturn this;\n\t}\n\tlist() {\n\t\treturn [...this.routes.values()];\n\t}\n\tget(id) {\n\t\treturn this.routes.get(id);\n\t}\n\ttoRouteTuples() {\n\t\treturn this.list().map(({ route, descriptor }) => [route, descriptor]);\n\t}\n\ttoPresentationSpecs(options) {\n\t\treturn this.list().map(({ block }) => docBlockToPresentationSpec(block, options));\n\t}\n};\nconst requiredFields = [\n\t\"id\",\n\t\"title\",\n\t\"body\",\n\t\"kind\",\n\t\"visibility\",\n\t\"route\"\n];\nconst defaultDocRegistry = new DocRegistry();\nfunction registerDocBlocks(blocks) {\n\tfor (const block of blocks) {\n\t\tfor (const field of requiredFields) if (!block[field]) throw new Error(`DocBlock ${block.id ?? \"<missing id>\"} missing field ${String(field)}`);\n\t\tdefaultDocRegistry.register(block);\n\t}\n}\nfunction listRegisteredDocBlocks() {\n\treturn defaultDocRegistry.list().map((r) => r.block);\n}\nfunction docId(id) {\n\tif (!defaultDocRegistry.get(id)) throw new Error(`DocBlock not registered: ${id}`);\n\treturn id;\n}\n\n//#endregion\nexport { DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks };"],"mappings":";;;AAGA,IAAI,cAAc,MAAM;CACvB,yBAAyB,IAAI,KAAK;CAClC,YAAY,SAAS,EAAE,EAAE,SAAS;AACjC,SAAO,SAAS,UAAU,KAAK,SAAS,OAAO,QAAQ,CAAC;;CAEzD,SAAS,OAAO,SAAS;EACxB,MAAM,CAAC,SAAS,8BAA8B,CAAC,MAAM,EAAE,QAAQ;AAC/D,MAAI,MAAO,MAAK,OAAO,IAAI,MAAM,IAAI,MAAM;AAC3C,SAAO;;CAER,OAAO;AACN,SAAO,CAAC,GAAG,KAAK,OAAO,QAAQ,CAAC;;CAEjC,IAAI,IAAI;AACP,SAAO,KAAK,OAAO,IAAI,GAAG;;CAE3B,gBAAgB;AACf,SAAO,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,iBAAiB,CAAC,OAAO,WAAW,CAAC;;CAEvE,oBAAoB,SAAS;AAC5B,SAAO,KAAK,MAAM,CAAC,KAAK,EAAE,YAAY,2BAA2B,OAAO,QAAQ,CAAC;;;AAGnF,MAAM,iBAAiB;CACtB;CACA;CACA;CACA;CACA;CACA;CACA;AACD,MAAM,qBAAqB,IAAI,aAAa;AAC5C,SAAS,kBAAkB,QAAQ;AAClC,MAAK,MAAM,SAAS,QAAQ;AAC3B,OAAK,MAAM,SAAS,eAAgB,KAAI,CAAC,MAAM,OAAQ,OAAM,IAAI,MAAM,YAAY,MAAM,MAAM,eAAe,iBAAiB,OAAO,MAAM,GAAG;AAC/I,qBAAmB,SAAS,MAAM"}

package/dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"better-auth-nextjs.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/auth/better-auth-nextjs.docblock.ts\nconst tech_auth_better_auth_nextjs_DocBlocks = [{\n\tid: \"docs.tech.auth.better-auth-nextjs\",\n\ttitle: \"Better Auth + Next.js integration (ContractSpec)\",\n\tsummary: \"How ContractSpec wires Better Auth into Next.js (server config, client singleton, and proxy cookie-only redirects).\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/auth/better-auth-nextjs\",\n\ttags: [\n\t\t\"auth\",\n\t\t\"better-auth\",\n\t\t\"nextjs\",\n\t\t\"cookies\",\n\t\t\"proxy\",\n\t\t\"hmr\"\n\t],\n\tbody: `# Better Auth + Next.js integration (ContractSpec)\n\nThis repo uses Better Auth as the primary auth layer (sessions, organizations, teams, API keys, and OAuth).\n\n## Server config (Better Auth)\n\n- Source: \\`packages/bundles/contractspec-studio/src/application/services/auth.ts\\`\n- Important: \\`nextCookies()\\` must be the last plugin in the Better Auth plugin list so \\`Set-Cookie\\` is applied correctly in Next.js environments.\n\n## Better Auth Admin plugin\n\nContractSpec Studio enables the Better Auth Admin plugin to support platform-admin user operations (list users, impersonation, etc.).\n\n- Server: \\`admin()\\` plugin in \\`packages/bundles/contractspec-studio/src/application/services/auth.ts\\`\n- Client: \\`adminClient()\\` in \\`packages/bundles/contractspec-studio/src/presentation/providers/auth/client.ts\\`\n\n### PLATFORM_ADMIN ⇒ Better Auth admin role\n\nBetter Auth Admin endpoints authorize via \\`user.role\\`. ContractSpec enforces an org-driven rule:\n\n- If the active organization has \\`type = PLATFORM_ADMIN\\`, the signed-in user is ensured to have \\`User.role\\` containing \\`admin\\`.\n- This is applied in the session creation hook and re-checked in \\`assertsPlatformAdmin()\\`.\n\nThis keeps admin enablement deterministic and avoids manual role backfills.\n\n## Client config (React web + Expo)\n\nTo avoid duplicate background refresh/polling loops in dev (Fast Refresh/HMR), the Better Auth client is implemented as a singleton cached on \\`globalThis\\`.\n\n- Web client: \\`packages/bundles/contractspec-studio/src/presentation/providers/auth/client.ts\\`\n- Native client: \\`packages/bundles/contractspec-studio/src/presentation/providers/auth/client.native.ts\\`\n\nImport guidance:\n\n- If you only need the context/hook, prefer importing from \\`@lssm/bundle.contractspec-studio/presentation/providers/auth\\`.\n- If you explicitly need the Better Auth client instance (e.g. admin impersonation, direct API calls), import from \\`@lssm/bundle.contractspec-studio/presentation/providers/auth/client\\`.\n\n## Public routes (login / signup)\n\nPublic auth pages should avoid eager \\`authClient\\` initialization.\n\nPattern used:\n\n- In the submit handler, dynamically import \\`@lssm/bundle.contractspec-studio/presentation/providers/auth/index.web\\` and call \\`authClient.signIn.\\` / \\`authClient.signUp.\\`.\n\nThis prevents session refresh behavior from starting just because a public page rendered.\n\n## Next.js proxy auth (web-landing)\n\nThe Next.js proxy/middleware is used for redirect decisions only. It must not perform DB-backed session reads on every request.\n\n- Source: \\`packages/apps/web-landing/src/proxy.ts\\`\n- Approach: cookie-only checks via Better Auth cookies helpers:\n - \\`getSessionCookie(request)\\`\n - \\`getCookieCache(request)\\`\n\nThese checks are intentionally optimistic and should only gate routing. Full authorization must still be enforced on server-side actions/routes and GraphQL resolvers.\n`\n}];\nregisterDocBlocks(tech_auth_better_auth_nextjs_DocBlocks);\n\n//#endregion\nexport { tech_auth_better_auth_nextjs_DocBlocks }~~;\n//# sourceMappingURL=better-auth-nextjs.docblock.js.map~~"],"mappings":";;;AAGA,MAAM,yCAAyC,CAAC;CAC/C,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DN,CAAC;AACF,kBAAkB,uCAAuC"}
1	+ {"version":3,"file":"better-auth-nextjs.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/auth/better-auth-nextjs.docblock.ts\nconst tech_auth_better_auth_nextjs_DocBlocks = [{\n\tid: \"docs.tech.auth.better-auth-nextjs\",\n\ttitle: \"Better Auth + Next.js integration (ContractSpec)\",\n\tsummary: \"How ContractSpec wires Better Auth into Next.js (server config, client singleton, and proxy cookie-only redirects).\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/auth/better-auth-nextjs\",\n\ttags: [\n\t\t\"auth\",\n\t\t\"better-auth\",\n\t\t\"nextjs\",\n\t\t\"cookies\",\n\t\t\"proxy\",\n\t\t\"hmr\"\n\t],\n\tbody: `# Better Auth + Next.js integration (ContractSpec)\n\nThis repo uses Better Auth as the primary auth layer (sessions, organizations, teams, API keys, and OAuth).\n\n## Server config (Better Auth)\n\n- Source: \\`packages/bundles/contractspec-studio/src/application/services/auth.ts\\`\n- Important: \\`nextCookies()\\` must be the last plugin in the Better Auth plugin list so \\`Set-Cookie\\` is applied correctly in Next.js environments.\n\n## Better Auth Admin plugin\n\nContractSpec Studio enables the Better Auth Admin plugin to support platform-admin user operations (list users, impersonation, etc.).\n\n- Server: \\`admin()\\` plugin in \\`packages/bundles/contractspec-studio/src/application/services/auth.ts\\`\n- Client: \\`adminClient()\\` in \\`packages/bundles/contractspec-studio/src/presentation/providers/auth/client.ts\\`\n\n### PLATFORM_ADMIN ⇒ Better Auth admin role\n\nBetter Auth Admin endpoints authorize via \\`user.role\\`. ContractSpec enforces an org-driven rule:\n\n- If the active organization has \\`type = PLATFORM_ADMIN\\`, the signed-in user is ensured to have \\`User.role\\` containing \\`admin\\`.\n- This is applied in the session creation hook and re-checked in \\`assertsPlatformAdmin()\\`.\n\nThis keeps admin enablement deterministic and avoids manual role backfills.\n\n## Client config (React web + Expo)\n\nTo avoid duplicate background refresh/polling loops in dev (Fast Refresh/HMR), the Better Auth client is implemented as a singleton cached on \\`globalThis\\`.\n\n- Web client: \\`packages/bundles/contractspec-studio/src/presentation/providers/auth/client.ts\\`\n- Native client: \\`packages/bundles/contractspec-studio/src/presentation/providers/auth/client.native.ts\\`\n\nImport guidance:\n\n- If you only need the context/hook, prefer importing from \\`@lssm/bundle.contractspec-studio/presentation/providers/auth\\`.\n- If you explicitly need the Better Auth client instance (e.g. admin impersonation, direct API calls), import from \\`@lssm/bundle.contractspec-studio/presentation/providers/auth/client\\`.\n\n## Public routes (login / signup)\n\nPublic auth pages should avoid eager \\`authClient\\` initialization.\n\nPattern used:\n\n- In the submit handler, dynamically import \\`@lssm/bundle.contractspec-studio/presentation/providers/auth/index.web\\` and call \\`authClient.signIn.\\` / \\`authClient.signUp.\\`.\n\nThis prevents session refresh behavior from starting just because a public page rendered.\n\n## Next.js proxy auth (web-landing)\n\nThe Next.js proxy/middleware is used for redirect decisions only. It must not perform DB-backed session reads on every request.\n\n- Source: \\`packages/apps/web-landing/src/proxy.ts\\`\n- Approach: cookie-only checks via Better Auth cookies helpers:\n - \\`getSessionCookie(request)\\`\n - \\`getCookieCache(request)\\`\n\nThese checks are intentionally optimistic and should only gate routing. Full authorization must still be enforced on server-side actions/routes and GraphQL resolvers.\n`\n}];\nregisterDocBlocks(tech_auth_better_auth_nextjs_DocBlocks);\n\n//#endregion\nexport { tech_auth_better_auth_nextjs_DocBlocks };"],"mappings":";;;AAGA,MAAM,yCAAyC,CAAC;CAC/C,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DN,CAAC;AACF,kBAAkB,uCAAuC"}

package/dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"openapi-export.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/contracts/openapi-export.docblock.ts\nconst tech_contracts_openapi_export_DocBlocks = [{\n\tid: \"docs.tech.contracts.openapi-export\",\n\ttitle: \"OpenAPI export (OpenAPI 3.1) from SpecRegistry\",\n\tsummary: \"Generate a deterministic OpenAPI document from a SpecRegistry using jsonSchemaForSpec + REST transport metadata.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/contracts/openapi-export\",\n\ttags: [\n\t\t\"contracts\",\n\t\t\"openapi\",\n\t\t\"rest\"\n\t],\n\tbody: `## OpenAPI export (OpenAPI 3.1) from SpecRegistry\n\n### Purpose\n\nContractSpec specs can be exported into an OpenAPI 3.1 document for tooling (SDK generation, docs, gateways).\n\nThe export is spec-first:\n\n- Uses \\`jsonSchemaForSpec(spec)\\` for input/output JSON Schema (from SchemaModel → zod → JSON Schema)\n- Uses \\`spec.transport.rest.method/path\\` when present\n- Falls back to deterministic defaults:\n - Method: \\`POST\\` for commands, \\`GET\\` for queries\n - Path: \\`defaultRestPath(name, version)\\` → \\`/<dot/name>/v<version>\\`\n\n### Library API\n\n- Function: \\`openApiForRegistry(registry, options?)\\`\n- Location: \\`@lssm/lib.contracts/openapi\\`\n\n### CLI\n\nExport OpenAPI from a registry module:\n\n\\`\\`\\`bash\ncontractspec openapi --registry ./src/registry.ts --out ./openapi.json\n\\`\\`\\`\n\nThe registry module must export one of:\n\n- \\`registry: SpecRegistry\\`\n- \\`default(): SpecRegistry \| Promise<SpecRegistry>\\`\n- \\`createRegistry(): SpecRegistry \| Promise<SpecRegistry>\\`\n\n### Notes / limitations (current)\n\n- Responses are generated as a basic \\`200\\` response (plus schemas when available).\n- Query (GET) inputs are currently represented as a JSON request body when an input schema exists.\n- Errors are not yet expanded into OpenAPI responses; that will be added when we standardize error envelopes.`\n}];\nregisterDocBlocks(tech_contracts_openapi_export_DocBlocks);\n\n//#endregion\nexport { tech_contracts_openapi_export_DocBlocks }~~;\n//# sourceMappingURL=openapi-export.docblock.js.map~~"],"mappings":";;;AAGA,MAAM,0CAA0C,CAAC;CAChD,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCN,CAAC;AACF,kBAAkB,wCAAwC"}
1	+ {"version":3,"file":"openapi-export.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/contracts/openapi-export.docblock.ts\nconst tech_contracts_openapi_export_DocBlocks = [{\n\tid: \"docs.tech.contracts.openapi-export\",\n\ttitle: \"OpenAPI export (OpenAPI 3.1) from SpecRegistry\",\n\tsummary: \"Generate a deterministic OpenAPI document from a SpecRegistry using jsonSchemaForSpec + REST transport metadata.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/contracts/openapi-export\",\n\ttags: [\n\t\t\"contracts\",\n\t\t\"openapi\",\n\t\t\"rest\"\n\t],\n\tbody: `## OpenAPI export (OpenAPI 3.1) from SpecRegistry\n\n### Purpose\n\nContractSpec specs can be exported into an OpenAPI 3.1 document for tooling (SDK generation, docs, gateways).\n\nThe export is spec-first:\n\n- Uses \\`jsonSchemaForSpec(spec)\\` for input/output JSON Schema (from SchemaModel → zod → JSON Schema)\n- Uses \\`spec.transport.rest.method/path\\` when present\n- Falls back to deterministic defaults:\n - Method: \\`POST\\` for commands, \\`GET\\` for queries\n - Path: \\`defaultRestPath(name, version)\\` → \\`/<dot/name>/v<version>\\`\n\n### Library API\n\n- Function: \\`openApiForRegistry(registry, options?)\\`\n- Location: \\`@lssm/lib.contracts/openapi\\`\n\n### CLI\n\nExport OpenAPI from a registry module:\n\n\\`\\`\\`bash\ncontractspec openapi --registry ./src/registry.ts --out ./openapi.json\n\\`\\`\\`\n\nThe registry module must export one of:\n\n- \\`registry: SpecRegistry\\`\n- \\`default(): SpecRegistry \| Promise<SpecRegistry>\\`\n- \\`createRegistry(): SpecRegistry \| Promise<SpecRegistry>\\`\n\n### Notes / limitations (current)\n\n- Responses are generated as a basic \\`200\\` response (plus schemas when available).\n- Query (GET) inputs are currently represented as a JSON request body when an input schema exists.\n- Errors are not yet expanded into OpenAPI responses; that will be added when we standardize error envelopes.`\n}];\nregisterDocBlocks(tech_contracts_openapi_export_DocBlocks);\n\n//#endregion\nexport { tech_contracts_openapi_export_DocBlocks };"],"mappings":";;;AAGA,MAAM,0CAA0C,CAAC;CAChD,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCN,CAAC;AACF,kBAAkB,wCAAwC"}

package/dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"lifecycle-stage-system.docblock.js","names":[],"sources":["../../../../../../../../libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../registry.js\";\n\n//#region src/docs/tech/lifecycle-stage-system.docblock.ts\nconst tech_lifecycle_stage_system_DocBlocks = [{\n\tid: \"docs.tech.lifecycle-stage-system\",\n\ttitle: \"ContractSpec Lifecycle Stage System – Technical Design\",\n\tsummary: \"This document describes how ContractSpec implements lifecycle detection and guidance. It covers architecture, module boundaries, scoring heuristics, and integration points so libraries, modules, bundles, and Studio surfaces stay synchronized.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/lifecycle-stage-system\",\n\ttags: [\"tech\", \"lifecycle-stage-system\"],\n\tbody: \"## ContractSpec Lifecycle Stage System – Technical Design\\n\\nThis document describes how ContractSpec implements lifecycle detection and guidance. It covers architecture, module boundaries, scoring heuristics, and integration points so libraries, modules, bundles, and Studio surfaces stay synchronized.\\n\\n---\\n\\n### 1. Architecture Overview\\n\\n```\\n┌──────────────────────┐\\n│ @lssm/lib.lifecycle │ Types, enums, helpers (pure data)\\n└───────────┬──────────┘\\n │\\n┌───────────▼──────────┐ ┌───────────────────────────┐\\n│ modules/lifecycle- │ │ modules/lifecycle-advisor │\\n│ core (detection) │ │ (guidance & ceremonies) │\\n└───────────┬──────────┘ └───────────┬───────────────┘\\n │ │\\n ├────────────┬──────────────┤\\n ▼ ▼ ▼\\n Adapters: analytics, intent, questionnaires\\n │\\n┌───────────▼──────────┐\\n│ bundles/lifecycle- │ Managed service for Studio\\n│ managed │ (REST handlers, AI agent) │\\n└───────────┬──────────┘\\n │\\n ContractSpec Studio surfaces\\n (web/mobile APIs, CLI, docs)\\n```\\n\\n- Libraries provide shared vocabulary.\\n- Modules encapsulate logic, accepting adapters to avoid environment-specific code.\\n- Bundles compose modules, register agents/events, and expose APIs for Studio.\\n- Apps (web-landing, future Studio views) consume bundle APIs; they do not reimplement logic. For web-landing we now resolve `@lssm/bundle.contractspec-studio` and `@lssm/lib.database-contractspec-studio` directly from their `packages/.../src` folders via `tsconfig` path aliases so Prisma stays on the server build and Turbopack no longer pulls the prebundled `dist` artifacts into client chunks.\\n\\n---\\n\\n### 2. Core Library (`@lssm/lib.lifecycle`)\\n\\n- Stage enum (0–6) with metadata (`question`, `signals`, `traps`).\\n- Axes types (`ProductPhase`, `CompanyPhase`, `CapitalPhase`).\\n- `LifecycleSignal` (source, metric, value, timestamp).\\n- `LifecycleMetricSnapshot` (aggregated numbers).\\n- `LifecycleMilestone`, `LifecycleAction`, `LifecycleAssessment` interfaces.\\n- Utility helpers:\\n - `formatStageSummary(stage, assessment)`\\n - `rankStageCandidates(scores)`\\n\\nThe library exports no runtime dependencies so it can be imported from apps, modules, and bundles alike.\\n\\n---\\n\\n### 3. Lifecycle Core Module\\n\\nLocation: `packages/modules/lifecycle-core/`\\n\\n#### Components\\n1. StageSignalCollector\\n - Accepts adapter interfaces:\\n - `AnalyticsAdapter` (pulls metrics from `@lssm/lib.analytics` or fixture streams).\\n - `IntentAdapter` (hooks into `@lssm/lib.observability` intent detectors or logs).\\n - `QuestionnaireAdapter` (loads JSON questionnaires and responses).\\n - Produces normalized `LifecycleSignal[]`.\\n\\n2. StageScorer\\n - Weighted scoring model:\\n - Base weight per stage (reflecting expected maturity).\\n - Feature weights (retention, revenue, team size, qualitative feedback).\\n - Confidence computed via variance of contributing signals.\\n - Supports pluggable scoring matrices via JSON config.\\n - Accepts sparse metric snapshots; the orchestrator sanitizes metrics to numeric-only records before persisting assessments so downstream analytics stay consistent.\\n\\n3. LifecycleOrchestrator\\n - Coordinates collectors + scorer.\\n - Returns `LifecycleAssessment` with:\\n - `stage`, `confidence`, `axisSnapshot`, `signalsUsed`.\\n - Recommended focus areas (high-level categories only).\\n - Emits events (internally) when stage confidence crosses thresholds (consumed later by bundle).\\n\\n4. LifecycleMilestonePlanner\\n - Loads `milestones-catalog.json` (no DB).\\n - Filters upcoming milestones per stage + axis.\\n - Tracks completion using provided IDs (caller persists).\\n\\n#### Data Files\\n- `configs/stage-weights.json`\\n- `configs/milestones-catalog.json`\\n- `questionnaires/stage-readiness.json`\\n\\n#### Extension Hooks\\n- All adapters exported as TypeScript interfaces.\\n- Implementations for analytics/intent can live in bundles or apps without modifying module code.\\n\\n---\\n\\n### 4. Lifecycle Advisor Module\\n\\nLocation: `packages/modules/lifecycle-advisor/`\\n\\n#### Components\\n1. LifecycleRecommendationEngine\\n - Consumes `LifecycleAssessment`.\\n - Maps gaps to `LifecycleAction[]` using rule tables (`stage-playbooks.ts`).\\n - Supports override hooks for customer-specific rules.\\n\\n2. ContractSpecLibraryRecommender\\n - Maintains mapping from stage → recommended libraries/modules/bundles.\\n - Returns prioritized list with rationale and adoption prerequisites.\\n\\n3. LifecycleCeremonyDesigner\\n - Provides textual/structural data for ceremonies (title, copy, animation cues, soundtrack references).\\n - Ensures low-tech friendly instructions (clear copy, undo guidance).\\n\\n4. AI Hooks\\n - Defines prompt templates and tool manifests for lifecycle advisor agents (consumed by bundles).\\n - Keeps actual LLM integration outside module.\\n\\n---\\n\\n### 5. Managed Bundle (`lifecycle-managed`)\\n\\nResponsibilities\\n- Wire modules together.\\n- Provide HTTP/GraphQL handlers (exact transport optional).\\n- Register LifecycleAdvisorAgent via `@lssm/lib.ai-agent`.\\n- LifecycleAdvisorAgent meta: domain `operations`, owners `team-lifecycle`, stability `experimental`, tags `guide/lifecycle/ops` so ops tooling can route incidents quickly.\\n- Emit lifecycle events through `@lssm/lib.bus` + `@lssm/lib.analytics`.\\n- Integrate with `contractspec-studio` packages:\\n - Use Studio contracts for authentication/tenant context (without accessing tenant DBs).\\n - Store assessments in Studio-managed storage abstractions (in-memory or file-based for now).\\n\\nAPIs\\n- `POST /lifecycle/assessments`: Accepts metrics + optional questionnaire answers. Returns `LifecycleAssessment`.\\n- `GET /lifecycle/playbooks/:stage`: Returns stage playbook + ceremonies.\\n- `POST /lifecycle/advise`: Invokes LifecycleAdvisorAgent with context.\\n\\nEvents\\n- `LifecycleAssessmentCreated`\\n- `LifecycleStageChanged`\\n- `LifecycleGuidanceConsumed`\\n\\n---\\n\\n### 6. Library Enhancements\\n\\n\| Library \| Enhancement \|\\n\| --- \| --- \|\\n\| `@lssm/lib.analytics` \| Lifecycle metric collectors, helper to emit stage events, adapter implementation used by `StageSignalCollector`. \|\\n\| `@lssm/lib.evolution` \| Accepts `LifecycleContext` when ranking spec anomalies/suggestions. \|\\n\| `@lssm/lib.growth` \| Stage-specific experiment templates + guardrails referencing lifecycle enums. \|\\n\| `@lssm/lib.observability` \| Lifecycle KPI pipeline definitions (drift detection, regression alerts). \|\\n\\nEach enhancement must import stage types from `@lssm/lib.lifecycle`.\\n\\n---\\n\\n### 7. Feature Flags & Progressive Delivery\\n\\n- Add new flags in progressive-delivery library:\\n - `LIFECYCLE_DETECTION_ALPHA`\\n - `LIFECYCLE_ADVISOR_ALPHA`\\n - `LIFECYCLE_MANAGED_SERVICE`\\n- Bundles/modules should check flags before enabling workflows.\\n- Flags referenced in docs + Studio UI to avoid accidental exposure.\\n\\n---\\n\\n### 8. Analytics & Telemetry\\n\\n- Events defined in analytics library; consumed by bundle/app:\\n - `lifecycle_assessment_run`\\n - `lifecycle_stage_changed`\\n - `lifecycle_guidance_consumed`\\n- Observability pipeline includes:\\n - Composite lifecycle health metric (weighted sum of KPIs).\\n - Drift detection comparing stage predictions over time.\\n - Alert manager recipes for regression (e.g., PMF drop).\\n\\n---\\n\\n### 9. Testing Strategy\\n\\n1. Unit\\n - StageScorer weight matrix.\\n - RecommendationEngine mapping.\\n - Library recommender stage coverage.\\n\\n2. Contract\\n - Adapters: ensure mock adapters satisfy interfaces.\\n - Bundles: ensure HTTP handlers respect request/response contracts even without persistence.\\n\\n3. Integration\\n - CLI example runs detection + guidance end-to-end on fixture data.\\n - Dashboard example renders assessments, verifying JSON structures remain stable.\\n\\n---\\n\\n### 10. Implementation Checklist\\n\\n- [ ] Documentation (product, tech, ops, user).\\n- [ ] Library creation (`@lssm/lib.lifecycle`).\\n- [ ] Modules (`lifecycle-core`, `lifecycle-advisor`).\\n- [ ] Bundle (`lifecycle-managed`) + Studio wiring.\\n- [ ] Library enhancements (analytics/evolution/growth/observability).\\n- [ ] Examples (CLI + dashboard).\\n- [ ] Feature flags + telemetry.\\n- [ ] Automated tests + fixtures.\\n\\nKeep this document in sync as modules evolve. When adding new stages or axes, update `@lssm/lib.lifecycle` first, then cascade to adapters, then refresh docs + Studio copy.* End Patch* End Patch\\n\\n\\n\"\n}];\nregisterDocBlocks(tech_lifecycle_stage_system_DocBlocks);\n\n//#endregion\nexport { tech_lifecycle_stage_system_DocBlocks };\n//# sourceMappingURL=lifecycle-stage-system.docblock.js.map"],"mappings":";;;AAGA,MAAM,wCAAwC,CAAC;CAC9C,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,QAAQ,yBAAyB;CACxC,MAAM;CACN,CAAC;AACF,kBAAkB,sCAAsC"}
1	+ {"version":3,"file":"lifecycle-stage-system.docblock.js","names":[],"sources":["../../../../../../../../libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../registry.js\";\n\n//#region src/docs/tech/lifecycle-stage-system.docblock.ts\nconst tech_lifecycle_stage_system_DocBlocks = [{\n\tid: \"docs.tech.lifecycle-stage-system\",\n\ttitle: \"ContractSpec Lifecycle Stage System – Technical Design\",\n\tsummary: \"This document describes how ContractSpec implements lifecycle detection and guidance. It covers architecture, module boundaries, scoring heuristics, and integration points so libraries, modules, bundles, and Studio surfaces stay synchronized.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/lifecycle-stage-system\",\n\ttags: [\"tech\", \"lifecycle-stage-system\"],\n\tbody: \"## ContractSpec Lifecycle Stage System – Technical Design\\n\\nThis document describes how ContractSpec implements lifecycle detection and guidance. It covers architecture, module boundaries, scoring heuristics, and integration points so libraries, modules, bundles, and Studio surfaces stay synchronized.\\n\\n---\\n\\n### 1. Architecture Overview\\n\\n```\\n┌──────────────────────┐\\n│ @lssm/lib.lifecycle │ Types, enums, helpers (pure data)\\n└───────────┬──────────┘\\n │\\n┌───────────▼──────────┐ ┌───────────────────────────┐\\n│ modules/lifecycle- │ │ modules/lifecycle-advisor │\\n│ core (detection) │ │ (guidance & ceremonies) │\\n└───────────┬──────────┘ └───────────┬───────────────┘\\n │ │\\n ├────────────┬──────────────┤\\n ▼ ▼ ▼\\n Adapters: analytics, intent, questionnaires\\n │\\n┌───────────▼──────────┐\\n│ bundles/lifecycle- │ Managed service for Studio\\n│ managed │ (REST handlers, AI agent) │\\n└───────────┬──────────┘\\n │\\n ContractSpec Studio surfaces\\n (web/mobile APIs, CLI, docs)\\n```\\n\\n- Libraries provide shared vocabulary.\\n- Modules encapsulate logic, accepting adapters to avoid environment-specific code.\\n- Bundles compose modules, register agents/events, and expose APIs for Studio.\\n- Apps (web-landing, future Studio views) consume bundle APIs; they do not reimplement logic. For web-landing we now resolve `@lssm/bundle.contractspec-studio` and `@lssm/lib.database-contractspec-studio` directly from their `packages/.../src` folders via `tsconfig` path aliases so Prisma stays on the server build and Turbopack no longer pulls the prebundled `dist` artifacts into client chunks.\\n\\n---\\n\\n### 2. Core Library (`@lssm/lib.lifecycle`)\\n\\n- Stage enum (0–6) with metadata (`question`, `signals`, `traps`).\\n- Axes types (`ProductPhase`, `CompanyPhase`, `CapitalPhase`).\\n- `LifecycleSignal` (source, metric, value, timestamp).\\n- `LifecycleMetricSnapshot` (aggregated numbers).\\n- `LifecycleMilestone`, `LifecycleAction`, `LifecycleAssessment` interfaces.\\n- Utility helpers:\\n - `formatStageSummary(stage, assessment)`\\n - `rankStageCandidates(scores)`\\n\\nThe library exports no runtime dependencies so it can be imported from apps, modules, and bundles alike.\\n\\n---\\n\\n### 3. Lifecycle Core Module\\n\\nLocation: `packages/modules/lifecycle-core/`\\n\\n#### Components\\n1. StageSignalCollector\\n - Accepts adapter interfaces:\\n - `AnalyticsAdapter` (pulls metrics from `@lssm/lib.analytics` or fixture streams).\\n - `IntentAdapter` (hooks into `@lssm/lib.observability` intent detectors or logs).\\n - `QuestionnaireAdapter` (loads JSON questionnaires and responses).\\n - Produces normalized `LifecycleSignal[]`.\\n\\n2. StageScorer\\n - Weighted scoring model:\\n - Base weight per stage (reflecting expected maturity).\\n - Feature weights (retention, revenue, team size, qualitative feedback).\\n - Confidence computed via variance of contributing signals.\\n - Supports pluggable scoring matrices via JSON config.\\n - Accepts sparse metric snapshots; the orchestrator sanitizes metrics to numeric-only records before persisting assessments so downstream analytics stay consistent.\\n\\n3. LifecycleOrchestrator\\n - Coordinates collectors + scorer.\\n - Returns `LifecycleAssessment` with:\\n - `stage`, `confidence`, `axisSnapshot`, `signalsUsed`.\\n - Recommended focus areas (high-level categories only).\\n - Emits events (internally) when stage confidence crosses thresholds (consumed later by bundle).\\n\\n4. LifecycleMilestonePlanner\\n - Loads `milestones-catalog.json` (no DB).\\n - Filters upcoming milestones per stage + axis.\\n - Tracks completion using provided IDs (caller persists).\\n\\n#### Data Files\\n- `configs/stage-weights.json`\\n- `configs/milestones-catalog.json`\\n- `questionnaires/stage-readiness.json`\\n\\n#### Extension Hooks\\n- All adapters exported as TypeScript interfaces.\\n- Implementations for analytics/intent can live in bundles or apps without modifying module code.\\n\\n---\\n\\n### 4. Lifecycle Advisor Module\\n\\nLocation: `packages/modules/lifecycle-advisor/`\\n\\n#### Components\\n1. LifecycleRecommendationEngine\\n - Consumes `LifecycleAssessment`.\\n - Maps gaps to `LifecycleAction[]` using rule tables (`stage-playbooks.ts`).\\n - Supports override hooks for customer-specific rules.\\n\\n2. ContractSpecLibraryRecommender\\n - Maintains mapping from stage → recommended libraries/modules/bundles.\\n - Returns prioritized list with rationale and adoption prerequisites.\\n\\n3. LifecycleCeremonyDesigner\\n - Provides textual/structural data for ceremonies (title, copy, animation cues, soundtrack references).\\n - Ensures low-tech friendly instructions (clear copy, undo guidance).\\n\\n4. AI Hooks\\n - Defines prompt templates and tool manifests for lifecycle advisor agents (consumed by bundles).\\n - Keeps actual LLM integration outside module.\\n\\n---\\n\\n### 5. Managed Bundle (`lifecycle-managed`)\\n\\nResponsibilities\\n- Wire modules together.\\n- Provide HTTP/GraphQL handlers (exact transport optional).\\n- Register LifecycleAdvisorAgent via `@lssm/lib.ai-agent`.\\n- LifecycleAdvisorAgent meta: domain `operations`, owners `team-lifecycle`, stability `experimental`, tags `guide/lifecycle/ops` so ops tooling can route incidents quickly.\\n- Emit lifecycle events through `@lssm/lib.bus` + `@lssm/lib.analytics`.\\n- Integrate with `contractspec-studio` packages:\\n - Use Studio contracts for authentication/tenant context (without accessing tenant DBs).\\n - Store assessments in Studio-managed storage abstractions (in-memory or file-based for now).\\n\\nAPIs\\n- `POST /lifecycle/assessments`: Accepts metrics + optional questionnaire answers. Returns `LifecycleAssessment`.\\n- `GET /lifecycle/playbooks/:stage`: Returns stage playbook + ceremonies.\\n- `POST /lifecycle/advise`: Invokes LifecycleAdvisorAgent with context.\\n\\nEvents\\n- `LifecycleAssessmentCreated`\\n- `LifecycleStageChanged`\\n- `LifecycleGuidanceConsumed`\\n\\n---\\n\\n### 6. Library Enhancements\\n\\n\| Library \| Enhancement \|\\n\| --- \| --- \|\\n\| `@lssm/lib.analytics` \| Lifecycle metric collectors, helper to emit stage events, adapter implementation used by `StageSignalCollector`. \|\\n\| `@lssm/lib.evolution` \| Accepts `LifecycleContext` when ranking spec anomalies/suggestions. \|\\n\| `@lssm/lib.growth` \| Stage-specific experiment templates + guardrails referencing lifecycle enums. \|\\n\| `@lssm/lib.observability` \| Lifecycle KPI pipeline definitions (drift detection, regression alerts). \|\\n\\nEach enhancement must import stage types from `@lssm/lib.lifecycle`.\\n\\n---\\n\\n### 7. Feature Flags & Progressive Delivery\\n\\n- Add new flags in progressive-delivery library:\\n - `LIFECYCLE_DETECTION_ALPHA`\\n - `LIFECYCLE_ADVISOR_ALPHA`\\n - `LIFECYCLE_MANAGED_SERVICE`\\n- Bundles/modules should check flags before enabling workflows.\\n- Flags referenced in docs + Studio UI to avoid accidental exposure.\\n\\n---\\n\\n### 8. Analytics & Telemetry\\n\\n- Events defined in analytics library; consumed by bundle/app:\\n - `lifecycle_assessment_run`\\n - `lifecycle_stage_changed`\\n - `lifecycle_guidance_consumed`\\n- Observability pipeline includes:\\n - Composite lifecycle health metric (weighted sum of KPIs).\\n - Drift detection comparing stage predictions over time.\\n - Alert manager recipes for regression (e.g., PMF drop).\\n\\n---\\n\\n### 9. Testing Strategy\\n\\n1. Unit\\n - StageScorer weight matrix.\\n - RecommendationEngine mapping.\\n - Library recommender stage coverage.\\n\\n2. Contract\\n - Adapters: ensure mock adapters satisfy interfaces.\\n - Bundles: ensure HTTP handlers respect request/response contracts even without persistence.\\n\\n3. Integration\\n - CLI example runs detection + guidance end-to-end on fixture data.\\n - Dashboard example renders assessments, verifying JSON structures remain stable.\\n\\n---\\n\\n### 10. Implementation Checklist\\n\\n- [ ] Documentation (product, tech, ops, user).\\n- [ ] Library creation (`@lssm/lib.lifecycle`).\\n- [ ] Modules (`lifecycle-core`, `lifecycle-advisor`).\\n- [ ] Bundle (`lifecycle-managed`) + Studio wiring.\\n- [ ] Library enhancements (analytics/evolution/growth/observability).\\n- [ ] Examples (CLI + dashboard).\\n- [ ] Feature flags + telemetry.\\n- [ ] Automated tests + fixtures.\\n\\nKeep this document in sync as modules evolve. When adding new stages or axes, update `@lssm/lib.lifecycle` first, then cascade to adapters, then refresh docs + Studio copy.* End Patch* End Patch\\n\\n\\n\"\n}];\nregisterDocBlocks(tech_lifecycle_stage_system_DocBlocks);\n\n//#endregion\nexport { tech_lifecycle_stage_system_DocBlocks };"],"mappings":";;;AAGA,MAAM,wCAAwC,CAAC;CAC9C,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,QAAQ,yBAAyB;CACxC,MAAM;CACN,CAAC;AACF,kBAAkB,sCAAsC"}

package/dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"llm-integration.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/llm/llm-integration.docblock.ts\nconst tech_llm_integration_DocBlocks = [\n\t{\n\t\tid: \"docs.tech.llm.overview\",\n\t\ttitle: \"LLM Integration Overview\",\n\t\tsummary: \"Export specs to LLM-friendly formats, generate implementation guides, and verify implementations.\",\n\t\tkind: \"reference\",\n\t\tvisibility: \"public\",\n\t\troute: \"/docs/tech/llm/overview\",\n\t\ttags: [\n\t\t\t\"llm\",\n\t\t\t\"ai\",\n\t\t\t\"export\",\n\t\t\t\"guide\",\n\t\t\t\"verify\"\n\t\t],\n\t\tbody: `# LLM Integration\n\nContractSpec provides first-class LLM integration to bridge specifications and AI coding agents.\n\n## Core Features\n\n### 1. Multi-Format Export\n\nExport specs to markdown in formats optimized for LLM consumption:\n\n- Context format: Summary for understanding (goal, context, acceptance criteria)\n- Full format: Complete spec with all details (I/O schemas, policy, events)\n- Prompt format: Actionable prompt with implementation instructions\n\n### 2. Implementation Guidance\n\nGenerate agent-specific implementation plans:\n\n- Claude Code: Extended thinking mode with structured prompts\n- Cursor CLI: Background/composer mode with .mdc rules generation\n- Generic MCP: Standard format for any MCP-compatible agent\n\n### 3. Tiered Verification\n\nVerify implementations against specs:\n\n- Tier 1 (Structure): Types, exports, imports validation\n- Tier 2 (Behavior): Scenario coverage, error handling, events\n- Tier 3 (AI Review): Semantic compliance analysis via LLM\n\n## Access Points\n\n\| Surface \| Commands/Tools \|\n\|---------\|---------------\|\n\| CLI \| \\`contractspec llm export\\`, \\`guide\\`, \\`verify\\`, \\`copy\\` \|\n\| MCP \| \\`llm.export\\`, \\`llm.guide\\`, \\`llm.verify\\` tools \|\n\| VSCode \| Export to LLM, Generate Guide, Verify, Copy commands \|\n\n## Quick Start\n\n### CLI Usage\n\n\\`\\`\\`bash\n# Export spec as markdown\ncontractspec llm export path/to/my.spec.ts --format full\n\n# Generate implementation guide\ncontractspec llm guide path/to/my.spec.ts --agent claude-code\n\n# Verify implementation\ncontractspec llm verify path/to/my.spec.ts path/to/impl.ts --tier 2\n\n# Copy spec to clipboard\ncontractspec llm copy path/to/my.spec.ts --format context\n\\`\\`\\`\n\n### MCP Usage\n\n\\`\\`\\`\n# Export spec\nllm.export { specPath: \"path/to/my.spec.ts\", format: \"full\" }\n\n# Generate guide\nllm.guide { specPath: \"path/to/my.spec.ts\", agent: \"cursor-cli\" }\n\n# Verify implementation\nllm.verify { specPath: \"path/to/my.spec.ts\", implementationPath: \"path/to/impl.ts\", tier: \"2\" }\n\\`\\`\\`\n\n### Programmatic Usage\n\n\\`\\`\\`typescript\nimport { specToFullMarkdown, specToAgentPrompt } from '@lssm/lib.contracts/llm';\nimport { createAgentGuideService, createVerifyService } from '@lssm/bundle.contractspec-workspace';\n\n// Export\nconst markdown = specToFullMarkdown(mySpec);\n\n// Generate guide\nconst guideService = createAgentGuideService({ defaultAgent: 'claude-code' });\nconst guide = guideService.generateGuide(mySpec);\n\n// Verify\nconst verifyService = createVerifyService();\nconst result = await verifyService.verify(mySpec, implementationCode, {\n tiers: ['structure', 'behavior']\n});\n\\`\\`\\`\n`\n\t},\n\t{\n\t\tid: \"docs.tech.llm.export-formats\",\n\t\ttitle: \"LLM Export Formats\",\n\t\tsummary: \"Detailed explanation of the three export formats for LLM consumption.\",\n\t\tkind: \"reference\",\n\t\tvisibility: \"public\",\n\t\troute: \"/docs/tech/llm/export-formats\",\n\t\ttags: [\n\t\t\t\"llm\",\n\t\t\t\"export\",\n\t\t\t\"markdown\"\n\t\t],\n\t\tbody: `# LLM Export Formats\n\nContractSpec provides three export formats optimized for different LLM use cases.\n\n## Context Format\n\nBest for: Understanding what a spec does, providing background to LLMs.\n\nIncludes:\n- Spec name, version, type\n- Goal and context\n- Description\n- Acceptance scenarios\n\nExample:\n\n\\`\\`\\`markdown\n# users.createUser (v1)\n\n> Create a new user account with email verification.\n\nType: command \| Stability: stable\n\n## Goal\nCreate a new user in the system and trigger email verification.\n\n## Context\nPart of the user onboarding flow. Called after signup form submission.\n\n## Acceptance Criteria\n### Happy path\nGiven: Valid email and password\nWhen: User submits registration\nThen: Account is created, verification email is sent\n\\`\\`\\`\n\n## Full Format\n\nBest for: Complete documentation, implementation reference.\n\nIncludes everything:\n- All metadata\n- JSON schemas for I/O\n- Error definitions\n- Policy (auth, rate limits, PII)\n- Events emitted\n- Examples\n- Transport configuration\n\n## Prompt Format\n\nBest for: Feeding directly to coding agents.\n\nIncludes:\n- Task header with clear instructions\n- Full spec context\n- Implementation requirements\n- Task-specific guidance (implement/test/refactor/review)\n- Expected output format\n\nThe prompt format adapts based on task type:\n- implement: Full implementation with tests\n- test: Test generation for existing code\n- refactor: Refactoring while maintaining behavior\n- review: Code review against spec\n`\n\t},\n\t{\n\t\tid: \"docs.tech.llm.agent-adapters\",\n\t\ttitle: \"Agent Adapters\",\n\t\tsummary: \"Adapters for different AI coding agents (Claude, Cursor, MCP).\",\n\t\tkind: \"reference\",\n\t\tvisibility: \"public\",\n\t\troute: \"/docs/tech/llm/agent-adapters\",\n\t\ttags: [\n\t\t\t\"llm\",\n\t\t\t\"agents\",\n\t\t\t\"claude\",\n\t\t\t\"cursor\",\n\t\t\t\"mcp\"\n\t\t],\n\t\tbody: `# Agent Adapters\n\nContractSpec provides specialized adapters for different AI coding agents.\n\n## Claude Code Adapter\n\nOptimized for Anthropic Claude's extended thinking and code generation.\n\nFeatures:\n- Structured markdown with clear sections\n- Checklists for steps and verification\n- Icons for file operations (📝 create, ✏️ modify)\n- System prompt for ContractSpec context\n\nUsage:\n\\`\\`\\`typescript\nconst guideService = createAgentGuideService({ defaultAgent: 'claude-code' });\nconst result = guideService.generateGuide(spec, { agent: 'claude-code' });\n// result.prompt.systemPrompt - Claude system context\n// result.prompt.taskPrompt - Task-specific instructions\n\\`\\`\\`\n\n## Cursor CLI Adapter\n\nOptimized for Cursor's background/composer mode.\n\nFeatures:\n- Compact format for context efficiency\n- .mdc cursor rules generation\n- Integration with Cursor's file system\n- Concise step lists\n\nGenerate Cursor Rules:\n\\`\\`\\`typescript\nconst cursorRules = guideService.generateAgentConfig(spec, 'cursor-cli');\n// Save to .cursor/rules/my-spec.mdc\n\\`\\`\\`\n\n## Generic MCP Adapter\n\nWorks with any MCP-compatible agent (Cline, Aider, etc.).\n\nFeatures:\n- Standard markdown format\n- Table-based metadata\n- JSON resource format support\n- Prompt message format\n\nThe generic adapter is the default and works across all agents.\n\n## Choosing an Adapter\n\n\| Agent \| Best For \| Key Features \|\n\|-------\|----------\|--------------\|\n\| Claude Code \| Complex implementations \| Extended thinking, detailed steps \|\n\| Cursor CLI \| IDE-integrated work \| Cursor rules, compact format \|\n\| Generic MCP \| Any MCP agent \| Universal compatibility \|\n`\n\t},\n\t{\n\t\tid: \"docs.tech.llm.verification\",\n\t\ttitle: \"Implementation Verification\",\n\t\tsummary: \"Tiered verification of implementations against specifications.\",\n\t\tkind: \"reference\",\n\t\tvisibility: \"public\",\n\t\troute: \"/docs/tech/llm/verification\",\n\t\ttags: [\n\t\t\t\"llm\",\n\t\t\t\"verify\",\n\t\t\t\"validation\",\n\t\t\t\"testing\"\n\t\t],\n\t\tbody: `# Implementation Verification\n\nContractSpec provides tiered verification to check if implementations comply with specs.\n\n## Verification Tiers\n\n### Tier 1: Structure (Fast)\n\nChecks TypeScript structure against spec requirements:\n\n\| Check \| What it validates \|\n\|-------\|------------------\|\n\| Handler export \| Function is properly exported \|\n\| Contracts import \| Imports from @lssm/lib.contracts \|\n\| Schema import \| Imports from @lssm/lib.schema \|\n\| No \\`any\\` type \| TypeScript strict compliance \|\n\| Error handling \| Error codes are referenced \|\n\| Event emission \| Event patterns exist \|\n\| Input validation \| Validation patterns used \|\n\| Async patterns \| Async/await for commands \|\n\n### Tier 2: Behavior (Comprehensive)\n\nChecks implementation coverage of spec behaviors:\n\n\| Check \| What it validates \|\n\|-------\|------------------\|\n\| Scenario coverage \| Acceptance scenarios implemented \|\n\| Example coverage \| Example I/O values referenced \|\n\| Error cases \| All error conditions handled \|\n\| Event conditions \| Events emitted correctly \|\n\| Idempotency \| Idempotent patterns (if required) \|\n\n### Tier 3: AI Review (Deep)\n\nUses LLM for semantic analysis:\n\n- Does the implementation fulfill the spec's intent?\n- Are edge cases properly handled?\n- Is the code quality acceptable?\n- Are there any subtle violations?\n\nRequires AI API key configuration.\n\n## Running Verification\n\n\\`\\`\\`typescript\nconst verifyService = createVerifyService({\n aiApiKey: process.env.ANTHROPIC_API_KEY, // Optional, for Tier 3\n aiProvider: 'anthropic',\n});\n\nconst result = await verifyService.verify(spec, implementationCode, {\n tiers: ['structure', 'behavior'],\n failFast: false,\n includeSuggestions: true,\n});\n\nconsole.log(result.passed); // true/false\nconsole.log(result.score); // 0-100\nconsole.log(result.summary); // Human-readable summary\n\\`\\`\\`\n\n## Verification Report\n\nThe report includes:\n\n- passed: Overall compliance\n- score: 0-100 score\n- issues: Array of problems found\n- suggestions: Recommended fixes\n- coverage: Metrics on scenario/error/field coverage\n\nEach issue has:\n- severity: error, warning, or info\n- category: type, export, import, scenario, error_handling, semantic\n- message: Description of the issue\n- suggestion: How to fix it\n`\n\t}\n];\nregisterDocBlocks(tech_llm_integration_DocBlocks);\n\n//#endregion\nexport { tech_llm_integration_DocBlocks };\n//# sourceMappingURL=llm-integration.docblock.js.map"],"mappings":";;;AAGA,MAAM,iCAAiC;CACtC;EACC,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GACL;GACA;GACA;GACA;GACA;GACA;EACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyFN;CACD;EACC,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GACL;GACA;GACA;GACA;EACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkEN;CACD;EACC,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GACL;GACA;GACA;GACA;GACA;GACA;EACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0DN;CACD;EACC,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GACL;GACA;GACA;GACA;GACA;EACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+EN;CACD;AACD,kBAAkB,+BAA+B"}
1	+ {"version":3,"file":"llm-integration.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/llm/llm-integration.docblock.ts\nconst tech_llm_integration_DocBlocks = [\n\t{\n\t\tid: \"docs.tech.llm.overview\",\n\t\ttitle: \"LLM Integration Overview\",\n\t\tsummary: \"Export specs to LLM-friendly formats, generate implementation guides, and verify implementations.\",\n\t\tkind: \"reference\",\n\t\tvisibility: \"public\",\n\t\troute: \"/docs/tech/llm/overview\",\n\t\ttags: [\n\t\t\t\"llm\",\n\t\t\t\"ai\",\n\t\t\t\"export\",\n\t\t\t\"guide\",\n\t\t\t\"verify\"\n\t\t],\n\t\tbody: `# LLM Integration\n\nContractSpec provides first-class LLM integration to bridge specifications and AI coding agents.\n\n## Core Features\n\n### 1. Multi-Format Export\n\nExport specs to markdown in formats optimized for LLM consumption:\n\n- Context format: Summary for understanding (goal, context, acceptance criteria)\n- Full format: Complete spec with all details (I/O schemas, policy, events)\n- Prompt format: Actionable prompt with implementation instructions\n\n### 2. Implementation Guidance\n\nGenerate agent-specific implementation plans:\n\n- Claude Code: Extended thinking mode with structured prompts\n- Cursor CLI: Background/composer mode with .mdc rules generation\n- Generic MCP: Standard format for any MCP-compatible agent\n\n### 3. Tiered Verification\n\nVerify implementations against specs:\n\n- Tier 1 (Structure): Types, exports, imports validation\n- Tier 2 (Behavior): Scenario coverage, error handling, events\n- Tier 3 (AI Review): Semantic compliance analysis via LLM\n\n## Access Points\n\n\| Surface \| Commands/Tools \|\n\|---------\|---------------\|\n\| CLI \| \\`contractspec llm export\\`, \\`guide\\`, \\`verify\\`, \\`copy\\` \|\n\| MCP \| \\`llm.export\\`, \\`llm.guide\\`, \\`llm.verify\\` tools \|\n\| VSCode \| Export to LLM, Generate Guide, Verify, Copy commands \|\n\n## Quick Start\n\n### CLI Usage\n\n\\`\\`\\`bash\n# Export spec as markdown\ncontractspec llm export path/to/my.spec.ts --format full\n\n# Generate implementation guide\ncontractspec llm guide path/to/my.spec.ts --agent claude-code\n\n# Verify implementation\ncontractspec llm verify path/to/my.spec.ts path/to/impl.ts --tier 2\n\n# Copy spec to clipboard\ncontractspec llm copy path/to/my.spec.ts --format context\n\\`\\`\\`\n\n### MCP Usage\n\n\\`\\`\\`\n# Export spec\nllm.export { specPath: \"path/to/my.spec.ts\", format: \"full\" }\n\n# Generate guide\nllm.guide { specPath: \"path/to/my.spec.ts\", agent: \"cursor-cli\" }\n\n# Verify implementation\nllm.verify { specPath: \"path/to/my.spec.ts\", implementationPath: \"path/to/impl.ts\", tier: \"2\" }\n\\`\\`\\`\n\n### Programmatic Usage\n\n\\`\\`\\`typescript\nimport { specToFullMarkdown, specToAgentPrompt } from '@lssm/lib.contracts/llm';\nimport { createAgentGuideService, createVerifyService } from '@lssm/bundle.contractspec-workspace';\n\n// Export\nconst markdown = specToFullMarkdown(mySpec);\n\n// Generate guide\nconst guideService = createAgentGuideService({ defaultAgent: 'claude-code' });\nconst guide = guideService.generateGuide(mySpec);\n\n// Verify\nconst verifyService = createVerifyService();\nconst result = await verifyService.verify(mySpec, implementationCode, {\n tiers: ['structure', 'behavior']\n});\n\\`\\`\\`\n`\n\t},\n\t{\n\t\tid: \"docs.tech.llm.export-formats\",\n\t\ttitle: \"LLM Export Formats\",\n\t\tsummary: \"Detailed explanation of the three export formats for LLM consumption.\",\n\t\tkind: \"reference\",\n\t\tvisibility: \"public\",\n\t\troute: \"/docs/tech/llm/export-formats\",\n\t\ttags: [\n\t\t\t\"llm\",\n\t\t\t\"export\",\n\t\t\t\"markdown\"\n\t\t],\n\t\tbody: `# LLM Export Formats\n\nContractSpec provides three export formats optimized for different LLM use cases.\n\n## Context Format\n\nBest for: Understanding what a spec does, providing background to LLMs.\n\nIncludes:\n- Spec name, version, type\n- Goal and context\n- Description\n- Acceptance scenarios\n\nExample:\n\n\\`\\`\\`markdown\n# users.createUser (v1)\n\n> Create a new user account with email verification.\n\nType: command \| Stability: stable\n\n## Goal\nCreate a new user in the system and trigger email verification.\n\n## Context\nPart of the user onboarding flow. Called after signup form submission.\n\n## Acceptance Criteria\n### Happy path\nGiven: Valid email and password\nWhen: User submits registration\nThen: Account is created, verification email is sent\n\\`\\`\\`\n\n## Full Format\n\nBest for: Complete documentation, implementation reference.\n\nIncludes everything:\n- All metadata\n- JSON schemas for I/O\n- Error definitions\n- Policy (auth, rate limits, PII)\n- Events emitted\n- Examples\n- Transport configuration\n\n## Prompt Format\n\nBest for: Feeding directly to coding agents.\n\nIncludes:\n- Task header with clear instructions\n- Full spec context\n- Implementation requirements\n- Task-specific guidance (implement/test/refactor/review)\n- Expected output format\n\nThe prompt format adapts based on task type:\n- implement: Full implementation with tests\n- test: Test generation for existing code\n- refactor: Refactoring while maintaining behavior\n- review: Code review against spec\n`\n\t},\n\t{\n\t\tid: \"docs.tech.llm.agent-adapters\",\n\t\ttitle: \"Agent Adapters\",\n\t\tsummary: \"Adapters for different AI coding agents (Claude, Cursor, MCP).\",\n\t\tkind: \"reference\",\n\t\tvisibility: \"public\",\n\t\troute: \"/docs/tech/llm/agent-adapters\",\n\t\ttags: [\n\t\t\t\"llm\",\n\t\t\t\"agents\",\n\t\t\t\"claude\",\n\t\t\t\"cursor\",\n\t\t\t\"mcp\"\n\t\t],\n\t\tbody: `# Agent Adapters\n\nContractSpec provides specialized adapters for different AI coding agents.\n\n## Claude Code Adapter\n\nOptimized for Anthropic Claude's extended thinking and code generation.\n\nFeatures:\n- Structured markdown with clear sections\n- Checklists for steps and verification\n- Icons for file operations (📝 create, ✏️ modify)\n- System prompt for ContractSpec context\n\nUsage:\n\\`\\`\\`typescript\nconst guideService = createAgentGuideService({ defaultAgent: 'claude-code' });\nconst result = guideService.generateGuide(spec, { agent: 'claude-code' });\n// result.prompt.systemPrompt - Claude system context\n// result.prompt.taskPrompt - Task-specific instructions\n\\`\\`\\`\n\n## Cursor CLI Adapter\n\nOptimized for Cursor's background/composer mode.\n\nFeatures:\n- Compact format for context efficiency\n- .mdc cursor rules generation\n- Integration with Cursor's file system\n- Concise step lists\n\nGenerate Cursor Rules:\n\\`\\`\\`typescript\nconst cursorRules = guideService.generateAgentConfig(spec, 'cursor-cli');\n// Save to .cursor/rules/my-spec.mdc\n\\`\\`\\`\n\n## Generic MCP Adapter\n\nWorks with any MCP-compatible agent (Cline, Aider, etc.).\n\nFeatures:\n- Standard markdown format\n- Table-based metadata\n- JSON resource format support\n- Prompt message format\n\nThe generic adapter is the default and works across all agents.\n\n## Choosing an Adapter\n\n\| Agent \| Best For \| Key Features \|\n\|-------\|----------\|--------------\|\n\| Claude Code \| Complex implementations \| Extended thinking, detailed steps \|\n\| Cursor CLI \| IDE-integrated work \| Cursor rules, compact format \|\n\| Generic MCP \| Any MCP agent \| Universal compatibility \|\n`\n\t},\n\t{\n\t\tid: \"docs.tech.llm.verification\",\n\t\ttitle: \"Implementation Verification\",\n\t\tsummary: \"Tiered verification of implementations against specifications.\",\n\t\tkind: \"reference\",\n\t\tvisibility: \"public\",\n\t\troute: \"/docs/tech/llm/verification\",\n\t\ttags: [\n\t\t\t\"llm\",\n\t\t\t\"verify\",\n\t\t\t\"validation\",\n\t\t\t\"testing\"\n\t\t],\n\t\tbody: `# Implementation Verification\n\nContractSpec provides tiered verification to check if implementations comply with specs.\n\n## Verification Tiers\n\n### Tier 1: Structure (Fast)\n\nChecks TypeScript structure against spec requirements:\n\n\| Check \| What it validates \|\n\|-------\|------------------\|\n\| Handler export \| Function is properly exported \|\n\| Contracts import \| Imports from @lssm/lib.contracts \|\n\| Schema import \| Imports from @lssm/lib.schema \|\n\| No \\`any\\` type \| TypeScript strict compliance \|\n\| Error handling \| Error codes are referenced \|\n\| Event emission \| Event patterns exist \|\n\| Input validation \| Validation patterns used \|\n\| Async patterns \| Async/await for commands \|\n\n### Tier 2: Behavior (Comprehensive)\n\nChecks implementation coverage of spec behaviors:\n\n\| Check \| What it validates \|\n\|-------\|------------------\|\n\| Scenario coverage \| Acceptance scenarios implemented \|\n\| Example coverage \| Example I/O values referenced \|\n\| Error cases \| All error conditions handled \|\n\| Event conditions \| Events emitted correctly \|\n\| Idempotency \| Idempotent patterns (if required) \|\n\n### Tier 3: AI Review (Deep)\n\nUses LLM for semantic analysis:\n\n- Does the implementation fulfill the spec's intent?\n- Are edge cases properly handled?\n- Is the code quality acceptable?\n- Are there any subtle violations?\n\nRequires AI API key configuration.\n\n## Running Verification\n\n\\`\\`\\`typescript\nconst verifyService = createVerifyService({\n aiApiKey: process.env.ANTHROPIC_API_KEY, // Optional, for Tier 3\n aiProvider: 'anthropic',\n});\n\nconst result = await verifyService.verify(spec, implementationCode, {\n tiers: ['structure', 'behavior'],\n failFast: false,\n includeSuggestions: true,\n});\n\nconsole.log(result.passed); // true/false\nconsole.log(result.score); // 0-100\nconsole.log(result.summary); // Human-readable summary\n\\`\\`\\`\n\n## Verification Report\n\nThe report includes:\n\n- passed: Overall compliance\n- score: 0-100 score\n- issues: Array of problems found\n- suggestions: Recommended fixes\n- coverage: Metrics on scenario/error/field coverage\n\nEach issue has:\n- severity: error, warning, or info\n- category: type, export, import, scenario, error_handling, semantic\n- message: Description of the issue\n- suggestion: How to fix it\n`\n\t}\n];\nregisterDocBlocks(tech_llm_integration_DocBlocks);\n\n//#endregion\nexport { tech_llm_integration_DocBlocks };"],"mappings":";;;AAGA,MAAM,iCAAiC;CACtC;EACC,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GACL;GACA;GACA;GACA;GACA;GACA;EACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyFN;CACD;EACC,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GACL;GACA;GACA;GACA;EACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkEN;CACD;EACC,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GACL;GACA;GACA;GACA;GACA;GACA;EACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0DN;CACD;EACC,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM;GACL;GACA;GACA;GACA;GACA;EACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+EN;CACD;AACD,kBAAkB,+BAA+B"}

package/dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"mcp-endpoints.docblock.js","names":[],"sources":["../../../../../../../../libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../registry.js\";\n\n//#region src/docs/tech/mcp-endpoints.docblock.ts\nconst tech_mcp_endpoints_DocBlocks = [{\n\tid: \"docs.tech.mcp.endpoints\",\n\ttitle: \"ContractSpec MCP endpoints\",\n\tsummary: \"Dedicated MCP servers for docs, CLI usage, and internal development.\",\n\tkind: \"reference\",\n\tvisibility: \"mixed\",\n\troute: \"/docs/tech/mcp/endpoints\",\n\ttags: [\n\t\t\"mcp\",\n\t\t\"docs\",\n\t\t\"cli\",\n\t\t\"internal\"\n\t],\n\tbody: `# ContractSpec MCP endpoints\n\nThree dedicated MCP servers keep AI agents efficient and scoped:\n\n- Docs MCP: \\`/api/mcp/docs\\` — exposes DocBlocks as resources + presentations. Tool: \\`docs.search\\`.\n- CLI MCP: \\`/api/mcp/cli\\` — surfaces CLI quickstart/reference/README and suggests commands. Tool: \\`cli.suggestCommand\\`.\n- Internal MCP: \\`/api/mcp/internal\\` — internal routing hints, playbook, and example registry access. Tool: \\`internal.describe\\`.\n\n### Usage notes\n- Transports are HTTP POST (streamable HTTP); SSE is disabled.\n- Resources are namespaced (\\`docs://\\`, \\`cli://\\`, \\`internal://\\`) and are read-only.\n- Internal MCP also exposes the examples registry via \\`examples://\\` resources:\n - \\`examples://list?q=<query>\\`\n - \\`examples://example/<id>\\`\n- Prompts mirror each surface (navigator, usage, bootstrap) for quick agent onboarding.\n- GraphQL remains at \\`/graphql\\`; health at \\`/health\\`.\n`\n}];\nregisterDocBlocks(tech_mcp_endpoints_DocBlocks);\n\n//#endregion\nexport { tech_mcp_endpoints_DocBlocks }~~;\n//# sourceMappingURL=mcp-endpoints.docblock.js.map~~"],"mappings":";;;AAGA,MAAM,+BAA+B,CAAC;CACrC,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;CAiBN,CAAC;AACF,kBAAkB,6BAA6B"}
1	+ {"version":3,"file":"mcp-endpoints.docblock.js","names":[],"sources":["../../../../../../../../libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../registry.js\";\n\n//#region src/docs/tech/mcp-endpoints.docblock.ts\nconst tech_mcp_endpoints_DocBlocks = [{\n\tid: \"docs.tech.mcp.endpoints\",\n\ttitle: \"ContractSpec MCP endpoints\",\n\tsummary: \"Dedicated MCP servers for docs, CLI usage, and internal development.\",\n\tkind: \"reference\",\n\tvisibility: \"mixed\",\n\troute: \"/docs/tech/mcp/endpoints\",\n\ttags: [\n\t\t\"mcp\",\n\t\t\"docs\",\n\t\t\"cli\",\n\t\t\"internal\"\n\t],\n\tbody: `# ContractSpec MCP endpoints\n\nThree dedicated MCP servers keep AI agents efficient and scoped:\n\n- Docs MCP: \\`/api/mcp/docs\\` — exposes DocBlocks as resources + presentations. Tool: \\`docs.search\\`.\n- CLI MCP: \\`/api/mcp/cli\\` — surfaces CLI quickstart/reference/README and suggests commands. Tool: \\`cli.suggestCommand\\`.\n- Internal MCP: \\`/api/mcp/internal\\` — internal routing hints, playbook, and example registry access. Tool: \\`internal.describe\\`.\n\n### Usage notes\n- Transports are HTTP POST (streamable HTTP); SSE is disabled.\n- Resources are namespaced (\\`docs://\\`, \\`cli://\\`, \\`internal://\\`) and are read-only.\n- Internal MCP also exposes the examples registry via \\`examples://\\` resources:\n - \\`examples://list?q=<query>\\`\n - \\`examples://example/<id>\\`\n- Prompts mirror each surface (navigator, usage, bootstrap) for quick agent onboarding.\n- GraphQL remains at \\`/graphql\\`; health at \\`/health\\`.\n`\n}];\nregisterDocBlocks(tech_mcp_endpoints_DocBlocks);\n\n//#endregion\nexport { tech_mcp_endpoints_DocBlocks };"],"mappings":";;;AAGA,MAAM,+BAA+B,CAAC;CACrC,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;CAiBN,CAAC;AACF,kBAAkB,6BAA6B"}

package/dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"presentation-runtime.docblock.js","names":[],"sources":["../../../../../../../../libs/contracts/dist/docs/tech/presentation-runtime.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../registry.js\";\n\n//#region src/docs/tech/presentation-runtime.docblock.ts\nconst tech_presentation_runtime_DocBlocks = [{\n\tid: \"docs.tech.presentation-runtime\",\n\ttitle: \"Presentation Runtime\",\n\tsummary: \"Cross-platform runtime for list pages and presentation flows.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/presentation-runtime\",\n\ttags: [\"tech\", \"presentation-runtime\"],\n\tbody: \"## Presentation Runtime\\n\\nCross-platform runtime for list pages and presentation flows.\\n\\n### Packages\\n\\n- `@lssm/lib.presentation-runtime-core`: shared types and config helpers\\n- `@lssm/lib.presentation-runtime-react`: React hooks (web/native-compatible API)\\n- `@lssm/lib.presentation-runtime-react-native`: Native entrypoint (re-exports React API for now)\\n\\n### Next.js config helper\\n\\n```ts\\n// next.config.mjs\\nimport { withPresentationNextAliases } from '@lssm/lib.presentation-runtime-core/next';\\n\\nconst nextConfig = {\\n webpack: (config) => withPresentationNextAliases(config),\\n};\\n\\nexport default nextConfig;\\n```\\n\\n### Metro config helper\\n\\n```js\\n// metro.config.js (CJS)\\nconst { getDefaultConfig } = require('expo/metro-config');\\nconst {\\n withPresentationMetroAliases,\\n} = require('@lssm/lib.presentation-runtime-core/src/metro.cjs');\\n\\nconst projectRoot = __dirname;\\nconst config = getDefaultConfig(projectRoot);\\n\\nmodule.exports = withPresentationMetroAliases(config);\\n```\\n\\n### React hooks\\n\\n- `useListCoordinator`: URL + RHF + derived variables (no fetching)\\n- `usePresentationController`: Same plus `fetcher` integration\\n- `DataViewRenderer` (design-system): render `DataViewSpec` projections (`list`, `table`, `detail`, `grid`) using shared UI atoms\\n\\nBoth accept a `useUrlState` adapter. On web, use `useListUrlState` (design-system) or a Next adapter.\\n\\n### KYC molecules (bundle)\\n\\n- `ComplianceBadge` in `@lssm/bundle.strit/presentation/components/kyc` renders a status badge for KYC/compliance snapshots. It accepts a `state` (missing_core \| incomplete \| complete \| expiring \| unknown) and optional localized `labels`. Prefer consuming apps to pass translated labels (e.g., via `useT('appPlatformAdmin')`).\\n\\n### Markdown routes and llms.txt\\n\\n- Each web app exposes `/llms` (and `/llms.txt`, `/llms.md`) via rewrites. See [llmstxt.org](https://llmstxt.org/).\\n- Catch‑all markdown handler lives at `app/[...slug].md/route.ts`. It resolves a page descriptor from `app/.presentations.manifest.json` and renders via the `presentations.v2` engine (target: `markdown`).\\n- Per‑page companion convention: add `app/<route>/ai.ts` exporting a `PresentationDescriptorV2`.\\n- Build‑time tool: `tools/generate-presentations-manifest.mjs <app-root>` populates the manifest.\\n- CI check: `pnpm llms:check` verifies coverage (% of pages with descriptors) and fails if below threshold.\\n\"\n}];\nregisterDocBlocks(tech_presentation_runtime_DocBlocks);\n\n//#endregion\nexport { tech_presentation_runtime_DocBlocks }~~;\n//# sourceMappingURL=presentation-runtime.docblock.js.map~~"],"mappings":";;;AAGA,MAAM,sCAAsC,CAAC;CAC5C,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,QAAQ,uBAAuB;CACtC,MAAM;CACN,CAAC;AACF,kBAAkB,oCAAoC"}
1	+ {"version":3,"file":"presentation-runtime.docblock.js","names":[],"sources":["../../../../../../../../libs/contracts/dist/docs/tech/presentation-runtime.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../registry.js\";\n\n//#region src/docs/tech/presentation-runtime.docblock.ts\nconst tech_presentation_runtime_DocBlocks = [{\n\tid: \"docs.tech.presentation-runtime\",\n\ttitle: \"Presentation Runtime\",\n\tsummary: \"Cross-platform runtime for list pages and presentation flows.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/presentation-runtime\",\n\ttags: [\"tech\", \"presentation-runtime\"],\n\tbody: \"## Presentation Runtime\\n\\nCross-platform runtime for list pages and presentation flows.\\n\\n### Packages\\n\\n- `@lssm/lib.presentation-runtime-core`: shared types and config helpers\\n- `@lssm/lib.presentation-runtime-react`: React hooks (web/native-compatible API)\\n- `@lssm/lib.presentation-runtime-react-native`: Native entrypoint (re-exports React API for now)\\n\\n### Next.js config helper\\n\\n```ts\\n// next.config.mjs\\nimport { withPresentationNextAliases } from '@lssm/lib.presentation-runtime-core/next';\\n\\nconst nextConfig = {\\n webpack: (config) => withPresentationNextAliases(config),\\n};\\n\\nexport default nextConfig;\\n```\\n\\n### Metro config helper\\n\\n```js\\n// metro.config.js (CJS)\\nconst { getDefaultConfig } = require('expo/metro-config');\\nconst {\\n withPresentationMetroAliases,\\n} = require('@lssm/lib.presentation-runtime-core/src/metro.cjs');\\n\\nconst projectRoot = __dirname;\\nconst config = getDefaultConfig(projectRoot);\\n\\nmodule.exports = withPresentationMetroAliases(config);\\n```\\n\\n### React hooks\\n\\n- `useListCoordinator`: URL + RHF + derived variables (no fetching)\\n- `usePresentationController`: Same plus `fetcher` integration\\n- `DataViewRenderer` (design-system): render `DataViewSpec` projections (`list`, `table`, `detail`, `grid`) using shared UI atoms\\n\\nBoth accept a `useUrlState` adapter. On web, use `useListUrlState` (design-system) or a Next adapter.\\n\\n### KYC molecules (bundle)\\n\\n- `ComplianceBadge` in `@lssm/bundle.strit/presentation/components/kyc` renders a status badge for KYC/compliance snapshots. It accepts a `state` (missing_core \| incomplete \| complete \| expiring \| unknown) and optional localized `labels`. Prefer consuming apps to pass translated labels (e.g., via `useT('appPlatformAdmin')`).\\n\\n### Markdown routes and llms.txt\\n\\n- Each web app exposes `/llms` (and `/llms.txt`, `/llms.md`) via rewrites. See [llmstxt.org](https://llmstxt.org/).\\n- Catch‑all markdown handler lives at `app/[...slug].md/route.ts`. It resolves a page descriptor from `app/.presentations.manifest.json` and renders via the `presentations.v2` engine (target: `markdown`).\\n- Per‑page companion convention: add `app/<route>/ai.ts` exporting a `PresentationDescriptorV2`.\\n- Build‑time tool: `tools/generate-presentations-manifest.mjs <app-root>` populates the manifest.\\n- CI check: `pnpm llms:check` verifies coverage (% of pages with descriptors) and fails if below threshold.\\n\"\n}];\nregisterDocBlocks(tech_presentation_runtime_DocBlocks);\n\n//#endregion\nexport { tech_presentation_runtime_DocBlocks };"],"mappings":";;;AAGA,MAAM,sCAAsC,CAAC;CAC5C,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,QAAQ,uBAAuB;CACtC,MAAM;CACN,CAAC;AACF,kBAAkB,oCAAoC"}

package/dist/libs/contracts/dist/docs/tech/schema/README.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"README.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/schema/README.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/schema/README.docblock.ts\nconst tech_schema_README_DocBlocks = [{\n\tid: \"docs.tech.schema.README\",\n\ttitle: \"Multi‑File Prisma Schema Conventions (per database)\",\n\tsummary: \"We adopt Prisma multi‑file schema (GA ≥ v6.7) to organize each database’s models by domain and to import core LSSM module schemas locally.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/schema/README\",\n\ttags: [\n\t\t\"tech\",\n\t\t\"schema\",\n\t\t\"README\"\n\t],\n\tbody: \"# Multi‑File Prisma Schema Conventions (per database)\\n\\nWe adopt Prisma multi‑file schema (GA ≥ v6.7) to organize each database’s models by domain and to import core LSSM module schemas locally.\\n\\nCanonical layout per DB:\\n\\n```\\nprisma/\\n schema/\\n main.prisma # datasource + generators only\\n imported/\\n lssm_sigil/.prisma # imported models/enums only (no datasource/generator)\\n lssm_content/.prisma # idem\\n <domain>/.prisma # vertical‑specific models split by bounded context\\n```\\n\\nNotes:\\n\\n- Imported files contain only `model` and `enum` blocks (strip `datasource`/`generator`).\\n- Preserve `@@schema(\\\"…\\\")` annotations to keep tables in their Postgres schemas; we now explicitly list schemas in `main.prisma` to avoid P1012: `schemas = [\\\"public\\\",\\\"lssm_sigil\\\",\\\"lssm_content\\\",\\\"lssm_featureflags\\\",\\\"lssm_ops\\\",\\\"lssm_planning\\\",\\\"lssm_quill\\\",\\\"lssm_geoterro\\\"]`.\\n- Use `@lssm/app.cli-database` CLI: `database import\|check\|generate\|migrate:\|seed` to manage a single DB; `@lssm/app.cli-databases` orchestrates multiple DBs.\\n\\n## Typed merger config\\n\\n- Define imported module list once per DB with a typed config:\\n\\n```ts\\n// prisma-merger.config.ts\\nimport { defineMergedPrismaConfig } from '@lssm/app.cli-database';\\n\\nexport default defineMergedPrismaConfig({\\n modules: [\\n '@lssm/app.cli-database-sigil',\\n '@lssm/app.cli-database-content',\\n // ...\\n ],\\n});\\n```\\n\\n- Then run `database import --target .` (no need to pass `--modules`).\\n\\n## Prisma Config (prisma.config.ts)\\n\\nWe use Prisma Config per official docs to point Prisma to the multi-file schema folder and migrations:\\n\\n```ts\\n// prisma.config.ts\\nimport path from 'node:path';\\nimport { defineConfig } from 'prisma/config';\\n\\nexport default defineConfig({\\n schema: path.join('prisma', 'schema'),\\n migrations: { path: path.join('prisma', 'migrations') },\\n});\\n```\\n\\nReference: Prisma blog – Organize Your Prisma Schema into Multiple Files: https://www.prisma.io/blog/organize-your-prisma-schema-with-multi-file-support\\n\\n---\\n\\n# LSSM Auth (Sigil) – Models & Integration\\n\\nThis document tracks the identity models and integration points used by the LSSM Sigil module.\\n\\n## Models (Prisma `lssm_sigil`)\\n\\n- `User` – core identity with email, optional phone, role, passkeys, apiKeys\\n- `Session` – session tokens and metadata; includes `activeOrganizationId`\\n- `Account` – external providers (password, OAuth)\\n- `Organization` – tenant boundary; includes `type` additional field\\n- `Member`, `Invitation`, `Team`, `TeamMember` – org/teams\\n- `Role`, `Permission`, `PolicyBinding` – RBAC\\n- `ApiKey`, `Passkey` – programmable access and WebAuthn\\n- `SsoProvider` – OIDC/SAML provider configuration (org- or user-scoped)\\n- `OAuthApplication`, `OAuthAccessToken`, `OAuthConsent` – first/third-party OAuth\\n\\nThese mirror STRIT additions so Better Auth advanced plugins (admin, organization, apiKey, passkey, genericOAuth) work uniformly across apps.\\n\\n## Better Auth (server)\\n\\nEnabled methods:\\n\\n- Email & password\\n- Phone OTP (Telnyx)\\n- Passkey (WebAuthn)\\n- API keys\\n- Organizations & Teams\\n- Generic OAuth (FranceConnect+ via OIDC with JWE/JWS using JOSE)\\n\\nServer config lives at `packages/lssm/modules/sigil/src/application/services/auth.ts`.\\n\\n## Clients (Expo / React)\\n\\nClient config lives at `packages/lssm/modules/sigil/src/presentation/providers/auth/expo.ts` with plugins for admin, passkey, apiKey, organization, phone, genericOAuth.\\n\\n## Environment Variables\\n\\nTelnyx (phone OTP):\\n\\n- `TELNYX_API_KEY`\\n- `TELNYX_MESSAGING_PROFILE_ID`\\n- `TELNYX_FROM_NUMBER`\\n\\nFranceConnect+ (prefer LSSM… but STRIT… fallbacks are supported):\\n\\n- `LSSM_FRANCECONNECTPLUS_DISCOVERY_URL`\\n- `LSSM_FRANCECONNECTPLUS_CLIENT_ID`\\n- `LSSM_FRANCECONNECTPLUS_CLIENT_SECRET`\\n- `LSSM_FRANCECONNECTPLUS_ENC_PRIVATE_KEY_PEM` (PKCS8; RSA-OAEP-256)\\n\\nGeneric:\\n\\n- `API_URL_IDENTITIES` – base URL for Better Auth server\\n- `BETTER_AUTH_SECRET` – server secret\\n\\nKeep this in sync with code changes to avoid drift.\\n\\n## HCircle domain splits and auth removal\\n\\n- Auth/identity models are not defined locally anymore. They come from `@lssm/app.cli-database-sigil` under the `lssm_sigil` schema.\\n- `packages/hcircle/libs/database-coliving/prisma/schema/domain/` is split by domain; newsletter/waiting list lives in `newsletter.prisma` and uses `@@map(\\\"waiting_list\\\")`.\\n- To avoid collisions with module names, the local event models were renamed to `SocialEvent`, `SocialEventAttendee`, and `SocialEventRecurrence` with `@@map` pointing to existing table names.\\n\\n---\\n\\n## Vertical profiles (current)\\n\\n### STRIT\\n\\n- prisma-merger modules:\\n - `@lssm/app.cli-database-sigil`, `@lssm/app.cli-database-content`, `@lssm/app.cli-database-ops`, `@lssm/app.cli-database-planning`, `@lssm/app.cli-database-quill`, `@lssm/app.cli-database-geoterro`\\n- main.prisma schemas:\\n - `schemas = [\\\"public\\\",\\\"lssm_sigil\\\",\\\"lssm_content\\\",\\\"lssm_ops\\\",\\\"lssm_planning\\\",\\\"lssm_quill\\\",\\\"lssm_geoterro\\\"]`\\n- domain splits (`packages/strit/libs/database/prisma/schema/domain/`):\\n - `bookings.prisma` (Booking, StritDocument + links to Content `File` and Sigil `Organization`)\\n - `commerce.prisma` (Wholesale models; `sellerId` linked to Sigil `Organization`)\\n - `files.prisma` (PublicFile, PublicFileAccessLog; `ownerId`→Organization, `uploadedBy`→User)\\n - `geo.prisma` (PublicCountry, PublicAddress, City; links to Spots/Series)\\n - `spots.prisma`, `urbanism.prisma`, `analytics.prisma`, `onboarding.prisma`, `referrals.prisma`, `subscriptions.prisma`, `content.prisma`\\n- auth models are imported from Sigil (no local auth tables).\\n- Back-relations for `Organization` (e.g., `files`, seller relations) are declared in the Sigil module to avoid scattering.\\n\\n### ARTISANOS\\n\\n- prisma-merger modules:\\n - `@lssm/app.cli-database-sigil`, `@lssm/app.cli-database-content`, `@lssm/app.cli-database-featureflags`, `@lssm/app.cli-database-ops`, `@lssm/app.cli-database-planning`, `@lssm/app.cli-database-quill`, `@lssm/app.cli-database-geoterro`\\n- main.prisma schemas:\\n - `schemas = [\\\"public\\\",\\\"lssm_sigil\\\",\\\"lssm_content\\\",\\\"lssm_featureflags\\\",\\\"lssm_ops\\\",\\\"lssm_planning\\\",\\\"lssm_quill\\\",\\\"lssm_geoterro\\\"]`\\n- domain splits (`packages/artisanos/libs/database-artisan/prisma/schema/domain/`):\\n - `sales.prisma` (Client, Quote, QuoteTemplate, Invoice, FollowUps)\\n - `subsidies.prisma` (SubsidyProgram, AidApplication, SupportingDocument)\\n - `projects.prisma` (Project, ProjectPlanningSettings)\\n - `crm.prisma` (OrganizationProfessionalProfile, OrganizationCertification)\\n - `professions.prisma`, `products.prisma`, `templates.prisma`, `analytics.prisma`, `onboarding.prisma`, `referrals.prisma`, `subscriptions.prisma`, `files.prisma`\\n- auth/organization/team models are provided by Sigil; local legacy copies were removed.\\n- Where names collide with Content, local models are prefixed (e.g., `PublicFile`) and use `@@map` to keep existing table names where applicable.\\n\\n## Schema Dictionary: `@lssm/lib.schema`\\n\\n### Purpose\\n\\nDescribe operation I/O once and generate:\\n\\n- zod (runtime validation)\\n- GraphQL (Pothos types/refs)\\n- JSON Schema (via `zod-to-json-schema` or native descriptors)\\n\\n### Primitives\\n\\n- FieldType<T>: describes a scalar or composite field and carries:\\n - `zod` schema for validation\\n - optional JSON Schema descriptor\\n - optional GraphQL scalar reference/name\\n- SchemaModel: named object model composed of fields. Exposes helpers:\\n - `getZod(): z.ZodObject<ZodShapeFromFields<Fields>> \| z.ZodArray<z.ZodObject<...>>`\\n - Preserves each field's schema, optionality, and array-ness\\n - Top-level lists are supported via `config.isArray: true`\\n - `getJsonSchema(): JSONSchema7` (export for docs, MCP, forms)\\n - `getPothosInput()` (GraphQL input object name)\\n\\n### Conventions\\n\\n- Name models with PascalCase; suffix with `Input`/`Result` when ambiguous.\\n- Use explicit enums for multi-value constants; reuse the same enum across input/output.\\n- Define domain enums via `defineEnum('Name', [...])` in the relevant domain package (e.g., `packages/strit/libs/contracts-strit/src/enums/`), not in `ScalarTypeEnum`.\\n- Reference those enums in `SchemaModel` fields directly (they expose `getZod`, `getPothos`, `getJsonSchema`).\\n\\n#### Example (STRIT)\\n\\n```ts\\n// packages/strit/libs/contracts-strit/src/enums/recurrence.ts\\nimport { defineEnum } from '@lssm/lib.schema';\\nexport const SpotEnum = {\\n Weekday: () =>\\n defineEnum('Weekday', ['MO', 'TU', 'WE', 'TH', 'FR', 'SA', 'SU'] as const),\\n RecurrenceFrequency: () =>\\n defineEnum('RecurrenceFrequency', [\\n 'DAILY',\\n 'WEEKLY',\\n 'MONTHLY',\\n 'YEARLY',\\n ] as const),\\n} as const;\\n```\\n\\n```ts\\n// usage in contracts\\nfrequency: { type: SpotEnum.RecurrenceFrequency(), isOptional: false },\\nbyWeekday: { type: SpotEnum.Weekday(), isOptional: true, isArray: true },\\n```\\n\\n- Use `Date` type for temporal values and ensure ISO strings in JSON transports where needed.\\n\\n### Mapping rules (summary)\\n\\n- Strings → GraphQL `String`\\n- Numbers → `Int` if safe 32-bit integer else `Float`\\n- Booleans → `Boolean`\\n- Dates → custom `Date` scalar\\n- Arrays<T> → list of mapped T (set `isArray: true` on the field)\\n- Top-level arrays → set `isArray: true` on the model config\\n- Objects → input/output object types with stable field order\\n- Unions → supported for output; input unions map to JSON (structural input is not supported by GraphQL)\\n\\n### JSON Schema export\\n\\nPrefer `getZod()` + `zod-to-json-schema` for consistency. For advanced cases, provide a custom `getJsonSchema()` on the model.\\n\\n### Example\\n\\n```ts\\nimport { ScalarTypeEnum, SchemaModel } from '@lssm/lib.schema';\\n\\n// Nested model\\nconst Weekday = new SchemaModel({\\n name: 'Weekday',\\n fields: {\\n value: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\\n },\\n});\\n\\n// Parent model with array field and nested object\\nconst Rule = new SchemaModel({\\n name: 'Rule',\\n fields: {\\n timezone: { type: ScalarTypeEnum.TimeZone(), isOptional: false },\\n byWeekday: { type: Weekday, isOptional: true, isArray: true },\\n },\\n});\\n\\nconst CreateThingInput = new SchemaModel({\\n name: 'CreateThingInput',\\n fields: {\\n name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\\n rule: { type: Rule, isOptional: false },\\n },\\n});\\n\\n// zod\\nconst z = CreateThingInput.getZod();\\n```\\n\"\n}];\nregisterDocBlocks(tech_schema_README_DocBlocks);\n\n//#endregion\nexport { tech_schema_README_DocBlocks };\n//# sourceMappingURL=README.docblock.js.map"],"mappings":";;;AAGA,MAAM,+BAA+B,CAAC;CACrC,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;CACD,MAAM;CACN,CAAC;AACF,kBAAkB,6BAA6B"}
1	+ {"version":3,"file":"README.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/schema/README.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/schema/README.docblock.ts\nconst tech_schema_README_DocBlocks = [{\n\tid: \"docs.tech.schema.README\",\n\ttitle: \"Multi‑File Prisma Schema Conventions (per database)\",\n\tsummary: \"We adopt Prisma multi‑file schema (GA ≥ v6.7) to organize each database’s models by domain and to import core LSSM module schemas locally.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/schema/README\",\n\ttags: [\n\t\t\"tech\",\n\t\t\"schema\",\n\t\t\"README\"\n\t],\n\tbody: \"# Multi‑File Prisma Schema Conventions (per database)\\n\\nWe adopt Prisma multi‑file schema (GA ≥ v6.7) to organize each database’s models by domain and to import core LSSM module schemas locally.\\n\\nCanonical layout per DB:\\n\\n```\\nprisma/\\n schema/\\n main.prisma # datasource + generators only\\n imported/\\n lssm_sigil/.prisma # imported models/enums only (no datasource/generator)\\n lssm_content/.prisma # idem\\n <domain>/.prisma # vertical‑specific models split by bounded context\\n```\\n\\nNotes:\\n\\n- Imported files contain only `model` and `enum` blocks (strip `datasource`/`generator`).\\n- Preserve `@@schema(\\\"…\\\")` annotations to keep tables in their Postgres schemas; we now explicitly list schemas in `main.prisma` to avoid P1012: `schemas = [\\\"public\\\",\\\"lssm_sigil\\\",\\\"lssm_content\\\",\\\"lssm_featureflags\\\",\\\"lssm_ops\\\",\\\"lssm_planning\\\",\\\"lssm_quill\\\",\\\"lssm_geoterro\\\"]`.\\n- Use `@lssm/app.cli-database` CLI: `database import\|check\|generate\|migrate:\|seed` to manage a single DB; `@lssm/app.cli-databases` orchestrates multiple DBs.\\n\\n## Typed merger config\\n\\n- Define imported module list once per DB with a typed config:\\n\\n```ts\\n// prisma-merger.config.ts\\nimport { defineMergedPrismaConfig } from '@lssm/app.cli-database';\\n\\nexport default defineMergedPrismaConfig({\\n modules: [\\n '@lssm/app.cli-database-sigil',\\n '@lssm/app.cli-database-content',\\n // ...\\n ],\\n});\\n```\\n\\n- Then run `database import --target .` (no need to pass `--modules`).\\n\\n## Prisma Config (prisma.config.ts)\\n\\nWe use Prisma Config per official docs to point Prisma to the multi-file schema folder and migrations:\\n\\n```ts\\n// prisma.config.ts\\nimport path from 'node:path';\\nimport { defineConfig } from 'prisma/config';\\n\\nexport default defineConfig({\\n schema: path.join('prisma', 'schema'),\\n migrations: { path: path.join('prisma', 'migrations') },\\n});\\n```\\n\\nReference: Prisma blog – Organize Your Prisma Schema into Multiple Files: https://www.prisma.io/blog/organize-your-prisma-schema-with-multi-file-support\\n\\n---\\n\\n# LSSM Auth (Sigil) – Models & Integration\\n\\nThis document tracks the identity models and integration points used by the LSSM Sigil module.\\n\\n## Models (Prisma `lssm_sigil`)\\n\\n- `User` – core identity with email, optional phone, role, passkeys, apiKeys\\n- `Session` – session tokens and metadata; includes `activeOrganizationId`\\n- `Account` – external providers (password, OAuth)\\n- `Organization` – tenant boundary; includes `type` additional field\\n- `Member`, `Invitation`, `Team`, `TeamMember` – org/teams\\n- `Role`, `Permission`, `PolicyBinding` – RBAC\\n- `ApiKey`, `Passkey` – programmable access and WebAuthn\\n- `SsoProvider` – OIDC/SAML provider configuration (org- or user-scoped)\\n- `OAuthApplication`, `OAuthAccessToken`, `OAuthConsent` – first/third-party OAuth\\n\\nThese mirror STRIT additions so Better Auth advanced plugins (admin, organization, apiKey, passkey, genericOAuth) work uniformly across apps.\\n\\n## Better Auth (server)\\n\\nEnabled methods:\\n\\n- Email & password\\n- Phone OTP (Telnyx)\\n- Passkey (WebAuthn)\\n- API keys\\n- Organizations & Teams\\n- Generic OAuth (FranceConnect+ via OIDC with JWE/JWS using JOSE)\\n\\nServer config lives at `packages/lssm/modules/sigil/src/application/services/auth.ts`.\\n\\n## Clients (Expo / React)\\n\\nClient config lives at `packages/lssm/modules/sigil/src/presentation/providers/auth/expo.ts` with plugins for admin, passkey, apiKey, organization, phone, genericOAuth.\\n\\n## Environment Variables\\n\\nTelnyx (phone OTP):\\n\\n- `TELNYX_API_KEY`\\n- `TELNYX_MESSAGING_PROFILE_ID`\\n- `TELNYX_FROM_NUMBER`\\n\\nFranceConnect+ (prefer LSSM… but STRIT… fallbacks are supported):\\n\\n- `LSSM_FRANCECONNECTPLUS_DISCOVERY_URL`\\n- `LSSM_FRANCECONNECTPLUS_CLIENT_ID`\\n- `LSSM_FRANCECONNECTPLUS_CLIENT_SECRET`\\n- `LSSM_FRANCECONNECTPLUS_ENC_PRIVATE_KEY_PEM` (PKCS8; RSA-OAEP-256)\\n\\nGeneric:\\n\\n- `API_URL_IDENTITIES` – base URL for Better Auth server\\n- `BETTER_AUTH_SECRET` – server secret\\n\\nKeep this in sync with code changes to avoid drift.\\n\\n## HCircle domain splits and auth removal\\n\\n- Auth/identity models are not defined locally anymore. They come from `@lssm/app.cli-database-sigil` under the `lssm_sigil` schema.\\n- `packages/hcircle/libs/database-coliving/prisma/schema/domain/` is split by domain; newsletter/waiting list lives in `newsletter.prisma` and uses `@@map(\\\"waiting_list\\\")`.\\n- To avoid collisions with module names, the local event models were renamed to `SocialEvent`, `SocialEventAttendee`, and `SocialEventRecurrence` with `@@map` pointing to existing table names.\\n\\n---\\n\\n## Vertical profiles (current)\\n\\n### STRIT\\n\\n- prisma-merger modules:\\n - `@lssm/app.cli-database-sigil`, `@lssm/app.cli-database-content`, `@lssm/app.cli-database-ops`, `@lssm/app.cli-database-planning`, `@lssm/app.cli-database-quill`, `@lssm/app.cli-database-geoterro`\\n- main.prisma schemas:\\n - `schemas = [\\\"public\\\",\\\"lssm_sigil\\\",\\\"lssm_content\\\",\\\"lssm_ops\\\",\\\"lssm_planning\\\",\\\"lssm_quill\\\",\\\"lssm_geoterro\\\"]`\\n- domain splits (`packages/strit/libs/database/prisma/schema/domain/`):\\n - `bookings.prisma` (Booking, StritDocument + links to Content `File` and Sigil `Organization`)\\n - `commerce.prisma` (Wholesale models; `sellerId` linked to Sigil `Organization`)\\n - `files.prisma` (PublicFile, PublicFileAccessLog; `ownerId`→Organization, `uploadedBy`→User)\\n - `geo.prisma` (PublicCountry, PublicAddress, City; links to Spots/Series)\\n - `spots.prisma`, `urbanism.prisma`, `analytics.prisma`, `onboarding.prisma`, `referrals.prisma`, `subscriptions.prisma`, `content.prisma`\\n- auth models are imported from Sigil (no local auth tables).\\n- Back-relations for `Organization` (e.g., `files`, seller relations) are declared in the Sigil module to avoid scattering.\\n\\n### ARTISANOS\\n\\n- prisma-merger modules:\\n - `@lssm/app.cli-database-sigil`, `@lssm/app.cli-database-content`, `@lssm/app.cli-database-featureflags`, `@lssm/app.cli-database-ops`, `@lssm/app.cli-database-planning`, `@lssm/app.cli-database-quill`, `@lssm/app.cli-database-geoterro`\\n- main.prisma schemas:\\n - `schemas = [\\\"public\\\",\\\"lssm_sigil\\\",\\\"lssm_content\\\",\\\"lssm_featureflags\\\",\\\"lssm_ops\\\",\\\"lssm_planning\\\",\\\"lssm_quill\\\",\\\"lssm_geoterro\\\"]`\\n- domain splits (`packages/artisanos/libs/database-artisan/prisma/schema/domain/`):\\n - `sales.prisma` (Client, Quote, QuoteTemplate, Invoice, FollowUps)\\n - `subsidies.prisma` (SubsidyProgram, AidApplication, SupportingDocument)\\n - `projects.prisma` (Project, ProjectPlanningSettings)\\n - `crm.prisma` (OrganizationProfessionalProfile, OrganizationCertification)\\n - `professions.prisma`, `products.prisma`, `templates.prisma`, `analytics.prisma`, `onboarding.prisma`, `referrals.prisma`, `subscriptions.prisma`, `files.prisma`\\n- auth/organization/team models are provided by Sigil; local legacy copies were removed.\\n- Where names collide with Content, local models are prefixed (e.g., `PublicFile`) and use `@@map` to keep existing table names where applicable.\\n\\n## Schema Dictionary: `@lssm/lib.schema`\\n\\n### Purpose\\n\\nDescribe operation I/O once and generate:\\n\\n- zod (runtime validation)\\n- GraphQL (Pothos types/refs)\\n- JSON Schema (via `zod-to-json-schema` or native descriptors)\\n\\n### Primitives\\n\\n- FieldType<T>: describes a scalar or composite field and carries:\\n - `zod` schema for validation\\n - optional JSON Schema descriptor\\n - optional GraphQL scalar reference/name\\n- SchemaModel: named object model composed of fields. Exposes helpers:\\n - `getZod(): z.ZodObject<ZodShapeFromFields<Fields>> \| z.ZodArray<z.ZodObject<...>>`\\n - Preserves each field's schema, optionality, and array-ness\\n - Top-level lists are supported via `config.isArray: true`\\n - `getJsonSchema(): JSONSchema7` (export for docs, MCP, forms)\\n - `getPothosInput()` (GraphQL input object name)\\n\\n### Conventions\\n\\n- Name models with PascalCase; suffix with `Input`/`Result` when ambiguous.\\n- Use explicit enums for multi-value constants; reuse the same enum across input/output.\\n- Define domain enums via `defineEnum('Name', [...])` in the relevant domain package (e.g., `packages/strit/libs/contracts-strit/src/enums/`), not in `ScalarTypeEnum`.\\n- Reference those enums in `SchemaModel` fields directly (they expose `getZod`, `getPothos`, `getJsonSchema`).\\n\\n#### Example (STRIT)\\n\\n```ts\\n// packages/strit/libs/contracts-strit/src/enums/recurrence.ts\\nimport { defineEnum } from '@lssm/lib.schema';\\nexport const SpotEnum = {\\n Weekday: () =>\\n defineEnum('Weekday', ['MO', 'TU', 'WE', 'TH', 'FR', 'SA', 'SU'] as const),\\n RecurrenceFrequency: () =>\\n defineEnum('RecurrenceFrequency', [\\n 'DAILY',\\n 'WEEKLY',\\n 'MONTHLY',\\n 'YEARLY',\\n ] as const),\\n} as const;\\n```\\n\\n```ts\\n// usage in contracts\\nfrequency: { type: SpotEnum.RecurrenceFrequency(), isOptional: false },\\nbyWeekday: { type: SpotEnum.Weekday(), isOptional: true, isArray: true },\\n```\\n\\n- Use `Date` type for temporal values and ensure ISO strings in JSON transports where needed.\\n\\n### Mapping rules (summary)\\n\\n- Strings → GraphQL `String`\\n- Numbers → `Int` if safe 32-bit integer else `Float`\\n- Booleans → `Boolean`\\n- Dates → custom `Date` scalar\\n- Arrays<T> → list of mapped T (set `isArray: true` on the field)\\n- Top-level arrays → set `isArray: true` on the model config\\n- Objects → input/output object types with stable field order\\n- Unions → supported for output; input unions map to JSON (structural input is not supported by GraphQL)\\n\\n### JSON Schema export\\n\\nPrefer `getZod()` + `zod-to-json-schema` for consistency. For advanced cases, provide a custom `getJsonSchema()` on the model.\\n\\n### Example\\n\\n```ts\\nimport { ScalarTypeEnum, SchemaModel } from '@lssm/lib.schema';\\n\\n// Nested model\\nconst Weekday = new SchemaModel({\\n name: 'Weekday',\\n fields: {\\n value: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\\n },\\n});\\n\\n// Parent model with array field and nested object\\nconst Rule = new SchemaModel({\\n name: 'Rule',\\n fields: {\\n timezone: { type: ScalarTypeEnum.TimeZone(), isOptional: false },\\n byWeekday: { type: Weekday, isOptional: true, isArray: true },\\n },\\n});\\n\\nconst CreateThingInput = new SchemaModel({\\n name: 'CreateThingInput',\\n fields: {\\n name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\\n rule: { type: Rule, isOptional: false },\\n },\\n});\\n\\n// zod\\nconst z = CreateThingInput.getZod();\\n```\\n\"\n}];\nregisterDocBlocks(tech_schema_README_DocBlocks);\n\n//#endregion\nexport { tech_schema_README_DocBlocks };"],"mappings":";;;AAGA,MAAM,+BAA+B,CAAC;CACrC,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;CACD,MAAM;CACN,CAAC;AACF,kBAAkB,6BAA6B"}

package/dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"learning-events.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/studio/learning-events.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/studio/learning-events.docblock.ts\nconst tech_studio_learning_events_DocBlocks = [{\n\tid: \"docs.tech.studio.learning-events\",\n\ttitle: \"Studio Learning Events\",\n\tsummary: \"Studio persists learning/activity events to the database; Sandbox keeps learning local-first and unlogged.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/studio/learning-events\",\n\ttags: [\n\t\t\"studio\",\n\t\t\"learning\",\n\t\t\"events\",\n\t\t\"analytics\",\n\t\t\"sandbox\"\n\t],\n\tbody: `# Studio Learning Events\n\nStudio emits lightweight learning/activity events to support onboarding, ambient coaching, and learning journeys.\n\n## Persistence model\n\n- Studio: events are persisted to the database in \\`StudioLearningEvent\\` and are organization-scoped (optionally project-scoped).\n- Sandbox: events remain local-only (unlogged); they must never be sent to backend services.\n\n## GraphQL API\n\n- \\`recordLearningEvent(input: { name, projectId?, payload? })\\`\n- \\`myLearningEvents(projectId?, limit?)\\`\n- \\`myOnboardingTracks(productId?, includeProgress?)\\`\n- \\`myOnboardingProgress(trackKey)\\`\n- \\`dismissOnboardingTrack(trackKey)\\`\n\n## Common event names (convention)\n\n- \\`module.navigated\\` — user navigated to a Studio module (payload at minimum: \\`{ moduleId }\\`).\n- \\`studio.template.instantiated\\` — created a new Studio project (starter template). Payload commonly includes \\`{ templateId, projectSlug }\\`.\n- \\`spec.changed\\` — created or updated a Studio spec. Payload may include \\`{ action: 'create' \| 'update', specId?, specType? }\\`.\n- \\`regeneration.completed\\` — finished a “regen/deploy” action (currently emitted on successful Studio deploy actions).\n- \\`studio.evolution.applied\\` — completed an Evolution session (payload commonly includes \\`{ evolutionSessionId }\\`).\n\nThese events are intentionally minimal and must avoid PII/secrets in payloads.\n`\n}];\nregisterDocBlocks(tech_studio_learning_events_DocBlocks);\n\n//#endregion\nexport { tech_studio_learning_events_DocBlocks }~~;\n//# sourceMappingURL=learning-events.docblock.js.map~~"],"mappings":";;;AAGA,MAAM,wCAAwC,CAAC;CAC9C,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BN,CAAC;AACF,kBAAkB,sCAAsC"}
1	+ {"version":3,"file":"learning-events.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/studio/learning-events.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/studio/learning-events.docblock.ts\nconst tech_studio_learning_events_DocBlocks = [{\n\tid: \"docs.tech.studio.learning-events\",\n\ttitle: \"Studio Learning Events\",\n\tsummary: \"Studio persists learning/activity events to the database; Sandbox keeps learning local-first and unlogged.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/studio/learning-events\",\n\ttags: [\n\t\t\"studio\",\n\t\t\"learning\",\n\t\t\"events\",\n\t\t\"analytics\",\n\t\t\"sandbox\"\n\t],\n\tbody: `# Studio Learning Events\n\nStudio emits lightweight learning/activity events to support onboarding, ambient coaching, and learning journeys.\n\n## Persistence model\n\n- Studio: events are persisted to the database in \\`StudioLearningEvent\\` and are organization-scoped (optionally project-scoped).\n- Sandbox: events remain local-only (unlogged); they must never be sent to backend services.\n\n## GraphQL API\n\n- \\`recordLearningEvent(input: { name, projectId?, payload? })\\`\n- \\`myLearningEvents(projectId?, limit?)\\`\n- \\`myOnboardingTracks(productId?, includeProgress?)\\`\n- \\`myOnboardingProgress(trackKey)\\`\n- \\`dismissOnboardingTrack(trackKey)\\`\n\n## Common event names (convention)\n\n- \\`module.navigated\\` — user navigated to a Studio module (payload at minimum: \\`{ moduleId }\\`).\n- \\`studio.template.instantiated\\` — created a new Studio project (starter template). Payload commonly includes \\`{ templateId, projectSlug }\\`.\n- \\`spec.changed\\` — created or updated a Studio spec. Payload may include \\`{ action: 'create' \| 'update', specId?, specType? }\\`.\n- \\`regeneration.completed\\` — finished a “regen/deploy” action (currently emitted on successful Studio deploy actions).\n- \\`studio.evolution.applied\\` — completed an Evolution session (payload commonly includes \\`{ evolutionSessionId }\\`).\n\nThese events are intentionally minimal and must avoid PII/secrets in payloads.\n`\n}];\nregisterDocBlocks(tech_studio_learning_events_DocBlocks);\n\n//#endregion\nexport { tech_studio_learning_events_DocBlocks };"],"mappings":";;;AAGA,MAAM,wCAAwC,CAAC;CAC9C,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BN,CAAC;AACF,kBAAkB,sCAAsC"}

package/dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"learning-journeys.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/studio/learning-journeys.docblock.ts\nconst tech_studio_learning_journeys_DocBlocks = [{\n\tid: \"docs.tech.studio.learning-journeys\",\n\ttitle: \"Studio learning journeys (onboarding + coach)\",\n\tsummary: \"DB-backed learning journeys tracked per organization: seeded tracks/steps, event-driven progress, XP/streaks, and a Studio coach surface.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/studio/learning-journeys\",\n\ttags: [\n\t\t\"studio\",\n\t\t\"learning\",\n\t\t\"onboarding\",\n\t\t\"journey\",\n\t\t\"graphql\",\n\t\t\"database\"\n\t],\n\tbody: `# Studio learning journeys\n\nStudio supports DB-backed learning journeys (onboarding tracks + ambient coach tips) that are advanced by recorded learning events.\n\n> See also: \\`/docs/tech/studio/learning-events\\` for event naming + payload guardrails.\n\n## Scope (multi-tenancy)\n\n- Progress is tracked per organization (tenant/workspace), via a \\`Learner\\` record keyed by \\`(userId, organizationId)\\`.\n- Learning events are stored as \\`StudioLearningEvent\\` under the Studio DB schema, scoped to an organization (optionally a project).\n\n## Persistence model (Prisma)\n\nLearning journey progress lives in the \\`lssm_learning\\` schema:\n\n- \\`Learner\\` — one per \\`(userId, organizationId)\\`\n- \\`OnboardingTrack\\` — seeded track definitions (trackKey, name, metadata)\n- \\`OnboardingStep\\` — seeded step definitions (stepKey, completionCondition, xpReward, metadata)\n- \\`OnboardingProgress\\` — learner × track progress (progress %, xpEarned, completedAt, dismissedAt)\n- \\`OnboardingStepCompletion\\` — append-only completion records (stepKey, status, xpEarned, completedAt)\n\n## Track definition source (spec-first)\n\n- Canonical track specs live in \\`@lssm/example.learning-journey-registry\\`.\n- The Studio API seeds/updates the DB definitions via an idempotent “ensure tracks” routine.\n- The DB is kept aligned with track specs (stale steps are removed) to prevent drift and unblock completion.\n\n## Progress advancement (event-driven)\n\n1) UI records an event via GraphQL \\`recordLearningEvent\\`\n2) Backend creates \\`StudioLearningEvent\\`\n3) Backend advances onboarding by matching the new event against step completion conditions\n4) Backend persists step completions and recomputes:\n - \\`progress\\` percentage\n - \\`xpEarned\\` (including streak/completion bonuses when configured)\n - track completion state (\\`completedAt\\`)\n\n## GraphQL API (Studio)\n\n- \\`myOnboardingTracks(productId?, includeProgress?)\\`\n - returns all tracks + optional progress for the current learner\n- \\`myOnboardingProgress(trackKey)\\`\n - returns progress + step completion list for a single track\n- \\`dismissOnboardingTrack(trackKey)\\`\n - marks a track dismissed for the learner (prevents auto-coach)\n\n## UI routes/surfaces (web)\n\n- \\`/studio/learning\\` — learning hub (track list + progress widget)\n- \\`/studio/learning/{trackKey}\\` — track detail (steps + map)\n- Studio shell mounts a coach sheet that can auto-open for incomplete, non-dismissed onboarding.\n\n## Security + data hygiene\n\n- Do not put secrets/PII in \\`payload\\` fields of learning events.\n- Prefer shallow payload filters (small, stable keys).\n`\n}];\nregisterDocBlocks(tech_studio_learning_journeys_DocBlocks);\n\n//#endregion\nexport { tech_studio_learning_journeys_DocBlocks }~~;\n//# sourceMappingURL=learning-journeys.docblock.js.map~~"],"mappings":";;;AAGA,MAAM,0CAA0C,CAAC;CAChD,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDN,CAAC;AACF,kBAAkB,wCAAwC"}
1	+ {"version":3,"file":"learning-journeys.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/studio/learning-journeys.docblock.ts\nconst tech_studio_learning_journeys_DocBlocks = [{\n\tid: \"docs.tech.studio.learning-journeys\",\n\ttitle: \"Studio learning journeys (onboarding + coach)\",\n\tsummary: \"DB-backed learning journeys tracked per organization: seeded tracks/steps, event-driven progress, XP/streaks, and a Studio coach surface.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/studio/learning-journeys\",\n\ttags: [\n\t\t\"studio\",\n\t\t\"learning\",\n\t\t\"onboarding\",\n\t\t\"journey\",\n\t\t\"graphql\",\n\t\t\"database\"\n\t],\n\tbody: `# Studio learning journeys\n\nStudio supports DB-backed learning journeys (onboarding tracks + ambient coach tips) that are advanced by recorded learning events.\n\n> See also: \\`/docs/tech/studio/learning-events\\` for event naming + payload guardrails.\n\n## Scope (multi-tenancy)\n\n- Progress is tracked per organization (tenant/workspace), via a \\`Learner\\` record keyed by \\`(userId, organizationId)\\`.\n- Learning events are stored as \\`StudioLearningEvent\\` under the Studio DB schema, scoped to an organization (optionally a project).\n\n## Persistence model (Prisma)\n\nLearning journey progress lives in the \\`lssm_learning\\` schema:\n\n- \\`Learner\\` — one per \\`(userId, organizationId)\\`\n- \\`OnboardingTrack\\` — seeded track definitions (trackKey, name, metadata)\n- \\`OnboardingStep\\` — seeded step definitions (stepKey, completionCondition, xpReward, metadata)\n- \\`OnboardingProgress\\` — learner × track progress (progress %, xpEarned, completedAt, dismissedAt)\n- \\`OnboardingStepCompletion\\` — append-only completion records (stepKey, status, xpEarned, completedAt)\n\n## Track definition source (spec-first)\n\n- Canonical track specs live in \\`@lssm/example.learning-journey-registry\\`.\n- The Studio API seeds/updates the DB definitions via an idempotent “ensure tracks” routine.\n- The DB is kept aligned with track specs (stale steps are removed) to prevent drift and unblock completion.\n\n## Progress advancement (event-driven)\n\n1) UI records an event via GraphQL \\`recordLearningEvent\\`\n2) Backend creates \\`StudioLearningEvent\\`\n3) Backend advances onboarding by matching the new event against step completion conditions\n4) Backend persists step completions and recomputes:\n - \\`progress\\` percentage\n - \\`xpEarned\\` (including streak/completion bonuses when configured)\n - track completion state (\\`completedAt\\`)\n\n## GraphQL API (Studio)\n\n- \\`myOnboardingTracks(productId?, includeProgress?)\\`\n - returns all tracks + optional progress for the current learner\n- \\`myOnboardingProgress(trackKey)\\`\n - returns progress + step completion list for a single track\n- \\`dismissOnboardingTrack(trackKey)\\`\n - marks a track dismissed for the learner (prevents auto-coach)\n\n## UI routes/surfaces (web)\n\n- \\`/studio/learning\\` — learning hub (track list + progress widget)\n- \\`/studio/learning/{trackKey}\\` — track detail (steps + map)\n- Studio shell mounts a coach sheet that can auto-open for incomplete, non-dismissed onboarding.\n\n## Security + data hygiene\n\n- Do not put secrets/PII in \\`payload\\` fields of learning events.\n- Prefer shallow payload filters (small, stable keys).\n`\n}];\nregisterDocBlocks(tech_studio_learning_journeys_DocBlocks);\n\n//#endregion\nexport { tech_studio_learning_journeys_DocBlocks };"],"mappings":";;;AAGA,MAAM,0CAA0C,CAAC;CAChD,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDN,CAAC;AACF,kBAAkB,wCAAwC"}

package/dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"platform-admin-panel.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/studio/platform-admin-panel.docblock.ts\nconst tech_studio_platform_admin_panel_DocBlocks = [{\n\tid: \"docs.tech.studio.platform-admin-panel\",\n\ttitle: \"Studio Platform Admin Panel\",\n\tsummary: \"How PLATFORM_ADMIN organizations manage tenant orgs and integration connections without session switching.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/studio/platform-admin-panel\",\n\ttags: [\n\t\t\"studio\",\n\t\t\"admin\",\n\t\t\"multi-tenancy\",\n\t\t\"integrations\",\n\t\t\"better-auth\"\n\t],\n\tbody: `# Studio Platform Admin Panel\n\nContractSpec Studio exposes a dedicated Platform Admin Panel for users whose active organization has:\n\n- \\`Organization.type = PLATFORM_ADMIN\\`\n\nThe UI route is:\n\n- \\`/studio/admin\\`\n\n## Authorization model (no org switching)\n\nPlatform admins remain in their own organization. Cross-tenant actions are always explicit and scoped:\n\n- Admin operations require an explicit \\`targetOrganizationId\\`.\n- No session / activeOrganizationId switching is performed as part of admin operations.\n\n## Integrations management\n\nThe admin panel manages the full ContractSpec Integrations system:\n\n- Lists all shipped \\`IntegrationSpec\\` entries (registry built via \\`createDefaultIntegrationSpecRegistry()\\`).\n- CRUD \\`IntegrationConnection\\` records for a selected tenant org.\n\n### Secrets (reference-only + write-only)\n\nThe admin UI supports two modes:\n\n- Reference-only (BYOK): store only \\`secretProvider\\` + \\`secretRef\\`.\n- Write-only provisioning/rotation: paste a raw secret payload; server writes to the selected backend and stores the resulting reference. The secret value is never returned or displayed.\n\nSupported backends:\n\n- Env overrides (\\`env://...\\`)\n- Google Cloud Secret Manager (\\`gcp://...\\`)\n- AWS Secrets Manager (\\`aws://secretsmanager/...\\`)\n- Scaleway Secret Manager (\\`scw://secret-manager/...\\`)\n\n## Better Auth Admin plugin\n\nThe panel uses the Better Auth Admin plugin for user operations (list users, impersonation):\n\n- Client calls use \\`authClient.admin.\\`.\n- Server-side, ContractSpec enforces that users in a PLATFORM_ADMIN active org have \\`User.role\\` containing \\`admin\\` so Better Auth Admin endpoints authorize.\n\n## GraphQL surface\n\nThe platform-admin GraphQL operations are guarded by the active org type and include:\n\n- \\`platformAdminOrganizations(search, limit, offset)\\`\n- \\`platformAdminIntegrationSpecs\\`\n- \\`platformAdminIntegrationConnections(input: { targetOrganizationId, category?, status? })\\`\n- \\`platformAdminIntegrationConnectionCreate(input)\\`\n- \\`platformAdminIntegrationConnectionUpdate(input)\\`\n- \\`platformAdminIntegrationConnectionDelete(targetOrganizationId, connectionId)\\`\n\n## Key implementation files\n\n- Auth + role enforcement: \\`packages/bundles/contractspec-studio/src/application/services/auth.ts\\`\n- Admin GraphQL module: \\`packages/bundles/contractspec-studio/src/infrastructure/graphql/modules/platform-admin.ts\\`\n- Integrations admin service: \\`packages/bundles/contractspec-studio/src/modules/platform-integrations/index.ts\\`\n- Web route: \\`packages/apps/web-landing/src/app/(app-customer)/studio/admin/\\`\n`\n}];\nregisterDocBlocks(tech_studio_platform_admin_panel_DocBlocks);\n\n//#endregion\nexport { tech_studio_platform_admin_panel_DocBlocks }~~;\n//# sourceMappingURL=platform-admin-panel.docblock.js.map~~"],"mappings":";;;AAGA,MAAM,6CAA6C,CAAC;CACnD,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DN,CAAC;AACF,kBAAkB,2CAA2C"}
1	+ {"version":3,"file":"platform-admin-panel.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/studio/platform-admin-panel.docblock.ts\nconst tech_studio_platform_admin_panel_DocBlocks = [{\n\tid: \"docs.tech.studio.platform-admin-panel\",\n\ttitle: \"Studio Platform Admin Panel\",\n\tsummary: \"How PLATFORM_ADMIN organizations manage tenant orgs and integration connections without session switching.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/studio/platform-admin-panel\",\n\ttags: [\n\t\t\"studio\",\n\t\t\"admin\",\n\t\t\"multi-tenancy\",\n\t\t\"integrations\",\n\t\t\"better-auth\"\n\t],\n\tbody: `# Studio Platform Admin Panel\n\nContractSpec Studio exposes a dedicated Platform Admin Panel for users whose active organization has:\n\n- \\`Organization.type = PLATFORM_ADMIN\\`\n\nThe UI route is:\n\n- \\`/studio/admin\\`\n\n## Authorization model (no org switching)\n\nPlatform admins remain in their own organization. Cross-tenant actions are always explicit and scoped:\n\n- Admin operations require an explicit \\`targetOrganizationId\\`.\n- No session / activeOrganizationId switching is performed as part of admin operations.\n\n## Integrations management\n\nThe admin panel manages the full ContractSpec Integrations system:\n\n- Lists all shipped \\`IntegrationSpec\\` entries (registry built via \\`createDefaultIntegrationSpecRegistry()\\`).\n- CRUD \\`IntegrationConnection\\` records for a selected tenant org.\n\n### Secrets (reference-only + write-only)\n\nThe admin UI supports two modes:\n\n- Reference-only (BYOK): store only \\`secretProvider\\` + \\`secretRef\\`.\n- Write-only provisioning/rotation: paste a raw secret payload; server writes to the selected backend and stores the resulting reference. The secret value is never returned or displayed.\n\nSupported backends:\n\n- Env overrides (\\`env://...\\`)\n- Google Cloud Secret Manager (\\`gcp://...\\`)\n- AWS Secrets Manager (\\`aws://secretsmanager/...\\`)\n- Scaleway Secret Manager (\\`scw://secret-manager/...\\`)\n\n## Better Auth Admin plugin\n\nThe panel uses the Better Auth Admin plugin for user operations (list users, impersonation):\n\n- Client calls use \\`authClient.admin.\\`.\n- Server-side, ContractSpec enforces that users in a PLATFORM_ADMIN active org have \\`User.role\\` containing \\`admin\\` so Better Auth Admin endpoints authorize.\n\n## GraphQL surface\n\nThe platform-admin GraphQL operations are guarded by the active org type and include:\n\n- \\`platformAdminOrganizations(search, limit, offset)\\`\n- \\`platformAdminIntegrationSpecs\\`\n- \\`platformAdminIntegrationConnections(input: { targetOrganizationId, category?, status? })\\`\n- \\`platformAdminIntegrationConnectionCreate(input)\\`\n- \\`platformAdminIntegrationConnectionUpdate(input)\\`\n- \\`platformAdminIntegrationConnectionDelete(targetOrganizationId, connectionId)\\`\n\n## Key implementation files\n\n- Auth + role enforcement: \\`packages/bundles/contractspec-studio/src/application/services/auth.ts\\`\n- Admin GraphQL module: \\`packages/bundles/contractspec-studio/src/infrastructure/graphql/modules/platform-admin.ts\\`\n- Integrations admin service: \\`packages/bundles/contractspec-studio/src/modules/platform-integrations/index.ts\\`\n- Web route: \\`packages/apps/web-landing/src/app/(app-customer)/studio/admin/\\`\n`\n}];\nregisterDocBlocks(tech_studio_platform_admin_panel_DocBlocks);\n\n//#endregion\nexport { tech_studio_platform_admin_panel_DocBlocks };"],"mappings":";;;AAGA,MAAM,6CAA6C,CAAC;CACnD,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DN,CAAC;AACF,kBAAkB,2CAA2C"}

package/dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"project-access-teams.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/studio/project-access-teams.docblock.ts\nconst tech_studio_project_access_teams_DocBlocks = [{\n\tid: \"docs.tech.studio.project-access-teams\",\n\ttitle: \"Studio Project Access via Teams\",\n\tsummary: \"Projects live under organizations; team sharing refines access with an admin/owner override.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/studio/project-access-teams\",\n\ttags: [\n\t\t\"studio\",\n\t\t\"projects\",\n\t\t\"teams\",\n\t\t\"rbac\",\n\t\t\"access-control\"\n\t],\n\tbody: `# Studio Project Access via Teams\n\nStudio access control is organization-first with optional team-based sharing.\n\n## Data model\n\n- \\`Team\\` and \\`TeamMember\\` define team membership inside an organization.\n- \\`StudioProject\\` is owned by an organization.\n- \\`StudioProjectTeam\\` links projects to 0..N teams.\n\n## Access rules\n\n- Admins/owners: always have access to all projects in the organization.\n- Org-wide projects: if a project has no team links, all organization members can access it.\n- Team-scoped projects: if a project has one or more team links, a user must be a member of at least one linked team.\n\n## GraphQL surfaces\n\n- Read:\\n - \\`myStudioProjects\\` (returns only projects you can access)\\n - \\`studioProjectBySlug(slug)\\` (enforces the same access rules)\\n - \\`myTeams\\`\\n - \\`projectTeams(projectId)\\`\\n\\n- Write:\\n - \\`createStudioProject(input.teamIds?)\\` (teamIds optional)\\n - \\`setProjectTeams(projectId, teamIds)\\` (admin-only)\\n\n## Related\\n+\\n+- Team administration + invitations: see \\`/docs/tech/studio/team-invitations\\`.\\n+\n## Notes\n\nPayloads and events must avoid secrets/PII. For Sandbox, the model remains local-first and unlogged.\n`\n}];\nregisterDocBlocks(tech_studio_project_access_teams_DocBlocks);\n\n//#endregion\nexport { tech_studio_project_access_teams_DocBlocks }~~;\n//# sourceMappingURL=project-access-teams.docblock.js.map~~"],"mappings":";;;AAGA,MAAM,6CAA6C,CAAC;CACnD,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;CAwBN,CAAC;AACF,kBAAkB,2CAA2C"}
1	+ {"version":3,"file":"project-access-teams.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/studio/project-access-teams.docblock.ts\nconst tech_studio_project_access_teams_DocBlocks = [{\n\tid: \"docs.tech.studio.project-access-teams\",\n\ttitle: \"Studio Project Access via Teams\",\n\tsummary: \"Projects live under organizations; team sharing refines access with an admin/owner override.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/studio/project-access-teams\",\n\ttags: [\n\t\t\"studio\",\n\t\t\"projects\",\n\t\t\"teams\",\n\t\t\"rbac\",\n\t\t\"access-control\"\n\t],\n\tbody: `# Studio Project Access via Teams\n\nStudio access control is organization-first with optional team-based sharing.\n\n## Data model\n\n- \\`Team\\` and \\`TeamMember\\` define team membership inside an organization.\n- \\`StudioProject\\` is owned by an organization.\n- \\`StudioProjectTeam\\` links projects to 0..N teams.\n\n## Access rules\n\n- Admins/owners: always have access to all projects in the organization.\n- Org-wide projects: if a project has no team links, all organization members can access it.\n- Team-scoped projects: if a project has one or more team links, a user must be a member of at least one linked team.\n\n## GraphQL surfaces\n\n- Read:\\n - \\`myStudioProjects\\` (returns only projects you can access)\\n - \\`studioProjectBySlug(slug)\\` (enforces the same access rules)\\n - \\`myTeams\\`\\n - \\`projectTeams(projectId)\\`\\n\\n- Write:\\n - \\`createStudioProject(input.teamIds?)\\` (teamIds optional)\\n - \\`setProjectTeams(projectId, teamIds)\\` (admin-only)\\n\n## Related\\n+\\n+- Team administration + invitations: see \\`/docs/tech/studio/team-invitations\\`.\\n+\n## Notes\n\nPayloads and events must avoid secrets/PII. For Sandbox, the model remains local-first and unlogged.\n`\n}];\nregisterDocBlocks(tech_studio_project_access_teams_DocBlocks);\n\n//#endregion\nexport { tech_studio_project_access_teams_DocBlocks };"],"mappings":";;;AAGA,MAAM,6CAA6C,CAAC;CACnD,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;CAwBN,CAAC;AACF,kBAAkB,2CAA2C"}

package/dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"project-routing.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/studio/project-routing.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/studio/project-routing.docblock.ts\nconst tech_studio_project_routing_DocBlocks = [{\n\tid: \"docs.tech.studio.project-routing\",\n\ttitle: \"Studio Project Routing\",\n\tsummary: \"Studio uses slugged, project-first routes: /studio/{projectSlug}/* with canonical slug redirects and soft-deleted projects hidden.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/studio/project-routing\",\n\ttags: [\n\t\t\"studio\",\n\t\t\"routing\",\n\t\t\"projects\",\n\t\t\"slug\",\n\t\t\"redirects\"\n\t],\n\tbody: `# Studio Project Routing\n\nContractSpec Studio uses a project-first URL scheme:\n\n- \\`/studio/projects\\` — create, select, and delete projects.\n- \\`/studio/{projectSlug}/\\` — project modules (canvas/specs/deploy/integrations/evolution/learning).\n- \\`/studio/learning\\` — learning hub that does not require selecting a project.\n\n## Studio layout shell\n\nStudio routes are wrapped in a dedicated Studio app shell* (header + footer) that provides in-app navigation (Projects/Learning/Teams), organization switching, and account actions.\n\nProject module routes (\\`/studio/{projectSlug}/\\`) render their own module shell (\\`WorkspaceProjectShellLayout\\`). When combined with the global Studio header, the project shell uses a sticky header offset* to avoid overlapping sticky headers.\n\n## Slug behavior (rename-safe)\n\n- Each project has a \\`slug\\` stored in the database (\\`StudioProject.slug\\`).\n- When a project name changes, Studio updates the slug and stores the previous slug as an alias (\\`StudioProjectSlugAlias\\`).\n- Requests to an alias slug are redirected to the canonical slug.\n\nGraphQL entrypoint:\n\n- \\`studioProjectBySlug(slug: String!)\\` returns:\n - \\`project\\`\n - \\`canonicalSlug\\`\n - \\`wasRedirect\\`\n\n## Deletion behavior (soft delete)\n\nProjects are soft-deleted:\n\n- \\`deleteStudioProject(id: String!)\\` sets \\`StudioProject.deletedAt\\`.\n- All listings and access checks filter \\`deletedAt = null\\`.\n- Soft-deleted projects are treated as “not found” in Studio routes and GraphQL access checks.\n\n## Available modules for a selected project\n\nThe following project modules are expected under \\`/studio/{projectSlug}\\`:\n\n- \\`/canvas\\` — Visual builder canvas (stored via overlays and canvas versions).\n- \\`/specs\\` — Spec editor (stored as \\`StudioSpec\\`).\n- \\`/deploy\\` — Deployments history + triggers (stored as \\`StudioDeployment\\`).\n- \\`/integrations\\` — Integrations scoped to project (stored as \\`StudioIntegration\\`).\n- \\`/evolution\\` — Evolution sessions (stored as \\`EvolutionSession\\`).\n- \\`/learning\\` — Project learning activity.\n`\n}];\nregisterDocBlocks(tech_studio_project_routing_DocBlocks);\n\n//#endregion\nexport { tech_studio_project_routing_DocBlocks }~~;\n//# sourceMappingURL=project-routing.docblock.js.map~~"],"mappings":";;;AAGA,MAAM,wCAAwC,CAAC;CAC9C,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CN,CAAC;AACF,kBAAkB,sCAAsC"}
1	+ {"version":3,"file":"project-routing.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/studio/project-routing.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/studio/project-routing.docblock.ts\nconst tech_studio_project_routing_DocBlocks = [{\n\tid: \"docs.tech.studio.project-routing\",\n\ttitle: \"Studio Project Routing\",\n\tsummary: \"Studio uses slugged, project-first routes: /studio/{projectSlug}/* with canonical slug redirects and soft-deleted projects hidden.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/studio/project-routing\",\n\ttags: [\n\t\t\"studio\",\n\t\t\"routing\",\n\t\t\"projects\",\n\t\t\"slug\",\n\t\t\"redirects\"\n\t],\n\tbody: `# Studio Project Routing\n\nContractSpec Studio uses a project-first URL scheme:\n\n- \\`/studio/projects\\` — create, select, and delete projects.\n- \\`/studio/{projectSlug}/\\` — project modules (canvas/specs/deploy/integrations/evolution/learning).\n- \\`/studio/learning\\` — learning hub that does not require selecting a project.\n\n## Studio layout shell\n\nStudio routes are wrapped in a dedicated Studio app shell* (header + footer) that provides in-app navigation (Projects/Learning/Teams), organization switching, and account actions.\n\nProject module routes (\\`/studio/{projectSlug}/\\`) render their own module shell (\\`WorkspaceProjectShellLayout\\`). When combined with the global Studio header, the project shell uses a sticky header offset* to avoid overlapping sticky headers.\n\n## Slug behavior (rename-safe)\n\n- Each project has a \\`slug\\` stored in the database (\\`StudioProject.slug\\`).\n- When a project name changes, Studio updates the slug and stores the previous slug as an alias (\\`StudioProjectSlugAlias\\`).\n- Requests to an alias slug are redirected to the canonical slug.\n\nGraphQL entrypoint:\n\n- \\`studioProjectBySlug(slug: String!)\\` returns:\n - \\`project\\`\n - \\`canonicalSlug\\`\n - \\`wasRedirect\\`\n\n## Deletion behavior (soft delete)\n\nProjects are soft-deleted:\n\n- \\`deleteStudioProject(id: String!)\\` sets \\`StudioProject.deletedAt\\`.\n- All listings and access checks filter \\`deletedAt = null\\`.\n- Soft-deleted projects are treated as “not found” in Studio routes and GraphQL access checks.\n\n## Available modules for a selected project\n\nThe following project modules are expected under \\`/studio/{projectSlug}\\`:\n\n- \\`/canvas\\` — Visual builder canvas (stored via overlays and canvas versions).\n- \\`/specs\\` — Spec editor (stored as \\`StudioSpec\\`).\n- \\`/deploy\\` — Deployments history + triggers (stored as \\`StudioDeployment\\`).\n- \\`/integrations\\` — Integrations scoped to project (stored as \\`StudioIntegration\\`).\n- \\`/evolution\\` — Evolution sessions (stored as \\`EvolutionSession\\`).\n- \\`/learning\\` — Project learning activity.\n`\n}];\nregisterDocBlocks(tech_studio_project_routing_DocBlocks);\n\n//#endregion\nexport { tech_studio_project_routing_DocBlocks };"],"mappings":";;;AAGA,MAAM,wCAAwC,CAAC;CAC9C,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CN,CAAC;AACF,kBAAkB,sCAAsC"}

package/dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"sandbox-unlogged.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/studio/sandbox-unlogged.docblock.ts\nconst tech_studio_sandbox_unlogged_DocBlocks = [{\n\tid: \"docs.tech.studio.sandbox.unlogged\",\n\ttitle: \"Sandbox (unlogged) vs Studio (authenticated)\",\n\tsummary: \"The sandbox is a lightweight, unlogged surface that mirrors Studio navigation without auth or analytics.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/studio/sandbox-unlogged\",\n\ttags: [\n\t\t\"studio\",\n\t\t\"sandbox\",\n\t\t\"privacy\",\n\t\t\"analytics\"\n\t],\n\tbody: `## Sandbox guarantees\n\n- Route: \\`/sandbox\\`\n- No auth requirement\n- No PostHog init\n- No Vercel Analytics\n- Local-only state (in-browser runtime + localStorage where needed)\n\n## What Sandbox is for\n\n- Try templates and feature modules safely\n- Preview specs/builder/evolution/learning\n- Produce copyable CLI commands (no side effects)\n\n## What Sandbox is not for\n\n- Persisted projects/workspaces\n- Real deployments\n- Organization-scoped integrations (unless explicitly enabled later)\n`\n}];\nregisterDocBlocks(tech_studio_sandbox_unlogged_DocBlocks);\n\n//#endregion\nexport { tech_studio_sandbox_unlogged_DocBlocks }~~;\n//# sourceMappingURL=sandbox-unlogged.docblock.js.map~~"],"mappings":";;;AAGA,MAAM,yCAAyC,CAAC;CAC/C,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;CAoBN,CAAC;AACF,kBAAkB,uCAAuC"}
1	+ {"version":3,"file":"sandbox-unlogged.docblock.js","names":[],"sources":["../../../../../../../../../libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js"],"sourcesContent":["import { registerDocBlocks } from \"../../registry.js\";\n\n//#region src/docs/tech/studio/sandbox-unlogged.docblock.ts\nconst tech_studio_sandbox_unlogged_DocBlocks = [{\n\tid: \"docs.tech.studio.sandbox.unlogged\",\n\ttitle: \"Sandbox (unlogged) vs Studio (authenticated)\",\n\tsummary: \"The sandbox is a lightweight, unlogged surface that mirrors Studio navigation without auth or analytics.\",\n\tkind: \"reference\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/studio/sandbox-unlogged\",\n\ttags: [\n\t\t\"studio\",\n\t\t\"sandbox\",\n\t\t\"privacy\",\n\t\t\"analytics\"\n\t],\n\tbody: `## Sandbox guarantees\n\n- Route: \\`/sandbox\\`\n- No auth requirement\n- No PostHog init\n- No Vercel Analytics\n- Local-only state (in-browser runtime + localStorage where needed)\n\n## What Sandbox is for\n\n- Try templates and feature modules safely\n- Preview specs/builder/evolution/learning\n- Produce copyable CLI commands (no side effects)\n\n## What Sandbox is not for\n\n- Persisted projects/workspaces\n- Real deployments\n- Organization-scoped integrations (unless explicitly enabled later)\n`\n}];\nregisterDocBlocks(tech_studio_sandbox_unlogged_DocBlocks);\n\n//#endregion\nexport { tech_studio_sandbox_unlogged_DocBlocks };"],"mappings":";;;AAGA,MAAM,yCAAyC,CAAC;CAC/C,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EACL;EACA;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;CAoBN,CAAC;AACF,kBAAkB,uCAAuC"}