@vibesdotdev/forge 0.0.0-stage → 1.0.0-rc.5

package/dist/cli/compat/pr.descriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.descriptors.js","sourceRoot":"","sources":["../../../src/cli/compat/pr.descriptors.ts"],"names":[],"mappings":"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"}

package/dist/cli/compat/pr.diff.impl.d.ts

@@ -0,0 +1,6 @@
+import { diff } from './pr.commands.ts';
+declare const _default: {
+    execute: typeof diff;
+};
+export default _default;
+//# sourceMappingURL=pr.diff.impl.d.ts.map

package/dist/cli/compat/pr.diff.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.diff.impl.d.ts","sourceRoot":"","sources":["../../../src/cli/compat/pr.diff.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;;;;AAAC,wBAAiC"}

package/dist/cli/compat/pr.diff.impl.js

@@ -0,0 +1,3 @@
+import { diff } from "./pr.commands.js";
+export default { execute: diff };
+//# sourceMappingURL=pr.diff.impl.js.map

package/dist/cli/compat/pr.diff.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.diff.impl.js","sourceRoot":"","sources":["../../../src/cli/compat/pr.diff.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAAC,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/cli/compat/pr.list.impl.d.ts

@@ -0,0 +1,6 @@
+import { list } from './pr.commands.ts';
+declare const _default: {
+    execute: typeof list;
+};
+export default _default;
+//# sourceMappingURL=pr.list.impl.d.ts.map

package/dist/cli/compat/pr.list.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.list.impl.d.ts","sourceRoot":"","sources":["../../../src/cli/compat/pr.list.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;;;;AAAC,wBAAiC"}

package/dist/cli/compat/pr.list.impl.js

@@ -0,0 +1,3 @@
+import { list } from "./pr.commands.js";
+export default { execute: list };
+//# sourceMappingURL=pr.list.impl.js.map

package/dist/cli/compat/pr.list.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.list.impl.js","sourceRoot":"","sources":["../../../src/cli/compat/pr.list.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAAC,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/cli/compat/pr.merge.impl.d.ts

@@ -0,0 +1,6 @@
+import { merge } from './pr.commands.ts';
+declare const _default: {
+    execute: typeof merge;
+};
+export default _default;
+//# sourceMappingURL=pr.merge.impl.d.ts.map

package/dist/cli/compat/pr.merge.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.merge.impl.d.ts","sourceRoot":"","sources":["../../../src/cli/compat/pr.merge.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;;;;AAAC,wBAAkC"}

package/dist/cli/compat/pr.merge.impl.js

@@ -0,0 +1,3 @@
+import { merge } from "./pr.commands.js";
+export default { execute: merge };
+//# sourceMappingURL=pr.merge.impl.js.map

package/dist/cli/compat/pr.merge.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.merge.impl.js","sourceRoot":"","sources":["../../../src/cli/compat/pr.merge.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAAC,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/cli/compat/pr.review.impl.d.ts

@@ -0,0 +1,6 @@
+import { review } from './pr.commands.ts';
+declare const _default: {
+    execute: typeof review;
+};
+export default _default;
+//# sourceMappingURL=pr.review.impl.d.ts.map

package/dist/cli/compat/pr.review.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.review.impl.d.ts","sourceRoot":"","sources":["../../../src/cli/compat/pr.review.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;;;;AAAC,wBAAmC"}

package/dist/cli/compat/pr.review.impl.js

@@ -0,0 +1,3 @@
+import { review } from "./pr.commands.js";
+export default { execute: review };
+//# sourceMappingURL=pr.review.impl.js.map

package/dist/cli/compat/pr.review.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.review.impl.js","sourceRoot":"","sources":["../../../src/cli/compat/pr.review.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAAC,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/cli/compat/pr.view.impl.d.ts

@@ -0,0 +1,6 @@
+import { view } from './pr.commands.ts';
+declare const _default: {
+    execute: typeof view;
+};
+export default _default;
+//# sourceMappingURL=pr.view.impl.d.ts.map

