superbee 0.2.1 → 0.3.0-pre.1

package/README.md

@@ -42,18 +42,36 @@ Skill, an instruction file your agent loads, that teaches it how to use the tool
 
 ## Install
 
-Requires Node.js 20 or newer on macOS, Linux, or Windows. Native Windows is supported; you do not
-need WSL or Docker.
+Requires Node.js 20 or newer on macOS and Linux. Native Windows is not supported by this package.
 
 ```sh
 npm install -g superbee
 ```
 
-Stable releases publish on npm's `latest` tag and prereleases on `next`.
+Stable releases publish on npm's `latest` tag and prereleases on `next`. To try the prerelease:
 
-On Windows, Superbee keeps its private per-user state, such as the workspace catalog and remote
-credentials, under `%LOCALAPPDATA%\Superbee`. npm installs `superbee.cmd` alongside the `superbee`
-command; if PowerShell's execution policy blocks the `.ps1` wrapper, call `superbee.cmd` instead.
+```sh
+npm install -g superbee@next
+```
+
+Windows adapters and the `superbee-windows` executable live in a separate repository and are
+not included in `superbee`. Most Windows users should run Superbee in WSL2, where npm sees a
+Linux platform and the normal installation applies. An experimental, unsupported native Windows
+build is available as open source, with build-from-source instructions: https://github.com/Holaxis-ai/superbee-windows-cli
+
+### Upgrading an existing Windows installation
+
+The first release containing the Windows extraction removes native Windows support from this
+package. Its npm `os` metadata permits only `darwin` and `linux`, so a Windows upgrade to an affected
+version is rejected with `EBADPLATFORM`. This applies to existing prerelease users too. Forcing the
+installation does not restore support: the executable refuses commands on unsupported hosts
+before running them (the bare `--version` flag can still identify the installed build).
+
+There is no supported Windows replacement on npm. The alternatives are WSL2 or the experimental
+build from source at https://github.com/Holaxis-ai/superbee-windows-cli; neither carries a
+first-party support promise for native Windows. An older installed version is not converted or
+removed by this source change, and existing bundle files are not migrated by it. Review the affected release's notes before changing an existing
+Windows installation. macOS/Linux users can continue using the normal installation and setup flow.
 
 Run `superbee version --check` to compare your install with the current stable release.
 
@@ -103,7 +121,7 @@ run `npm uninstall -g @holaxis/aslite`. Existing `.agentstate-lite/` bundles and
 ## Learn more
 
 The [repository](https://github.com/Holaxis-ai/superbee) holds the source, the
-[CLI contract](https://github.com/Holaxis-ai/superbee/blob/main/packages/cli/AXI-CONTRACT.md),
+[CLI contract](https://github.com/Holaxis-ai/superbee/blob/main/packages/superbee/AXI-CONTRACT.md),
 and the [wire protocol](https://github.com/Holaxis-ai/superbee/blob/main/docs/WIRE-PROTOCOL.md).
 
 ## License

package/SKILL.md

@@ -97,4 +97,4 @@ preserves a workspace for explicit selection; it never makes that workspace the
 If home or SessionStart reports `skill_update`, run its exact scope-specific command, restart the
 host, and continue; Superbee never rewrites an installed Skill automatically.
 
-<!-- GENERATED by packages/cli/scripts/gen-skill.mjs — do not edit by hand. -->
+<!-- GENERATED by packages/superbee/scripts/gen-skill.mjs — do not edit by hand. -->

package/dist/publication/bridge.d.ts

@@ -1,8 +1,17 @@
+import { type BridgeHostKind } from "@superbee/view-runtime/bridge";
 import { PUBLICATION_BRIDGE_V0, type PublicationBridgeAdmissionV1, type PublicationBridgeV1, type PublicationSnapshotHandleV1 } from "./types.js";
 export interface CreatePublicationBridgeOptionsV1 {
     protocol: typeof PUBLICATION_BRIDGE_V0;
     snapshot: PublicationSnapshotHandleV1;
     admittedView: PublicationBridgeAdmissionV1;
+    /**
+     * The embedding host's identity for `hello.host`. Capabilities default to what this static
+     * bridge answers itself; a snapshot pushes no deltas, so `subscribe-deltas` is never declared.
+     */
+    host?: {
+        kind?: BridgeHostKind;
+        capabilities?: readonly string[];
+    };
 }
 /** Create the canonical read-only View bridge over one immutable publication snapshot. */
 export declare function createPublicationBridge(options: CreatePublicationBridgeOptionsV1): PublicationBridgeV1;

package/dist/publication/capture.d.ts

@@ -1,4 +1,8 @@
+import type { FilesystemHostPolicy } from "@superbee/core/filesystem";
 import { type CapturePublicationSnapshotOptionsV1, type PublicationSnapshotHandleV1 } from "./types.js";
+export interface CapturePublicationRuntimeOptions {
+    readonly filesystemHostPolicy?: FilesystemHostPolicy;
+}
 /** Capture one coherent immutable filesystem publication snapshot. */
-export declare function capturePublicationSnapshot(options: CapturePublicationSnapshotOptionsV1): Promise<PublicationSnapshotHandleV1>;
+export declare function capturePublicationSnapshot(options: CapturePublicationSnapshotOptionsV1, runtimeOptions?: CapturePublicationRuntimeOptions): Promise<PublicationSnapshotHandleV1>;
 //# sourceMappingURL=capture.d.ts.map

package/dist/publication/index.d.ts

@@ -4,4 +4,5 @@ export { PublicationError, isPublicationError } from "./errors.js";
 export type { PublicationErrorCodeV1, PublicationErrorOptions } from "./errors.js";
 export { PUBLICATION_SNAPSHOT_SCHEMA_V1 } from "./schema.js";
 export { PUBLICATION_BRIDGE_V0, PUBLICATION_SNAPSHOT_V1, type CapturePublicationSnapshotOptionsV1, type PublicationBridgeAdmissionV1, type PublicationBridgeOutcomeV1, type PublicationBridgeV1, type PublicationJsonValue, type PublicationObjectRefV1, type PublicationSnapshotHandleV1, type PublicationSnapshotV1, } from "./types.js";
+export type { CapturePublicationRuntimeOptions } from "./capture.js";
 //# sourceMappingURL=index.d.ts.map