@wildo-ai/platform-config-lib 1.1.1 → 1.1.3
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.
- package/dist/esm/bootstrap/bootstrap.schemas.d.ts +67 -1
- package/dist/esm/bootstrap/bootstrap.schemas.d.ts.map +1 -1
- package/dist/esm/bootstrap/bootstrap.schemas.js +51 -2
- package/dist/esm/bootstrap/bootstrap.schemas.js.map +1 -1
- package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts +2 -3
- package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts.map +1 -1
- package/dist/esm/bootstrap/platform-runtime-env.contracts.js +2 -3
- package/dist/esm/bootstrap/platform-runtime-env.contracts.js.map +1 -1
- package/dist/esm/bootstrap/runtime-network-topology.d.ts +0 -1
- package/dist/esm/bootstrap/runtime-network-topology.d.ts.map +1 -1
- package/dist/esm/bootstrap/runtime-network-topology.js +0 -2
- package/dist/esm/bootstrap/runtime-network-topology.js.map +1 -1
- package/dist/esm/bootstrap/wildo-owner-organization.contracts.d.ts +52 -0
- package/dist/esm/bootstrap/wildo-owner-organization.contracts.d.ts.map +1 -0
- package/dist/esm/bootstrap/wildo-owner-organization.contracts.js +5 -0
- package/dist/esm/bootstrap/wildo-owner-organization.contracts.js.map +1 -0
- package/dist/esm/config-authoring.entry.d.ts +1 -2
- package/dist/esm/config-authoring.entry.d.ts.map +1 -1
- package/dist/esm/config-authoring.entry.js +35 -2
- package/dist/esm/config-authoring.entry.js.map +1 -1
- package/dist/esm/index.d.ts +1 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +1 -0
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts +0 -20
- package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts.map +1 -1
- package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js +0 -1
- package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js.map +1 -1
- package/dist/esm/project-config/define-framework-config.d.ts +4 -4
- package/dist/esm/project-config/define-infra-env-config.d.ts +3 -39
- package/dist/esm/project-config/define-infra-env-config.d.ts.map +1 -1
- package/dist/esm/project-config/define-infra-env-config.js +2 -2
- package/dist/esm/project-config/define-infra-env-config.js.map +1 -1
- package/dist/esm/project-config/define-saas-config.d.ts +378 -14
- package/dist/esm/project-config/define-saas-config.d.ts.map +1 -1
- package/dist/esm/project-config/define-saas-config.js +122 -11
- package/dist/esm/project-config/define-saas-config.js.map +1 -1
- package/dist/esm/project-config/provider-companion-discovery.d.ts +74 -1
- package/dist/esm/project-config/provider-companion-discovery.d.ts.map +1 -1
- package/dist/esm/project-config/provider-companion-discovery.js +203 -6
- package/dist/esm/project-config/provider-companion-discovery.js.map +1 -1
- package/dist/esm/project-config/provider-runtime-artifacts.d.ts +42 -16
- package/dist/esm/project-config/provider-runtime-artifacts.d.ts.map +1 -1
- package/dist/esm/project-config/provider-runtime-artifacts.js +75 -6
- package/dist/esm/project-config/provider-runtime-artifacts.js.map +1 -1
- package/dist/esm/project-config/shared/backing-services.schemas.d.ts +7 -43
- package/dist/esm/project-config/shared/backing-services.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/backing-services.schemas.js +13 -30
- package/dist/esm/project-config/shared/backing-services.schemas.js.map +1 -1
- package/dist/esm/project-config/shared/csp-emit.d.ts +36 -5
- package/dist/esm/project-config/shared/csp-emit.d.ts.map +1 -1
- package/dist/esm/project-config/shared/csp-emit.js +65 -5
- package/dist/esm/project-config/shared/csp-emit.js.map +1 -1
- package/dist/esm/project-config/shared/csp.schemas.d.ts +46 -10
- package/dist/esm/project-config/shared/csp.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/csp.schemas.js +45 -10
- package/dist/esm/project-config/shared/csp.schemas.js.map +1 -1
- package/dist/esm/project-config/shared/environment.schemas.d.ts +8 -6
- package/dist/esm/project-config/shared/environment.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/environment.schemas.js +7 -5
- package/dist/esm/project-config/shared/environment.schemas.js.map +1 -1
- package/dist/esm/project-config/shared/infra-providers.schemas.d.ts +18 -3
- package/dist/esm/project-config/shared/infra-providers.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/infra-providers.schemas.js +34 -2
- package/dist/esm/project-config/shared/infra-providers.schemas.js.map +1 -1
- package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts +0 -2
- package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js +0 -2
- package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js.map +1 -1
- package/dist/esm/project-config/shared/k8s-utils.d.ts +70 -10
- package/dist/esm/project-config/shared/k8s-utils.d.ts.map +1 -1
- package/dist/esm/project-config/shared/k8s-utils.js +75 -11
- package/dist/esm/project-config/shared/k8s-utils.js.map +1 -1
- package/dist/esm/project-config/shared/minion-platform-access.vocabulary.d.ts +15 -15
- package/dist/esm/project-config/shared/minion-platform-access.vocabulary.js +15 -15
- package/dist/esm/project-config/shared/minion-platform-access.vocabulary.js.map +1 -1
- package/dist/esm/project-config/shared/platform-services.schemas.d.ts +30 -0
- package/dist/esm/project-config/shared/platform-services.schemas.d.ts.map +1 -1
- package/dist/esm/project-config/shared/platform-services.schemas.js +31 -0
- package/dist/esm/project-config/shared/platform-services.schemas.js.map +1 -1
- package/dist/esm/release/framework-release.constants.d.ts +24 -19
- package/dist/esm/release/framework-release.constants.d.ts.map +1 -1
- package/dist/esm/release/framework-release.constants.js +24 -19
- package/dist/esm/release/framework-release.constants.js.map +1 -1
- package/dist/esm/workspace-scope/workspace-homes.schemas.d.ts +14 -0
- package/dist/esm/workspace-scope/workspace-homes.schemas.d.ts.map +1 -1
- package/dist/esm/workspace-scope/workspace-homes.schemas.js +2 -0
- package/dist/esm/workspace-scope/workspace-homes.schemas.js.map +1 -1
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +7 -7
- package/dist/esm/.builder.pid +0 -9
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"workspace-homes.schemas.js","sourceRoot":"","sources":["../../../../src/workspace-scope/workspace-homes.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { homedir } from 'os';\nimport { join } from 'path';\nimport type { WorkspaceScopeResult } from './workspace-scope.schemas';\nimport {\n AUTHORED_CONFIG_FILE_NAMES,\n APP_CONTINUITY_FILE_NAMES,\n APP_RUNTIME_SUBDIR_NAMES,\n MACHINE_HOME_NAMES,\n WORKSPACE_HOME_NAMES,\n WorkspaceScope,\n} from './workspace-scope.schemas';\n\nexport interface MachineLayoutPaths {\n home: string;\n preferencesPath: string;\n /** Machine-local root for all continuity authority domains and subjects. */\n continuityHome: string;\n /**\n * Machine-local authority-domain manifest.\n *\n * The manifest identifies a storage/writer namespace. It is deliberately\n * outside every subject directory because one local authority domain may\n * own several application subjects.\n */\n continuityAuthorityDomainManifestPath: string;\n /** Root containing `domains/<authority-domain-id>/subjects/...`. */\n continuityDomainsHome: string;\n}\n\nexport interface FrameworkLayoutPaths {\n repositoryRoot: string;\n rootPackageJsonPath: string;\n pnpmLockfilePath: string;\n engineHome: string;\n platformHome: string;\n examplesHome: string;\n markerHome: string;\n declarationConfigPath: string;\n templatesHome: string;\n infraTemplatesHome: string;\n dockerComposeTemplatesHome: string;\n ciTemplatesHome: string;\n k8sTemplatesHome: string;\n dockerImagesTemplatesHome: string;\n platformBaseDockerfilePath: string;\n backendBaseDockerfilePath: string;\n backendJavaDockerfilePath: string;\n docsHome: string;\n frameworkKnowledgePackageHome: string;\n frameworkKnowledgeSourceHome: string;\n /**\n * Home of **authored** skill folders (`src/skills/<skill_id>/SKILL.md` + supporting\n * markdown). Distinct from {@link frameworkKnowledgeSkillsHome}, which is the\n * **materialized** output home under `dist/knowledge/skills/`. Keeping the two\n * names clearly separated prevents accidental conflation between authored\n * source and generated artifact.\n */\n frameworkKnowledgeAuthoredSkillsHome: string;\n /**\n * Home of **authored** playbook folders\n * (`src/playbooks/<ref>/playbook.json` + `method.md`). Playbooks are the\n * meta-workflow artifact kind (app-creation methodology definitions) — a\n * distinct compilation lane from skills, so they get their own authored\n * home instead of polluting the skills router. Mirrors the\n * authored-vs-materialized split of\n * {@link frameworkKnowledgeAuthoredSkillsHome} /\n * {@link frameworkKnowledgeSkillsHome}.\n */\n frameworkKnowledgeAuthoredPlaybooksHome: string;\n /**\n * Home of **authored** always-on rules (`src/rules/*.md`).\n *\n * A rule is policy an application's coding agent should have at its elbow WITHOUT routing to a\n * skill first — the distinction the skills router cannot express, because a router match requires\n * the agent to already suspect the topic. Authored-vs-materialized split as above:\n * {@link frameworkKnowledgeRulesHome} is the compiled output.\n */\n frameworkKnowledgeAuthoredRulesHome: string;\n frameworkKnowledgeOutputHome: string;\n frameworkKnowledgeReferencesHome: string;\n frameworkKnowledgeSkillsHome: string;\n frameworkKnowledgeRegistriesHome: string;\n /** Materialized playbook output home under `dist/knowledge/playbooks/`. */\n frameworkKnowledgePlaybooksHome: string;\n /** Materialized rule output home under `dist/knowledge/rules/`. */\n frameworkKnowledgeRulesHome: string;\n releaseHome: string;\n releaseDistHome: string;\n releasePublishHome: string;\n releaseSecretsHome: string;\n releaseSecretsPath: string;\n npmPublishManifestsHome: string;\n configLoaderArtifactsHome: string;\n}\n\nexport interface AppLayoutPaths {\n declarationRoot: string;\n declarationConfigPath: string;\n authoredInfrastructureHome: string;\n runtimeHome: string;\n /** Tracked portable identity/bootstrap inputs for local continuity. */\n continuityHome: string;\n applicationSubjectManifestPath: string;\n applicationContinuityBootstrapProfilePath: string;\n distHome: string;\n /** Generated application-specification runtime outputs. */\n applicationSpecificationsDistHome: string;\n applicationSpecificationProjectionsHome: string;\n stateHome: string;\n /** Disposable application-owned workspaces; never application truth. */\n temporaryHome: string;\n integrationTestsTemporaryHome: string;\n logsHome: string;\n companionLogsHome: string;\n localDataHome: string;\n runtimeInfrastructureHome: string;\n runtimeEnvironmentsHome: string;\n /**\n * Root of the env-scoped deployment-artifact staging area\n * (`.wildo-saas/deploy/`). Per-env renders live at `<home>/<envName>/`.\n * Always secret-bearing — see {@link APP_RUNTIME_SUBDIR_NAMES.DEPLOY}.\n */\n deployArtifactsHome: string;\n frameworkScriptsHome: string;\n runtimeSignalsHome: string;\n companionHome: string;\n preferencesOverlayPath: string;\n configLoaderArtifactsHome: string;\n}\n\nexport interface ResolvedMachineHomes {\n layout: MachineLayoutPaths;\n hasPreferencesFile: boolean;\n}\n\nexport interface ResolvedFrameworkHomes {\n repositoryRoot: string | null;\n markerHome: string | null;\n declarationConfigPath: string | null;\n layout: FrameworkLayoutPaths | null;\n /**\n * True ONLY when the caller's `cwd` sits inside a framework workspace that\n * was discovered by walking up for `wildo-framework.info.json`. A framework\n * root derived from `frameworkPathHint` (machine preferences) populates\n * `repositoryRoot` and `layout`, but leaves this flag `false` because the\n * caller is NOT operating from inside the framework repo — they merely have\n * a pointer to it. Consumers that need \"am I currently developing the\n * framework?\" must read this field; consumers that need \"can I read\n * framework-owned assets from here?\" must read\n * `ResolvedHomeCapabilities.canUseFrameworkAssets`.\n */\n isInFrameworkWorkspace: boolean;\n}\n\nexport interface ResolvedAppHomes {\n declarationRoot: string | null;\n runtimeHome: string | null;\n saasConfigPath: string | null;\n layout: AppLayoutPaths | null;\n isInAppWorkspace: boolean;\n}\n\n/**\n * Pre-computed, semantic booleans that gate downstream CLI / companion /\n * runtime behavior based on the resolved-homes snapshot.\n *\n * Each flag is intentionally separate because they answer different questions\n * — merging any two of them (\"are we in a framework workspace?\" vs \"can we\n * reach framework assets?\") would silently reintroduce the Phase 5\n * env-vs-context confusion we explicitly killed:\n *\n * - `hasMachinePreferences` — A `preferences.json` file exists under the\n * machine Wildo home. `canUseFrameworkAssets` can be true without this\n * flag being true (e.g. the preferences hint was seeded in a session that\n * never persisted), and vice versa.\n * - `hasFrameworkWorkspace` — The caller's `cwd` is inside a framework\n * workspace (walk-up found `wildo-framework.info.json`). Equivalent to\n * `framework.isInFrameworkWorkspace`; duplicated here so capability checks\n * are one-stop-shop without having to reach into the nested roots.\n * - `hasAppWorkspace` — The caller's `cwd` is inside a SaaS app workspace\n * (walk-up found `wildo.saas.config.ts`). Equivalent to\n * `app.isInAppWorkspace`.\n * - `hasFrameworkDeveloperCapabilities` — Either the operator is actually\n * sitting inside the framework workspace (`hasFrameworkWorkspace`) OR the\n * `isFrameworkDeveloperHint` from preferences is true. This is metadata\n * used by commands that surface framework-dev-only tooling — it never\n * participates in path resolution.\n * - `canUseFrameworkAssets` — The resolved snapshot has a usable framework\n * `repositoryRoot` (either because the caller is inside one, or because a\n * validated hint pointed at one). This is the flag used by consumers that\n * need to READ framework-owned paths (scripts, shared dist, etc.) — it is\n * intentionally broader than `hasFrameworkWorkspace` so that apps can\n * reach framework assets without the caller pretending to be \"in\" the\n * framework workspace.\n * - `canUseAppRuntimeHome` — The resolved snapshot has a usable\n * `.wildo-saas/` runtime home. Required by anything that writes runtime\n * signals, caches, generated files, etc.\n */\nexport interface ResolvedHomeCapabilities {\n hasMachinePreferences: boolean;\n hasFrameworkWorkspace: boolean;\n hasAppWorkspace: boolean;\n hasFrameworkDeveloperCapabilities: boolean;\n canUseFrameworkAssets: boolean;\n canUseAppRuntimeHome: boolean;\n}\n\nexport interface ResolvedHomes {\n workspaceScope: WorkspaceScopeResult;\n scope: WorkspaceScope;\n machine: ResolvedMachineHomes;\n framework: ResolvedFrameworkHomes;\n app: ResolvedAppHomes;\n capabilities: ResolvedHomeCapabilities;\n}\n\n/**\n * Build the machine-global Wildo home layout under the current user's home.\n */\nexport function resolveMachineLayout(userHome: string = homedir()): MachineLayoutPaths {\n const home = join(userHome, MACHINE_HOME_NAMES.MACHINE_HOME);\n const continuityHome = join(home, 'continuity');\n return {\n home,\n preferencesPath: join(home, AUTHORED_CONFIG_FILE_NAMES.PREFERENCES),\n continuityHome,\n continuityAuthorityDomainManifestPath: join(\n continuityHome,\n 'authority-domain.json',\n ),\n continuityDomainsHome: join(continuityHome, 'domains'),\n };\n}\n\n/**\n * Build the framework-owned homes and asset roots for a framework repository.\n */\nexport function resolveFrameworkLayout(frameworkRoot: string): FrameworkLayoutPaths {\n const markerHome = join(frameworkRoot, WORKSPACE_HOME_NAMES.FRAMEWORK_HOME);\n const engineHome = join(frameworkRoot, 'engine');\n const platformHome = join(frameworkRoot, 'platform');\n const examplesHome = join(frameworkRoot, 'examples');\n const templatesHome = join(frameworkRoot, 'templates');\n const infraTemplatesHome = join(templatesHome, 'infra');\n const dockerImagesTemplatesHome = join(infraTemplatesHome, 'docker-images');\n const backendDockerImagesHome = join(dockerImagesTemplatesHome, 'backend');\n const frameworkKnowledgePackageHome = join(platformHome, 'factory', 'framework-knowledge');\n const frameworkKnowledgeSourceHome = join(frameworkKnowledgePackageHome, 'src');\n const frameworkKnowledgeOutputHome = join(frameworkKnowledgePackageHome, 'dist', 'knowledge');\n const releaseDistHome = join(markerHome, APP_RUNTIME_SUBDIR_NAMES.DIST);\n const releasePublishHome = join(releaseDistHome, 'publish');\n const releaseSecretsHome = join(markerHome, 'framework-secrets');\n return {\n repositoryRoot: frameworkRoot,\n rootPackageJsonPath: join(frameworkRoot, 'package.json'),\n pnpmLockfilePath: join(frameworkRoot, 'pnpm-lock.yaml'),\n engineHome,\n platformHome,\n examplesHome,\n markerHome,\n declarationConfigPath: join(markerHome, AUTHORED_CONFIG_FILE_NAMES.FRAMEWORK),\n templatesHome,\n infraTemplatesHome,\n dockerComposeTemplatesHome: join(infraTemplatesHome, 'docker-compose'),\n ciTemplatesHome: join(infraTemplatesHome, 'ci'),\n k8sTemplatesHome: join(infraTemplatesHome, 'k8s'),\n dockerImagesTemplatesHome,\n platformBaseDockerfilePath: join(\n dockerImagesTemplatesHome,\n 'platform',\n 'Dockerfile.platform-base',\n ),\n backendBaseDockerfilePath: join(\n backendDockerImagesHome,\n 'Dockerfile.backend-base',\n ),\n backendJavaDockerfilePath: join(\n backendDockerImagesHome,\n 'Dockerfile.backend-base-java',\n ),\n docsHome: join(frameworkRoot, 'docs'),\n frameworkKnowledgePackageHome,\n frameworkKnowledgeSourceHome,\n frameworkKnowledgeAuthoredSkillsHome: join(frameworkKnowledgeSourceHome, 'skills'),\n frameworkKnowledgeAuthoredPlaybooksHome: join(frameworkKnowledgeSourceHome, 'playbooks'),\n frameworkKnowledgeAuthoredRulesHome: join(frameworkKnowledgeSourceHome, 'rules'),\n frameworkKnowledgeOutputHome,\n frameworkKnowledgeReferencesHome: join(frameworkKnowledgeOutputHome, 'references'),\n frameworkKnowledgeSkillsHome: join(frameworkKnowledgeOutputHome, 'skills'),\n frameworkKnowledgeRegistriesHome: join(frameworkKnowledgeOutputHome, 'registries'),\n frameworkKnowledgePlaybooksHome: join(frameworkKnowledgeOutputHome, 'playbooks'),\n frameworkKnowledgeRulesHome: join(frameworkKnowledgeOutputHome, 'rules'),\n releaseHome: markerHome,\n releaseDistHome,\n releasePublishHome,\n releaseSecretsHome,\n releaseSecretsPath: join(releaseSecretsHome, 'secrets.json'),\n npmPublishManifestsHome: join(releasePublishHome, 'npm-manifests'),\n configLoaderArtifactsHome: join(\n markerHome,\n APP_RUNTIME_SUBDIR_NAMES.DIST,\n APP_RUNTIME_SUBDIR_NAMES.CONFIG_LOADER,\n 'framework',\n ),\n };\n}\n\n/**\n * Build the app declaration-root and runtime-home layout for a SaaS app.\n */\nexport function resolveAppLayout(appRoot: string): AppLayoutPaths {\n const runtimeHome = join(appRoot, WORKSPACE_HOME_NAMES.APP_RUNTIME_HOME);\n const continuityHome = join(\n runtimeHome,\n APP_RUNTIME_SUBDIR_NAMES.CONTINUITY,\n );\n const distHome = join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.DIST);\n const applicationSpecificationsDistHome = join(\n distHome,\n APP_RUNTIME_SUBDIR_NAMES.APPLICATION_SPECIFICATIONS,\n );\n const temporaryHome = join(\n runtimeHome,\n APP_RUNTIME_SUBDIR_NAMES.TEMPORARY,\n );\n const runtimeInfrastructureHome = join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.INFRASTRUCTURE);\n const logsHome = join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.LOGS);\n return {\n declarationRoot: appRoot,\n declarationConfigPath: join(appRoot, AUTHORED_CONFIG_FILE_NAMES.SAAS),\n authoredInfrastructureHome: join(appRoot, APP_RUNTIME_SUBDIR_NAMES.INFRASTRUCTURE),\n runtimeHome,\n continuityHome,\n applicationSubjectManifestPath: join(\n continuityHome,\n APP_CONTINUITY_FILE_NAMES.APPLICATION_SUBJECT_MANIFEST,\n ),\n applicationContinuityBootstrapProfilePath: join(\n continuityHome,\n APP_CONTINUITY_FILE_NAMES.BOOTSTRAP_PROFILE,\n ),\n distHome,\n applicationSpecificationsDistHome,\n applicationSpecificationProjectionsHome: join(\n applicationSpecificationsDistHome,\n APP_RUNTIME_SUBDIR_NAMES.PROJECTIONS,\n ),\n stateHome: join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.STATE),\n temporaryHome,\n integrationTestsTemporaryHome: join(\n temporaryHome,\n APP_RUNTIME_SUBDIR_NAMES.INTEGRATION_TESTS,\n ),\n logsHome,\n companionLogsHome: join(logsHome, 'dev-companion'),\n localDataHome: join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.LOCAL_DATA),\n runtimeInfrastructureHome,\n runtimeEnvironmentsHome: join(runtimeInfrastructureHome, APP_RUNTIME_SUBDIR_NAMES.ENVIRONMENTS),\n deployArtifactsHome: join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.DEPLOY),\n frameworkScriptsHome: join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.FRAMEWORK_SCRIPTS),\n runtimeSignalsHome: join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.RUNTIME_SIGNALS),\n companionHome: join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.COMPANION),\n preferencesOverlayPath: join(runtimeHome, AUTHORED_CONFIG_FILE_NAMES.APP_LOCAL_PREFERENCES),\n configLoaderArtifactsHome: join(\n distHome,\n APP_RUNTIME_SUBDIR_NAMES.CONFIG_LOADER,\n 'saas',\n ),\n };\n}\n"]}
|
|
1
|
+
{"version":3,"file":"workspace-homes.schemas.js","sourceRoot":"","sources":["../../../../src/workspace-scope/workspace-homes.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { homedir } from 'os';\nimport { join } from 'path';\nimport type { WorkspaceScopeResult } from './workspace-scope.schemas';\nimport {\n AUTHORED_CONFIG_FILE_NAMES,\n APP_CONTINUITY_FILE_NAMES,\n APP_RUNTIME_SUBDIR_NAMES,\n MACHINE_HOME_NAMES,\n WORKSPACE_HOME_NAMES,\n WorkspaceScope,\n} from './workspace-scope.schemas';\n\nexport interface MachineLayoutPaths {\n home: string;\n preferencesPath: string;\n /** Machine-local root for all continuity authority domains and subjects. */\n continuityHome: string;\n /**\n * Machine-local authority-domain manifest.\n *\n * The manifest identifies a storage/writer namespace. It is deliberately\n * outside every subject directory because one local authority domain may\n * own several application subjects.\n */\n continuityAuthorityDomainManifestPath: string;\n /** Root containing `domains/<authority-domain-id>/subjects/...`. */\n continuityDomainsHome: string;\n}\n\nexport interface FrameworkLayoutPaths {\n repositoryRoot: string;\n rootPackageJsonPath: string;\n pnpmLockfilePath: string;\n engineHome: string;\n platformHome: string;\n /**\n * The THIRD workspace home (plan D9): one package per provider, several facet barrels each,\n * deliberately OUTSIDE `engine/` so that \"out of the core engine\" is a directory rather than a\n * convention. Named for the HOME, never for a package in it — which provider inhabits it first is\n * a decision of the slice that generates providers, not of the layout.\n *\n * It is a field here because this interface is what makes a home VISIBLE to tooling: publish\n * discovery, framework-knowledge generation and the anchor audit all take their scan roots from\n * `engineHome` + `platformHome`, and a home absent from that pair is not excluded — it is\n * unseen. An unseen home reports clean, which is the shape\n * `negative-results-require-a-positive-probe.md` exists for: a `@wildo_source` anchor in a\n * provider package would never reach a skill, and nothing would say so.\n */\n providersHome: string;\n examplesHome: string;\n markerHome: string;\n declarationConfigPath: string;\n templatesHome: string;\n infraTemplatesHome: string;\n dockerComposeTemplatesHome: string;\n ciTemplatesHome: string;\n k8sTemplatesHome: string;\n dockerImagesTemplatesHome: string;\n platformBaseDockerfilePath: string;\n backendBaseDockerfilePath: string;\n backendJavaDockerfilePath: string;\n docsHome: string;\n frameworkKnowledgePackageHome: string;\n frameworkKnowledgeSourceHome: string;\n /**\n * Home of **authored** skill folders (`src/skills/<skill_id>/SKILL.md` + supporting\n * markdown). Distinct from {@link frameworkKnowledgeSkillsHome}, which is the\n * **materialized** output home under `dist/knowledge/skills/`. Keeping the two\n * names clearly separated prevents accidental conflation between authored\n * source and generated artifact.\n */\n frameworkKnowledgeAuthoredSkillsHome: string;\n /**\n * Home of **authored** playbook folders\n * (`src/playbooks/<ref>/playbook.json` + `method.md`). Playbooks are the\n * meta-workflow artifact kind (app-creation methodology definitions) — a\n * distinct compilation lane from skills, so they get their own authored\n * home instead of polluting the skills router. Mirrors the\n * authored-vs-materialized split of\n * {@link frameworkKnowledgeAuthoredSkillsHome} /\n * {@link frameworkKnowledgeSkillsHome}.\n */\n frameworkKnowledgeAuthoredPlaybooksHome: string;\n /**\n * Home of **authored** always-on rules (`src/rules/*.md`).\n *\n * A rule is policy an application's coding agent should have at its elbow WITHOUT routing to a\n * skill first — the distinction the skills router cannot express, because a router match requires\n * the agent to already suspect the topic. Authored-vs-materialized split as above:\n * {@link frameworkKnowledgeRulesHome} is the compiled output.\n */\n frameworkKnowledgeAuthoredRulesHome: string;\n frameworkKnowledgeOutputHome: string;\n frameworkKnowledgeReferencesHome: string;\n frameworkKnowledgeSkillsHome: string;\n frameworkKnowledgeRegistriesHome: string;\n /** Materialized playbook output home under `dist/knowledge/playbooks/`. */\n frameworkKnowledgePlaybooksHome: string;\n /** Materialized rule output home under `dist/knowledge/rules/`. */\n frameworkKnowledgeRulesHome: string;\n releaseHome: string;\n releaseDistHome: string;\n releasePublishHome: string;\n releaseSecretsHome: string;\n releaseSecretsPath: string;\n npmPublishManifestsHome: string;\n configLoaderArtifactsHome: string;\n}\n\nexport interface AppLayoutPaths {\n declarationRoot: string;\n declarationConfigPath: string;\n authoredInfrastructureHome: string;\n runtimeHome: string;\n /** Tracked portable identity/bootstrap inputs for local continuity. */\n continuityHome: string;\n applicationSubjectManifestPath: string;\n applicationContinuityBootstrapProfilePath: string;\n distHome: string;\n /** Generated application-specification runtime outputs. */\n applicationSpecificationsDistHome: string;\n applicationSpecificationProjectionsHome: string;\n stateHome: string;\n /** Disposable application-owned workspaces; never application truth. */\n temporaryHome: string;\n integrationTestsTemporaryHome: string;\n logsHome: string;\n companionLogsHome: string;\n localDataHome: string;\n runtimeInfrastructureHome: string;\n runtimeEnvironmentsHome: string;\n /**\n * Root of the env-scoped deployment-artifact staging area\n * (`.wildo-saas/deploy/`). Per-env renders live at `<home>/<envName>/`.\n * Always secret-bearing — see {@link APP_RUNTIME_SUBDIR_NAMES.DEPLOY}.\n */\n deployArtifactsHome: string;\n frameworkScriptsHome: string;\n runtimeSignalsHome: string;\n companionHome: string;\n preferencesOverlayPath: string;\n configLoaderArtifactsHome: string;\n}\n\nexport interface ResolvedMachineHomes {\n layout: MachineLayoutPaths;\n hasPreferencesFile: boolean;\n}\n\nexport interface ResolvedFrameworkHomes {\n repositoryRoot: string | null;\n markerHome: string | null;\n declarationConfigPath: string | null;\n layout: FrameworkLayoutPaths | null;\n /**\n * True ONLY when the caller's `cwd` sits inside a framework workspace that\n * was discovered by walking up for `wildo-framework.info.json`. A framework\n * root derived from `frameworkPathHint` (machine preferences) populates\n * `repositoryRoot` and `layout`, but leaves this flag `false` because the\n * caller is NOT operating from inside the framework repo — they merely have\n * a pointer to it. Consumers that need \"am I currently developing the\n * framework?\" must read this field; consumers that need \"can I read\n * framework-owned assets from here?\" must read\n * `ResolvedHomeCapabilities.canUseFrameworkAssets`.\n */\n isInFrameworkWorkspace: boolean;\n}\n\nexport interface ResolvedAppHomes {\n declarationRoot: string | null;\n runtimeHome: string | null;\n saasConfigPath: string | null;\n layout: AppLayoutPaths | null;\n isInAppWorkspace: boolean;\n}\n\n/**\n * Pre-computed, semantic booleans that gate downstream CLI / companion /\n * runtime behavior based on the resolved-homes snapshot.\n *\n * Each flag is intentionally separate because they answer different questions\n * — merging any two of them (\"are we in a framework workspace?\" vs \"can we\n * reach framework assets?\") would silently reintroduce the Phase 5\n * env-vs-context confusion we explicitly killed:\n *\n * - `hasMachinePreferences` — A `preferences.json` file exists under the\n * machine Wildo home. `canUseFrameworkAssets` can be true without this\n * flag being true (e.g. the preferences hint was seeded in a session that\n * never persisted), and vice versa.\n * - `hasFrameworkWorkspace` — The caller's `cwd` is inside a framework\n * workspace (walk-up found `wildo-framework.info.json`). Equivalent to\n * `framework.isInFrameworkWorkspace`; duplicated here so capability checks\n * are one-stop-shop without having to reach into the nested roots.\n * - `hasAppWorkspace` — The caller's `cwd` is inside a SaaS app workspace\n * (walk-up found `wildo.saas.config.ts`). Equivalent to\n * `app.isInAppWorkspace`.\n * - `hasFrameworkDeveloperCapabilities` — Either the operator is actually\n * sitting inside the framework workspace (`hasFrameworkWorkspace`) OR the\n * `isFrameworkDeveloperHint` from preferences is true. This is metadata\n * used by commands that surface framework-dev-only tooling — it never\n * participates in path resolution.\n * - `canUseFrameworkAssets` — The resolved snapshot has a usable framework\n * `repositoryRoot` (either because the caller is inside one, or because a\n * validated hint pointed at one). This is the flag used by consumers that\n * need to READ framework-owned paths (scripts, shared dist, etc.) — it is\n * intentionally broader than `hasFrameworkWorkspace` so that apps can\n * reach framework assets without the caller pretending to be \"in\" the\n * framework workspace.\n * - `canUseAppRuntimeHome` — The resolved snapshot has a usable\n * `.wildo-saas/` runtime home. Required by anything that writes runtime\n * signals, caches, generated files, etc.\n */\nexport interface ResolvedHomeCapabilities {\n hasMachinePreferences: boolean;\n hasFrameworkWorkspace: boolean;\n hasAppWorkspace: boolean;\n hasFrameworkDeveloperCapabilities: boolean;\n canUseFrameworkAssets: boolean;\n canUseAppRuntimeHome: boolean;\n}\n\nexport interface ResolvedHomes {\n workspaceScope: WorkspaceScopeResult;\n scope: WorkspaceScope;\n machine: ResolvedMachineHomes;\n framework: ResolvedFrameworkHomes;\n app: ResolvedAppHomes;\n capabilities: ResolvedHomeCapabilities;\n}\n\n/**\n * Build the machine-global Wildo home layout under the current user's home.\n */\nexport function resolveMachineLayout(userHome: string = homedir()): MachineLayoutPaths {\n const home = join(userHome, MACHINE_HOME_NAMES.MACHINE_HOME);\n const continuityHome = join(home, 'continuity');\n return {\n home,\n preferencesPath: join(home, AUTHORED_CONFIG_FILE_NAMES.PREFERENCES),\n continuityHome,\n continuityAuthorityDomainManifestPath: join(\n continuityHome,\n 'authority-domain.json',\n ),\n continuityDomainsHome: join(continuityHome, 'domains'),\n };\n}\n\n/**\n * Build the framework-owned homes and asset roots for a framework repository.\n */\nexport function resolveFrameworkLayout(frameworkRoot: string): FrameworkLayoutPaths {\n const markerHome = join(frameworkRoot, WORKSPACE_HOME_NAMES.FRAMEWORK_HOME);\n const engineHome = join(frameworkRoot, 'engine');\n const platformHome = join(frameworkRoot, 'platform');\n const providersHome = join(frameworkRoot, 'providers');\n const examplesHome = join(frameworkRoot, 'examples');\n const templatesHome = join(frameworkRoot, 'templates');\n const infraTemplatesHome = join(templatesHome, 'infra');\n const dockerImagesTemplatesHome = join(infraTemplatesHome, 'docker-images');\n const backendDockerImagesHome = join(dockerImagesTemplatesHome, 'backend');\n const frameworkKnowledgePackageHome = join(platformHome, 'factory', 'framework-knowledge');\n const frameworkKnowledgeSourceHome = join(frameworkKnowledgePackageHome, 'src');\n const frameworkKnowledgeOutputHome = join(frameworkKnowledgePackageHome, 'dist', 'knowledge');\n const releaseDistHome = join(markerHome, APP_RUNTIME_SUBDIR_NAMES.DIST);\n const releasePublishHome = join(releaseDistHome, 'publish');\n const releaseSecretsHome = join(markerHome, 'framework-secrets');\n return {\n repositoryRoot: frameworkRoot,\n rootPackageJsonPath: join(frameworkRoot, 'package.json'),\n pnpmLockfilePath: join(frameworkRoot, 'pnpm-lock.yaml'),\n engineHome,\n platformHome,\n providersHome,\n examplesHome,\n markerHome,\n declarationConfigPath: join(markerHome, AUTHORED_CONFIG_FILE_NAMES.FRAMEWORK),\n templatesHome,\n infraTemplatesHome,\n dockerComposeTemplatesHome: join(infraTemplatesHome, 'docker-compose'),\n ciTemplatesHome: join(infraTemplatesHome, 'ci'),\n k8sTemplatesHome: join(infraTemplatesHome, 'k8s'),\n dockerImagesTemplatesHome,\n platformBaseDockerfilePath: join(\n dockerImagesTemplatesHome,\n 'platform',\n 'Dockerfile.platform-base',\n ),\n backendBaseDockerfilePath: join(\n backendDockerImagesHome,\n 'Dockerfile.backend-base',\n ),\n backendJavaDockerfilePath: join(\n backendDockerImagesHome,\n 'Dockerfile.backend-base-java',\n ),\n docsHome: join(frameworkRoot, 'docs'),\n frameworkKnowledgePackageHome,\n frameworkKnowledgeSourceHome,\n frameworkKnowledgeAuthoredSkillsHome: join(frameworkKnowledgeSourceHome, 'skills'),\n frameworkKnowledgeAuthoredPlaybooksHome: join(frameworkKnowledgeSourceHome, 'playbooks'),\n frameworkKnowledgeAuthoredRulesHome: join(frameworkKnowledgeSourceHome, 'rules'),\n frameworkKnowledgeOutputHome,\n frameworkKnowledgeReferencesHome: join(frameworkKnowledgeOutputHome, 'references'),\n frameworkKnowledgeSkillsHome: join(frameworkKnowledgeOutputHome, 'skills'),\n frameworkKnowledgeRegistriesHome: join(frameworkKnowledgeOutputHome, 'registries'),\n frameworkKnowledgePlaybooksHome: join(frameworkKnowledgeOutputHome, 'playbooks'),\n frameworkKnowledgeRulesHome: join(frameworkKnowledgeOutputHome, 'rules'),\n releaseHome: markerHome,\n releaseDistHome,\n releasePublishHome,\n releaseSecretsHome,\n releaseSecretsPath: join(releaseSecretsHome, 'secrets.json'),\n npmPublishManifestsHome: join(releasePublishHome, 'npm-manifests'),\n configLoaderArtifactsHome: join(\n markerHome,\n APP_RUNTIME_SUBDIR_NAMES.DIST,\n APP_RUNTIME_SUBDIR_NAMES.CONFIG_LOADER,\n 'framework',\n ),\n };\n}\n\n/**\n * Build the app declaration-root and runtime-home layout for a SaaS app.\n */\nexport function resolveAppLayout(appRoot: string): AppLayoutPaths {\n const runtimeHome = join(appRoot, WORKSPACE_HOME_NAMES.APP_RUNTIME_HOME);\n const continuityHome = join(\n runtimeHome,\n APP_RUNTIME_SUBDIR_NAMES.CONTINUITY,\n );\n const distHome = join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.DIST);\n const applicationSpecificationsDistHome = join(\n distHome,\n APP_RUNTIME_SUBDIR_NAMES.APPLICATION_SPECIFICATIONS,\n );\n const temporaryHome = join(\n runtimeHome,\n APP_RUNTIME_SUBDIR_NAMES.TEMPORARY,\n );\n const runtimeInfrastructureHome = join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.INFRASTRUCTURE);\n const logsHome = join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.LOGS);\n return {\n declarationRoot: appRoot,\n declarationConfigPath: join(appRoot, AUTHORED_CONFIG_FILE_NAMES.SAAS),\n authoredInfrastructureHome: join(appRoot, APP_RUNTIME_SUBDIR_NAMES.INFRASTRUCTURE),\n runtimeHome,\n continuityHome,\n applicationSubjectManifestPath: join(\n continuityHome,\n APP_CONTINUITY_FILE_NAMES.APPLICATION_SUBJECT_MANIFEST,\n ),\n applicationContinuityBootstrapProfilePath: join(\n continuityHome,\n APP_CONTINUITY_FILE_NAMES.BOOTSTRAP_PROFILE,\n ),\n distHome,\n applicationSpecificationsDistHome,\n applicationSpecificationProjectionsHome: join(\n applicationSpecificationsDistHome,\n APP_RUNTIME_SUBDIR_NAMES.PROJECTIONS,\n ),\n stateHome: join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.STATE),\n temporaryHome,\n integrationTestsTemporaryHome: join(\n temporaryHome,\n APP_RUNTIME_SUBDIR_NAMES.INTEGRATION_TESTS,\n ),\n logsHome,\n companionLogsHome: join(logsHome, 'dev-companion'),\n localDataHome: join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.LOCAL_DATA),\n runtimeInfrastructureHome,\n runtimeEnvironmentsHome: join(runtimeInfrastructureHome, APP_RUNTIME_SUBDIR_NAMES.ENVIRONMENTS),\n deployArtifactsHome: join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.DEPLOY),\n frameworkScriptsHome: join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.FRAMEWORK_SCRIPTS),\n runtimeSignalsHome: join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.RUNTIME_SIGNALS),\n companionHome: join(runtimeHome, APP_RUNTIME_SUBDIR_NAMES.COMPANION),\n preferencesOverlayPath: join(runtimeHome, AUTHORED_CONFIG_FILE_NAMES.APP_LOCAL_PREFERENCES),\n configLoaderArtifactsHome: join(\n distHome,\n APP_RUNTIME_SUBDIR_NAMES.CONFIG_LOADER,\n 'saas',\n ),\n };\n}\n"]}
|