package/dist/cli/compat/pr.view.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.view.impl.d.ts","sourceRoot":"","sources":["../../../src/cli/compat/pr.view.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;;;;AAAC,wBAAiC"}

package/dist/cli/compat/pr.view.impl.js

@@ -0,0 +1,3 @@
+import { view } from "./pr.commands.js";
+export default { execute: view };
+//# sourceMappingURL=pr.view.impl.js.map

package/dist/cli/compat/pr.view.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.view.impl.js","sourceRoot":"","sources":["../../../src/cli/compat/pr.view.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAAC,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/cli/docs/forge.cli.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=forge.cli.docs.descriptor.d.ts.map

package/dist/cli/docs/forge.cli.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge.cli.docs.descriptor.d.ts","sourceRoot":"","sources":["../../../src/cli/docs/forge.cli.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,QAAA,MAAM,UAAU,EAAE,mBAqRjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/docs/forge.cli.docs.descriptor.js

@@ -0,0 +1,279 @@
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'forge.cli',
+    title: 'Forge CLI',
+    summary: 'Create, list, clone, and administer Vibes Forge repositories from the vibes CLI.',
+    parent: 'cli',
+    order: 56,
+    tags: ['forge', 'git', 'cli', 'repositories', 'migration'],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    subject: { kind: 'cli/group', id: 'forge' },
+    man: {
+        name: 'forge — manage Vibes Forge repositories',
+        section: 1,
+        synopsis: 'vibes forge <command>',
+        options: [
+            { flag: '--json', description: 'Emit JSON for commands that return structured data' },
+            { flag: '--yes', description: 'Use the CLI host confirmation flag for destructive commands' }
+        ],
+        examples: [
+            {
+                command: 'vibes forge doctor',
+                description: 'Diagnose Forge CLI auth and environment resolution'
+            },
+            {
+                command: 'vibes forge repo list',
+                description: 'List repositories visible to your account'
+            },
+            {
+                command: 'vibes forge repo create my-app --private',
+                description: 'Create a private Vibes-hosted repository'
+            },
+            {
+                command: 'vibes forge branch-policy set my-app main --reviews required --required-checks forge/test',
+                description: 'Require review approval and status checks before PR merge'
+            },
+            {
+                command: 'vibes forge collaborator add my-app user_123 --role write',
+                description: 'Grant repository access to another user'
+            },
+            { command: 'vibes forge issue list my-app', description: 'List repository issues' },
+            {
+                command: 'vibes forge pr create my-app "Ship feature" --source feature/x',
+                description: 'Open a pull request'
+            },
+            {
+                command: `vibes forge pr review my-app 3 --approve --head-sha ${'a'.repeat(40)}`,
+                description: 'Approve a pull request at an exact head commit'
+            },
+            {
+                command: 'vibes forge pr stack create my-app 101,102,103',
+                description: 'Create a bottom-to-top pull-request stack'
+            },
+            {
+                command: 'vibes forge clone-url my-app',
+                description: 'Print the best transport currently published for a repository'
+            },
+            {
+                command: 'git clone "$(vibes forge clone-url my-app)"',
+                description: 'Clone through the service-published default transport'
+            },
+            {
+                command: 'vibes forge clone-url my-app --transport https',
+                description: 'Print the HTTPS compatibility URL'
+            },
+            {
+                command: 'vibes forge remote bootstrap my-app --cwd ./my-app --remote forge',
+                description: 'Configure a local Forge fetch URL, helper, and scoped push intent'
+            }
+        ],
+        seeAlso: ['registry.publishing', 'forge.tools', 'forge.split-repositories']
+    },
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: `---
+title: Forge CLI
+summary: Create, list, clone, and administer Vibes Forge repositories from the vibes CLI.
+tags: [forge, git, cli, repositories, migration]
+parent: cli
+order: 56
+surfaces: [cli]
+hardware: [consumer]
+---
+
+The \`vibes forge\` command group is the migration path for repository operations
+that would otherwise start in GitHub. It talks to platform-web for ownership,
+permissions, and repository metadata, and to git.vibes.dev for Git transport.
+
+:::descriptor{kind="cli/group" id="forge"}
+:::
+
+## Repository workflow
+
+:::shell
+vibes auth login
+vibes forge doctor
+vibes forge repo list
+vibes forge repo create my-app --private
+vibes forge clone-url my-app
+git clone "$(vibes forge clone-url my-app)" my-app
+vibes forge remote bootstrap my-app --cwd ./my-app --remote forge
+git -C my-app push forge HEAD
+:::
+
+\`vibes git\` is an alias for the same group, so existing Git-oriented scripts can
+use either prefix.
+
+Vibes repositories use exactly
+\`ssh://git@git.vibes.dev/&lt;owner&gt;/&lt;repo&gt;.git\`. Register a public key
+once; clone, fetch, and push then need no Git configuration or Forge-specific
+credential helper. HTTPS at that hostname is the Forge/API control plane.
+
+## Branch merge policy
+
+Branch policies configure PR merge requirements for target branch patterns. They
+are enforced by the platform-web merge gate and surfaced in mergeability checks.
+This is not yet raw \`git push\` protection: direct receive-pack writes still need
+host-side policy consultation before we can honestly call the branch protected
+against every write path.
+
+:::shell
+vibes forge branch-policy list my-app
+vibes forge branch-policy set my-app main --reviews required --required-checks forge/test,forge/lint
+vibes forge branch-policy remove my-app main
+:::
+
+## Access management
+
+Repository owners and admins can grant, update, list, and revoke explicit user
+access. The namespace owner is implicit and is not listed as a collaborator.
+Platform-web enforces the admin-only guard; the CLI only sends the requested
+repo, user, and role.
+
+:::shell
+vibes forge collaborator list my-app
+vibes forge collaborator add my-app user_123 --role write
+vibes forge collaborator remove my-app user_123
+:::
+
+\`vibes forge collaborator\` also accepts the shorter \`collab\` alias.
+
+## Issues and pull requests
+
+Issues and PRs are repository-scoped tracking items. The CLI wraps the same
+platform-web routes used by git.vibes.dev and the forge tools, so status checks,
+review verdicts, and merge policy remain server-owned.
+
+:::shell
+vibes forge issue list my-app
+vibes forge issue create my-app "Document cut-over checklist" --type doc
+vibes forge issue comment my-app 12 "Ready for validation"
+
+vibes forge pr list my-app
+vibes forge pr create my-app "Ship feature" --source feature/x
+vibes forge pr merge-status my-app 3
+vibes forge pr review my-app 3 --approve --head-sha aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
+vibes forge pr review my-app 3 --request-changes --head-sha aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa --body "Please add the missing test"
+vibes forge pr review my-app 3 --comment --body "Looks good overall"
+vibes forge pr merge my-app 3
+:::
+
+A pull-request description may declare what it closes with the usual keywords —
+\`Closes #12\`, \`Fixes #12\`, \`Resolves #12\` (any tense, any case, optional colon).
+Platform records each one as a \`closes\` link when the PR is opened, and merging
+the PR closes those issues and stamps a reverse \`completed-by\` edge back to it.
+Keywords are read from prose only: text inside fenced or inline code is ignored,
+so a quoted commit log containing \`fixes #3\` closes nothing. A bare \`#12\` with
+no keyword is a reference, not a close.
+
+## Pull-request stacks
+
+Stacks are persisted ordered aggregates, not a naming convention inferred from
+mutable branch targets. Create links existing PRs in bottom-to-top order; every
+update uses an expected revision. Restack and merge additionally bind the exact
+40-character head of every affected layer. Reuse \`--idempotency-key\` when
+retrying a mutation after an uncertain transport result.
+
+:::shell
+vibes forge pr stack list my-app
+vibes forge pr stack create my-app 101,102,103 --policy batch-allowed
+vibes forge pr stack get my-app 4
+vibes forge pr stack restack my-app 4 --revision 2 --heads 101=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa,102=bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb,103=cccccccccccccccccccccccccccccccccccccccc
+vibes forge pr stack merge my-app 4 --through 103 --revision 3 --heads 101=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa,102=bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb,103=cccccccccccccccccccccccccccccccccccccccc
+:::
+
+Approval and change-request verdicts require the exact 40-character PR head SHA.
+Platform-web rejects a supplied SHA when the PR has moved, so a review can never
+silently bind to a different commit. Approval bodies are optional; change requests
+and non-verdict comments require \`--body\`. The platform still derives the author
+from the authenticated session and enforces repository RBAC and no-self-approval.
+
+## Authentication
+
+Run \`vibes auth login\` first. The forge CLI exchanges the stored session for a
+short-lived app JWT and sends that to platform-web. Repository authorization is
+enforced server-side; the CLI never re-implements repository RBAC.
+
+Forge commands address the declared \`platform\` and \`auth\` services in the
+host's configured service environment (\`infra.services.environment\`). The
+installed public binary's floor declares production; a source checkout that
+intentionally targets production sets its \`infra.services.environment\` to
+\`production\`. No env var selects the target. Registry setup, inspection and smoke resolve
+the declared \`registry\` service. Registry smoke \`--origin\` changes its registry
+target and \`--platform-origin\` changes its mint/revoke target; neither changes
+the credential environment or auth origin. Generated npm and Bun config retains
+unrelated entries and stores token environment references, never token values.
+
+\`vibes forge doctor --expect-production --live\` verifies the resolved origins,
+stored credential, and app-JWT exchange before you run migration commands.
+
+Use \`vibes forge doctor --cwd ./my-app\` to distinguish Forge read-auth
+readiness from local Git push readiness. If credential storage is not writable,
+doctor reports that storage failure instead of mislabeling the session as a
+missing login.
+
+Published SSH is the preferred transport for Vibes-owned remotes and automation
+and needs no credential helper:
+
+:::shell
+vibes forge ssh-key add laptop
+git clone "$(vibes forge clone-url my-app)"
+:::
+
+Forge also publishes credential-free Smart HTTPS clone URLs. Users who select
+authenticated HTTPS can explicitly configure Git to invoke the repository-scoped
+helper; Vibes does not install it globally or use it for first-party automation:
+
+:::shell
+vibes forge setup-git --https --local
+git clone https://git.vibes.dev/owner/repository.git
+:::
+
+\`setup-git\` removes old automatic/global helper configuration and migrates
+matching Vibes-owned checkout remotes to canonical SSH:
+
+:::shell
+vibes forge ssh-key add laptop
+git clone "$(vibes forge clone-url my-app)"
+git -C my-app push
+vibes forge setup-git --check
+:::
+
+## Cut-over gates
+
+Operational smoke commands expose \`vibes forge smoke merge\`,
+\`vibes forge smoke registry\` / \`vibes registry smoke\`, and
+\`vibes forge smoke ai-review\`. They default to dry-run and require
+\`--execute\` for mutation. Public/prod mode hides them unless you explicitly set
+\`VIBES_FORGE_ENABLE_SMOKES=1\`, which is the recommended cut-over path because
+it keeps production auth/origin resolution active.
+
+:::shell
+vibes forge smoke merge
+vibes registry smoke
+vibes forge smoke ai-review
+:::
+
+For production cut-over validation, the host's \`infra.services.environment\`
+selects the service environment: it names the declared \`platform\` and \`auth\`
+origins and the credential partition. \`--origin\` replaces only the platform
+target; it never selects another environment.
+
+:::shell
+VIBES_FORGE_ENABLE_SMOKES=1 vibes forge smoke merge
+VIBES_FORGE_ENABLE_SMOKES=1 vibes registry smoke
+VIBES_FORGE_ENABLE_SMOKES=1 vibes forge smoke ai-review
+:::
+
+## Related
+
+- \`registry.publishing\` covers package publish-token and npm install setup.
+- \`forge.tools\` covers MCP/native-loop forge tools for agents.
+`
+    },
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=forge.cli.docs.descriptor.js.map

