@arki/dot 0.1.0

package/dist/diagnostics.js

@@ -0,0 +1,14 @@
+/**
+ * Diagnostics types for the DOT kernel.
+ *
+ * Where the manifest describes the static shape of an app, a
+ * `DotDiagnosticsSnapshot` is a point-in-time observability record: the
+ * lifecycle state of the app and every pip, plus structured issues with
+ * remediation guidance.
+ *
+ * CONTRACT: `DotDiagnosticsSnapshot` always exposes the same five arrays
+ * (`pips`, `routes`, `services`, `lifecycle`, `issues`). Consumers must
+ * never see an omitted array — empty is empty, but never missing.
+ * This is the "5 arrays" contract referenced by the kernel spec.
+ */
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @arki/dot — TypeScript-first application composition framework
+ *
+ * Public surface:
+ *   - `defineApp(name)` — the modern entry point for composing applications.
+ *   - `defineDotPip(config)` — define lifecycle-aware pips.
+ *   - Lifecycle / manifest / diagnostics types.
+ *   - `testApp` / `bootTestApp` — test harnesses for pip authors.
+ */
+export { defineApp } from './define-app.js';
+export type { DotApp, DotAppBuilder, DotAppConfigured } from './define-app.js';
+export { defineDotPip, DotPipError } from './pip-contract.js';
+export type { DotPip, DotBootContext, DotBootResult, DotConfigureContext, DotDisposeContext, DotManifestContext, DotManifestContribution, DotStartContext, DotStopContext, } from './pip-contract.js';
+export { DotLifecycleError, DotLifecycleErrorCode, DOT_LIFECYCLE_HOOKS, } from './lifecycle.js';
+export type { DotLifecycleHook, DotLifecycleState, DotLifecyclePipFailure, DotLifecycleErrorCodeValue, } from './lifecycle.js';
+export type { DotAppManifest, PipManifest, RouteManifest, ServiceManifest, LifecycleManifest, DependencyEdge, DependencyEdgeKind, ServiceKind, RouteTransport, } from './manifest.js';
+export type { DotDiagnosticsSnapshot, PipDiagnostic, RouteDiagnostic, ServiceDiagnostic, LifecycleDiagnostic, DiagnosticIssue, DiagnosticSeverity, DiagnosticStatus, } from './diagnostics.js';
+export type { DotLifecycleEvent, DotLifecycleEventStatus, DotLifecycleObserver, DotPhaseLifecycleEvent, DotPipHookLifecycleEvent, } from './lifecycle-observer.js';
+export { renderTimeline } from './timeline.js';
+export type { RenderTimelineOptions } from './timeline.js';
+export { testApp, bootTestApp } from './test-harness.js';
+export type { TestAppOptions } from './test-harness.js';
+export type { DotCliEnvelope, DotCliEnvelopeStatus } from './cli/render-explain.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EACV,MAAM,EACN,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @arki/dot — TypeScript-first application composition framework
+ *
+ * Public surface:
+ *   - `defineApp(name)` — the modern entry point for composing applications.
+ *   - `defineDotPip(config)` — define lifecycle-aware pips.
+ *   - Lifecycle / manifest / diagnostics types.
+ *   - `testApp` / `bootTestApp` — test harnesses for pip authors.
+ */
+// #region New kernel — public surface (Task 9a)
+export { defineApp } from './define-app.js';
+export { defineDotPip, DotPipError } from './pip-contract.js';
+export { DotLifecycleError, DotLifecycleErrorCode, DOT_LIFECYCLE_HOOKS, } from './lifecycle.js';
+export { renderTimeline } from './timeline.js';
+export { testApp, bootTestApp } from './test-harness.js';
+// #endregion
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gDAAgD;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAa9D,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAuCxB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMzD,aAAa"}

package/dist/kernel/app-instance.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Internal DotApp implementation — the kernel's lifecycle scheduler.
+ *
+ * Not exported from the public surface. Tests reach it only through
+ * `defineApp(...)` and its returned `DotApp` interface.
+ */
+import type { DotDiagnosticsSnapshot } from '../diagnostics.js';
+import type { DotLifecycleObserver } from '../lifecycle-observer.js';
+import type { DotLifecycleState } from '../lifecycle.js';
+import type { DotAppManifest } from '../manifest.js';
+import type { AnyDotPip } from '../pip-contract.js';
+export type DotAppInternalConfig = {
+    appName: string;
+    appVersion?: string;
+    pips: readonly AnyDotPip[];
+    /** Runtime config bag passed to every `boot` hook. */
+    config?: Readonly<Record<string, unknown>>;
+    /**
+     * Observers registered at construction time, before any phase fires.
+     * Required if a consumer wants to see `configure`-phase events — those
+     * happen before there's a public seam to call `subscribe()` on.
+     */
+    observers?: readonly DotLifecycleObserver[];
+};
+/**
+ * Internal app implementation. Public consumers see the `DotApp` interface
+ * from `../define-app.ts`.
+ */
+export declare class DotAppImpl {
+    #private;
+    constructor(config: DotAppInternalConfig);
+    /**
+     * Register a lifecycle observer. The returned function unregisters it.
+     * Observers added through `subscribe()` see events emitted *after*
+     * subscription only — to catch `configure` events, pass observers
+     * through `defineApp(name, { observers })` at construction time.
+     */
+    subscribe(observer: DotLifecycleObserver): () => void;
+    get name(): string;
+    get state(): DotLifecycleState;
+    get services(): Record<string, unknown>;
+    get manifest(): DotAppManifest;
+    get diagnostics(): DotDiagnosticsSnapshot;
+    /**
+     * Run the `configure` phase synchronously. Idempotent.
+     *
+     * @throws {DotLifecycleError} if any configure hook throws or returns a Promise.
+     */
+    runConfigure(): void;
+    /** Public boot() — idempotent + concurrent-safe. */
+    boot(): Promise<void>;
+    /** Public start(). Boots first if needed. Idempotent. */
+    start(): Promise<void>;
+    /** Public stop(). Idempotent + concurrent-safe. */
+    stop(): Promise<void>;
+    /** Public dispose(). Idempotent + concurrent-safe. */
+    dispose(): Promise<void>;
+}
+/** Re-export `ServiceKind` and `RouteTransport` for the kernel's internal use. */
+export { type RouteTransport, type ServiceKind } from '../manifest.js';
+export { type DotPip } from '../pip-contract.js';
+//# sourceMappingURL=app-instance.d.ts.map

package/dist/kernel/app-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-instance.d.ts","sourceRoot":"","sources":["../../src/kernel/app-instance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAEV,sBAAsB,EAKvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAqB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,KAAK,EAA4C,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACnG,OAAO,KAAK,EAGV,cAAc,EAKf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,SAAS,EAOV,MAAM,oBAAoB,CAAC;AA0D5B,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3B,sDAAsD;IACtD,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,qBAAa,UAAU;;gBAkDT,MAAM,EAAE,oBAAoB;IAkCxC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAuIrD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,KAAK,IAAI,iBAAiB,CAE7B;IAED,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtC;IAED,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAED,IAAI,WAAW,IAAI,sBAAsB,CAExC;IAED;;;;OAIG;IACH,YAAY,IAAI,IAAI;IAmKpB,oDAAoD;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiJ3B,yDAAyD;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuH5B,mDAAmD;IAC7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsH3B,sDAAsD;IAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA4R/B;AA0BD,kFAAkF;AAElF,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC"}