@dsh-workbench/shared 0.3.10 → 1.0.0-beta.0

package/dist/host/unit-face.d.ts

@@ -1,12 +1,13 @@
 import type { DshHostContext } from '../api/dsh.js';
-import type { UnitManifest } from '../api/unit.js';
+import type { UnitManifest } from '../contract/unit.js';
 import type { RouteTable } from '../host/http.js';
 import type { LongTaskBase, LongTaskHost, LongTaskRegistry } from '../host/long-task.js';
-import type { ProvisionHandler } from '../host/provision.js';
-import type { UnitCapability } from './unit-libs.js';
+import type { ProvisionHandler } from './provision.js';
+import type { UnitCapability } from '../contract/unit-capability.js';
 import type { ApprovalCall, ApprovalFacts, ApprovalPolicy } from '../host/tool-approval.js';
 import type { ValueHandoff } from '../host/value-handoff.js';
 import type { WorkspaceStore } from '../host/workspace-store.js';
+import type { DataReader } from '../contract/data.js';
 export interface ToolScopeContext {
     readonly workspace: string | null;
     readonly preset: string | null;
@@ -21,7 +22,7 @@ export interface UnitMountDeps {
     readonly manifests: () => readonly UnitManifest[];
     readonly ownedUnits: () => readonly string[];
     readonly installable?: (() => readonly string[]) | undefined;
-    readonly opencliCommand?: string;
+    readonly data: DataReader;
     readonly store: WorkspaceStore;
     readonly values?: ValueHandoff | undefined;
     readonly probe?: (unit: string, options?: {

package/dist/host/version-range.d.ts

@@ -0,0 +1,2 @@
+export type VersionVerdict = 'satisfied' | 'unsatisfied' | 'malformed';
+export declare function checkVersionRange(contract: string | undefined, version: string): VersionVerdict;

package/dist/host/version-range.js

@@ -0,0 +1,73 @@
+import { compareVersions } from './version.js';
+function readable(version) {
+    return compareVersions(version, '0.0.0') !== undefined;
+}
+function segmentsOf(version) {
+    if (!readable(version))
+        return undefined;
+    return version.split('.').map((part) => Number.parseInt(part, 10));
+}
+function caretUpper(base) {
+    const [major = 0, minor = 0, patch = 0] = base;
+    if (major > 0)
+        return `${major + 1}.0.0`;
+    return minor > 0 ? `0.${minor + 1}.0` : `0.0.${patch + 1}`;
+}
+function tildeUpper(base) {
+    const [major = 0, minor = 0] = base;
+    return `${major}.${minor + 1}.0`;
+}
+function comparator(token, version) {
+    const match = /^(>=|<=|>|<|=|\^|~)?\s*(.+)$/.exec(token.trim());
+    if (match === null)
+        return undefined;
+    const [, operator = '', raw = ''] = match;
+    const base = segmentsOf(raw.trim());
+    if (base === undefined)
+        return undefined;
+    const at = (other) => compareVersions(version, other);
+    switch (operator) {
+        case '^':
+            return (at(raw) ?? -1) >= 0 && (at(caretUpper(base)) ?? 1) < 0;
+        case '~':
+            return (at(raw) ?? -1) >= 0 && (at(tildeUpper(base)) ?? 1) < 0;
+        default:
+            break;
+    }
+    const compared = at(raw.trim());
+    if (compared === undefined)
+        return undefined;
+    switch (operator) {
+        case '>=':
+            return compared >= 0;
+        case '<=':
+            return compared <= 0;
+        case '>':
+            return compared > 0;
+        case '<':
+            return compared < 0;
+        case '=':
+        case '':
+            return compared === 0;
+        default:
+            return undefined;
+    }
+}
+export function checkVersionRange(contract, version) {
+    const spec = contract?.trim() ?? '';
+    if (spec === '')
+        return 'satisfied';
+    if (!readable(version))
+        return 'malformed';
+    const tokens = spec.split(/\s+/).filter((token) => token !== '');
+    if (tokens.length === 0)
+        return 'satisfied';
+    for (const token of tokens) {
+        const verdict = comparator(token, version);
+        if (verdict === undefined)
+            return 'malformed';
+        if (!verdict)
+            return 'unsatisfied';
+    }
+    return 'satisfied';
+}

package/dist/host/version.d.ts

@@ -0,0 +1,3 @@
+export declare function runningVersionOf(moduleUrl: string): string | undefined;
+export declare function compareVersions(a: string, b: string): number | undefined;
+export declare function isNewerVersion(latest: string, installed: string): boolean;

package/dist/host/version.js

@@ -0,0 +1,29 @@
+import { readFileSync } from 'node:fs';
+export function runningVersionOf(moduleUrl) {
+    try {
+        const read = JSON.parse(readFileSync(new URL('../../package.json', moduleUrl), 'utf8'));
+        return typeof read.version === 'string' && read.version !== '' ? read.version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function compareVersions(a, b) {
+    const na = a.split('.').map((part) => Number.parseInt(part, 10));
+    const nb = b.split('.').map((part) => Number.parseInt(part, 10));
+    if (na.some(Number.isNaN) || nb.some(Number.isNaN))
+        return undefined;
+    for (let index = 0; index < Math.max(na.length, nb.length); index += 1) {
+        const left = na[index] ?? 0;
+        const right = nb[index] ?? 0;
+        if (left !== right)
+            return left > right ? 1 : -1;
+    }
+    return 0;
+}
+export function isNewerVersion(latest, installed) {
+    if (latest === installed)
+        return false;
+    const compared = compareVersions(latest, installed);
+    return compared === undefined ? true : compared > 0;
+}

package/dist/host.d.ts

@@ -1,38 +1,69 @@
 export * from './config/constants.js';
 export * from './api/context-ref.js';
-export * from './api/unit.js';
-export * from './api/facts.js';
-export * from './api/long-task.js';
+export * from './contract/unit.js';
+export * from './contract/needs.js';
+export * from './contract/data.js';
+export * from './contract/unit-board.js';
+export * from './contract/workbench-contract.js';
+export * from './contract/blocker.js';
+export * from './contract/facts.js';
+export * from './contract/long-task.js';
 export * from './lib/text.js';
 export * from './lib/ui.js';
 export * from './lib/board-fact.js';
 export * from './api/blocker-table.js';
+export * from './contract/unit-declaration.js';
 export * from './host/board-fact.js';
-export * from './host/browser-find.js';
-export * from './host/browser-read.js';
-export * from './host/cli-error.js';
 export * from './host/context-ref.js';
-export * from './host/data-root.js';
 export * from './host/diy-debug.js';
 export * from './host/diy-record.js';
 export * from './host/facts.js';
 export * from './host/git.js';
 export * from './host/http.js';
+export * from './host/lib-capabilities.js';
 export * from './host/long-task.js';
-export * from './host/opencli-runtime.js';
-export * from './host/opencli-window.js';
-export * from './host/opencli.js';
 export * from './host/panel-state.js';
 export * from './host/plugin-ledger.js';
-export * from './host/plugin-source.js';
-export * from './host/provision.js';
-export * from './host/shell-text.js';
-export * from './host/shell.js';
+export * from './host/time.js';
+export * from './host/tokens.js';
 export * from './host/tool-approval.js';
 export * from './host/tool-kit.js';
-export * from './host/unit-declaration.js';
 export * from './host/unit-face.js';
-export * from './host/unit-libs.js';
 export * from './host/value-handoff.js';
 export * from './host/workspace-store.js';
 export * from './host/write-result.js';
+export * from './host/cli-error.js';
+export * from './host/data-root.js';
+export * from './host/shell-text.js';
+export * from './host/shell.js';
+export * from './host/data-error.js';
+export * from './host/provision.js';
+export * from './host/channel-plugin.js';
+export * from './host/recipe.js';
+export * from './host/recipe-rules.js';
+export * from './contract/unit-capability.js';
+export * from './contract/plugin-source.js';
+export * from './contract/cli.js';
+export * from './host/cli.js';
+export * from './host/command-name.js';
+export * from './host/browser.js';
+export * from './host/preflight.js';
+export * from './host/platform.js';
+export * from './host/profile-port.js';
+export * from './host/supply-port.js';
+export * from './host/version.js';
+export * from './host/adapter-types.js';
+export * from './host/paths.js';
+export * from './host/plugin.js';
+export * from './host/spec.js';
+export * from './host/plugin-source.js';
+export * from './host/lib-install.js';
+export * from './host/supply-index.js';
+export * from './host/patch.js';
+export * from './host/adapters.js';
+export * from './host/adapter-set.js';
+export * from './host/needs.js';
+export * from './host/port-types.js';
+export * from './host/version-range.js';
+export * from './host/market-index.js';
+export * from './host/changelog.js';

package/dist/host.js

@@ -1,38 +1,69 @@
 export * from './config/constants.js';
 export * from './api/context-ref.js';
-export * from './api/unit.js';
-export * from './api/facts.js';
-export * from './api/long-task.js';
+export * from './contract/unit.js';
+export * from './contract/needs.js';
+export * from './contract/data.js';
+export * from './contract/unit-board.js';
+export * from './contract/workbench-contract.js';
+export * from './contract/blocker.js';
+export * from './contract/facts.js';
+export * from './contract/long-task.js';
 export * from './lib/text.js';
 export * from './lib/ui.js';
 export * from './lib/board-fact.js';
 export * from './api/blocker-table.js';
+export * from './contract/unit-declaration.js';
 export * from './host/board-fact.js';
-export * from './host/browser-find.js';
-export * from './host/browser-read.js';
-export * from './host/cli-error.js';
 export * from './host/context-ref.js';
-export * from './host/data-root.js';
 export * from './host/diy-debug.js';
 export * from './host/diy-record.js';
 export * from './host/facts.js';
 export * from './host/git.js';
 export * from './host/http.js';
+export * from './host/lib-capabilities.js';
 export * from './host/long-task.js';
-export * from './host/opencli-runtime.js';
-export * from './host/opencli-window.js';
-export * from './host/opencli.js';
 export * from './host/panel-state.js';
 export * from './host/plugin-ledger.js';
-export * from './host/plugin-source.js';
-export * from './host/provision.js';
-export * from './host/shell-text.js';
-export * from './host/shell.js';
+export * from './host/time.js';
+export * from './host/tokens.js';
 export * from './host/tool-approval.js';
 export * from './host/tool-kit.js';
-export * from './host/unit-declaration.js';
 export * from './host/unit-face.js';
-export * from './host/unit-libs.js';
 export * from './host/value-handoff.js';
 export * from './host/workspace-store.js';
 export * from './host/write-result.js';
+export * from './host/cli-error.js';
+export * from './host/data-root.js';
+export * from './host/shell-text.js';
+export * from './host/shell.js';
+export * from './host/data-error.js';
+export * from './host/provision.js';
+export * from './host/channel-plugin.js';
+export * from './host/recipe.js';
+export * from './host/recipe-rules.js';
+export * from './contract/unit-capability.js';
+export * from './contract/plugin-source.js';
+export * from './contract/cli.js';
+export * from './host/cli.js';
+export * from './host/command-name.js';
+export * from './host/browser.js';
+export * from './host/preflight.js';
+export * from './host/platform.js';
+export * from './host/profile-port.js';
+export * from './host/supply-port.js';
+export * from './host/version.js';
+export * from './host/adapter-types.js';
+export * from './host/paths.js';
+export * from './host/plugin.js';
+export * from './host/spec.js';
+export * from './host/plugin-source.js';
+export * from './host/lib-install.js';
+export * from './host/supply-index.js';
+export * from './host/patch.js';
+export * from './host/adapters.js';
+export * from './host/adapter-set.js';
+export * from './host/needs.js';
+export * from './host/port-types.js';
+export * from './host/version-range.js';
+export * from './host/market-index.js';
+export * from './host/changelog.js';