package/dist/cli/docs/forge.cli.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge.cli.docs.descriptor.js","sourceRoot":"","sources":["../../../src/cli/docs/forge.cli.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,WAAW;IAClB,OAAO,EAAE,kFAAkF;IAC3F,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,CAAC;IAC1D,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE;IAC3C,GAAG,EAAE;QACJ,IAAI,EAAE,yCAAyC;QAC/C,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE;YACR,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;YACrF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,6DAA6D,EAAE;SAC7F;QACD,QAAQ,EAAE;YACT;gBACC,OAAO,EAAE,oBAAoB;gBAC7B,WAAW,EAAE,oDAAoD;aACjE;YACD;gBACC,OAAO,EAAE,uBAAuB;gBAChC,WAAW,EAAE,2CAA2C;aACxD;YACD;gBACC,OAAO,EAAE,0CAA0C;gBACnD,WAAW,EAAE,0CAA0C;aACvD;YACD;gBACC,OAAO,EACN,2FAA2F;gBAC5F,WAAW,EAAE,2DAA2D;aACxE;YACD;gBACC,OAAO,EAAE,2DAA2D;gBACpE,WAAW,EAAE,yCAAyC;aACtD;YACD,EAAE,OAAO,EAAE,+BAA+B,EAAE,WAAW,EAAE,wBAAwB,EAAE;YACnF;gBACC,OAAO,EAAE,gEAAgE;gBACzE,WAAW,EAAE,qBAAqB;aAClC;YACD;gBACC,OAAO,EAAE,uDAAuD,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;gBAChF,WAAW,EAAE,gDAAgD;aAC7D;YACD;gBACC,OAAO,EAAE,gDAAgD;gBACzD,WAAW,EAAE,2CAA2C;aACxD;YACD;gBACC,OAAO,EAAE,8BAA8B;gBACvC,WAAW,EAAE,+DAA+D;aAC5E;YACD;gBACC,OAAO,EAAE,6CAA6C;gBACtD,WAAW,EAAE,uDAAuD;aACpE;YACD;gBACC,OAAO,EAAE,gDAAgD;gBACzD,WAAW,EAAE,mCAAmC;aAChD;YACD;gBACC,OAAO,EAAE,mEAAmE;gBAC5E,WAAW,EAAE,mEAAmE;aAChF;SACD;QACD,OAAO,EAAE,CAAC,qBAAqB,EAAE,aAAa,EAAE,0BAA0B,CAAC;KAC3E;IACD,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsMT;KACC;IACD,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/docs/forge.split-repositories.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=forge.split-repositories.docs.descriptor.d.ts.map

package/dist/cli/docs/forge.split-repositories.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge.split-repositories.docs.descriptor.d.ts","sourceRoot":"","sources":["../../../src/cli/docs/forge.split-repositories.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,QAAA,MAAM,UAAU,EAAE,mBAqGjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/docs/forge.split-repositories.docs.descriptor.js

@@ -0,0 +1,103 @@
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'forge.split-repositories',
+    title: 'Split repository topology',
+    summary: 'Product source lives in independently owned Forge repositories. The retired aggregate is not an authority.',
+    parent: 'forge.cli',
+    order: 58,
+    tags: ['forge', 'git', 'cutover', 'topology', 'publish'],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    subject: { kind: 'cli/group', id: 'forge' },
+    man: {
+        name: 'split-repositories — Forge destination identity',
+        section: 7,
+        synopsis: 'config/repositories.json',
+        examples: [
+            {
+                command: 'bun run remotes',
+                description: 'Verify each checkout’s canonical forge remote'
+            },
+            {
+                command: 'bun run check:remote-identity',
+                description: 'Fail if two distinct Forge destinations share HEAD'
+            },
+            {
+                command: 'vibes infra npm publish --dry-run .',
+                description: 'Publish from the owning repository workspace, not the developer root'
+            }
+        ],
+        seeAlso: ['forge.cli', 'registry.publishing']
+    },
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: `---
+title: Split repository topology
+summary: Product source lives in independently owned Forge repositories. The retired aggregate is not an authority.
+tags: [forge, git, cutover, topology, publish]
+parent: forge.cli
+order: 58
+surfaces: [cli]
+hardware: [consumer]
+---
+
+Vibes product source is not one git repository. Each owner checkout under
+\`repos/\` is a Forge destination declared in \`config/repositories.json\`.
+The retired aggregate (\`vibesdotdev/monorepo\`) is not an input, fallback,
+or publish identity.
+
+## Who owns what
+
+| Checkout | Forge destination | What it publishes |
+| --- | --- | --- |
+| \`repos/platform/framework\` | \`vibesdotdev/framework\` | Runtime, storage, PM, account, forge, and other Framework packages |
+| \`repos/platform/kit\` | \`vibesdotdev/kit\` | Generic SvelteKit primitives only |
+| \`repos/platform/integrations\` | \`vibesdotdev/integrations\` | Provider adapters |
+| \`repos/platform/internal\` | \`vibesdotdev/internal\` | Private first-party internals |
+| \`repos/platform/premium\` | \`vibesdotdev/premium\` | Restricted premium overlays |
+| \`repos/apps/<app>\` | \`vibesdotdev/<app>\` | That app |
+| \`repos/orgs/<org>\` | \`<org-owner>/<app>\` | Org preferences and content, never platform domain code |
+
+GitHub is a mirror. Canonical clone and push go to \`git.vibes.dev\`.
+
+## Package identity
+
+A publishable package names its owning Forge repository, not the retired
+aggregate, and carries the platform repository id used to mint publish
+leases:
+
+:::shell
+"repository": {
+  "type": "git",
+  "url": "git+https://git.vibes.dev/vibesdotdev/framework.git",
+  "directory": "runtime"
+},
+"vibes": {
+  "registry": {
+    "repositoryId": "<platform repositories row id>",
+    "directory": "runtime"
+  }
+}
+:::
+
+Kit packages name \`vibesdotdev/kit\`. Do not put \`workspace:*\` on a package
+that lives in a different Forge repository. Use the published semver; the
+release planner treats that as a registry external.
+
+Publish from the owning checkout through \`vibes infra npm publish\`, never
+from the developer root and never with a raw \`npm publish\` as the primary
+path.
+
+## Related
+
+:::card{title="See also"}
+- [\`forge.cli\`](forge.cli) — create, list, clone, and push Forge repositories
+- [\`registry.publishing\`](registry.publishing) — publish from the owning checkout through \`vibes infra npm publish\`
+:::
+`
+    },
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=forge.split-repositories.docs.descriptor.js.map

package/dist/cli/docs/forge.split-repositories.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge.split-repositories.docs.descriptor.js","sourceRoot":"","sources":["../../../src/cli/docs/forge.split-repositories.docs.descriptor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,YAAY;IAClB,EAAE,EAAE,0BAA0B;IAC9B,KAAK,EAAE,2BAA2B;IAClC,OAAO,EACN,4GAA4G;IAC7G,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC;IACxD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE;IAC3C,GAAG,EAAE;QACJ,IAAI,EAAE,iDAAiD;QACvD,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,0BAA0B;QACpC,QAAQ,EAAE;YACT;gBACC,OAAO,EAAE,iBAAiB;gBAC1B,WAAW,EAAE,+CAA+C;aAC5D;YACD;gBACC,OAAO,EAAE,+BAA+B;gBACxC,WAAW,EAAE,oDAAoD;aACjE;YACD;gBACC,OAAO,EAAE,qCAAqC;gBAC9C,WAAW,EAAE,sEAAsE;aACnF;SACD;QACD,OAAO,EAAE,CAAC,WAAW,EAAE,qBAAqB,CAAC;KAC7C;IACD,IAAI,EAAE;QACL,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DT;KACC;IACD,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/docs/registry.publishing.docs.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+declare const descriptor: DocsTopicDescriptor;
+export default descriptor;
+//# sourceMappingURL=registry.publishing.docs.descriptor.d.ts.map

package/dist/cli/docs/registry.publishing.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.publishing.docs.descriptor.d.ts","sourceRoot":"","sources":["../../../src/cli/docs/registry.publishing.docs.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,QAAA,MAAM,UAAU,EAAE,mBA+JjB,CAAC;AAEF,eAAe,UAAU,CAAC"}