@arki/dot 0.1.0

package/dist/plugin-contract.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Public plugin contract for the DOT kernel.
+ *
+ * A `DotPlugin` is a plain object with a name, optional dependency list, and
+ * up to five lifecycle hooks. The kernel calls each hook in dependency order
+ * (or reverse-dependency order for `stop`/`dispose`).
+ *
+ * Design constraints:
+ *
+ *  - `configure` is SYNC. Returning a Promise is an error — the kernel will
+ *    throw {@link DotLifecycleError} with code `DOT_LIFECYCLE_E001`.
+ *  - `boot` may publish services into the app; downstream plugins see them via
+ *    {@link DotBootContext.services}.
+ *  - `stop` and `dispose` continue through individual plugin failures and
+ *    report an aggregate error.
+ */
+import type { DotLifecycleHook } from './lifecycle.js';
+import type { DependencyEdgeKind, RouteTransport, ServiceKind } from './manifest.js';
+/**
+ * Aggregate registration record produced during the `configure` phase.
+ *
+ * The kernel exposes one of these to each plugin via {@link DotConfigureContext}
+ * and uses the merged result to build the final `DotAppManifest`.
+ */
+export type DotManifestContribution = {
+    /** Services this plugin publishes. */
+    services?: readonly {
+        name: string;
+        kind: ServiceKind;
+    }[];
+    /** Routes this plugin exposes. */
+    routes?: readonly {
+        id: string;
+        method?: string;
+        path?: string;
+        transport: RouteTransport;
+    }[];
+    /** Additional `provides` capability strings (joined with the plugin's `provides`). */
+    provides?: readonly string[];
+    /** Additional dependency edges. */
+    dependencies?: readonly {
+        to: string;
+        kind?: DependencyEdgeKind;
+    }[];
+};
+/** Context provided to a `manifest` callback. */
+export type DotManifestContext<TServices extends Record<string, unknown>> = {
+    pluginName: string;
+    /** Services published by dependencies that have already booted (read-only). */
+    services: Readonly<Partial<TServices>>;
+};
+/** Context provided to a `configure` hook. */
+export type DotConfigureContext = {
+    pluginName: string;
+    /** App name. */
+    appName: string;
+    /**
+     * Register a service this plugin publishes.
+     * Registration is metadata-only — the actual service instance is returned
+     * from the `boot` hook in `DotBootResult.services`.
+     */
+    registerService(name: string, kind: ServiceKind): void;
+    /** Register a route this plugin exposes. */
+    registerRoute(route: {
+        id: string;
+        method?: string;
+        path?: string;
+        transport: RouteTransport;
+    }): void;
+    /** Mark the plugin as participating in a lifecycle hook. */
+    registerLifecycleHook(hook: DotLifecycleHook): void;
+    /** Append `provides` capability strings. */
+    declareProvides(...capabilities: string[]): void;
+    /** Append an extra dependency edge (alongside `plugin.dependencies`). */
+    declareDependency(to: string, kind?: DependencyEdgeKind): void;
+};
+/** Context provided to a `boot` hook. */
+export type DotBootContext = {
+    pluginName: string;
+    appName: string;
+    /**
+     * Services published by prior-booted plugins, keyed by service name.
+     * Use this for dependency injection between plugins.
+     */
+    services: ReadonlyMap<string, unknown>;
+    /** Read-only configuration bag. */
+    config: Readonly<Record<string, unknown>>;
+};
+/** Context provided to a `start` hook. */
+export type DotStartContext<TServices extends Record<string, unknown>> = {
+    pluginName: string;
+    appName: string;
+    services: TServices;
+};
+/** Context provided to a `stop` hook. */
+export type DotStopContext<TServices extends Record<string, unknown>> = {
+    pluginName: string;
+    appName: string;
+    services: TServices;
+};
+/** Context provided to a `dispose` hook. */
+export type DotDisposeContext<TServices extends Record<string, unknown>> = {
+    pluginName: string;
+    appName: string;
+    services: TServices;
+};
+/** Return value of a `boot` hook. */
+export type DotBootResult<TServices extends Record<string, unknown>> = {
+    /** Services this plugin publishes — added to `app.services` and visible to dependent plugins. */
+    services?: TServices;
+};
+/**
+ * The DOT plugin contract.
+ *
+ * Default `TServices` is `Record<string, never>` so plugins that don't publish
+ * services don't have to specify a type argument. Default `TManifest` is the
+ * full contribution shape.
+ */
+export type DotPlugin<TServices extends Record<string, unknown> = Record<string, never>, TManifest extends DotManifestContribution = DotManifestContribution> = {
+    /** Unique identifier for this plugin within the app. */
+    name: string;
+    /** Optional semantic version string. */
+    version?: string;
+    /**
+     * Names of plugins this one depends on.
+     * The kernel ensures dependencies are configured/booted/started first, and
+     * stopped/disposed last.
+     */
+    dependencies?: readonly string[];
+    /** Capability strings this plugin advertises (for `dependencies` resolution by capability). */
+    provides?: readonly string[];
+    /**
+     * Optional static or callback-form manifest contribution. The kernel merges
+     * this into the final manifest after `configure` runs.
+     */
+    manifest?: TManifest | ((ctx: DotManifestContext<TServices>) => TManifest);
+    /**
+     * SYNC registration hook. Declare metadata, register routes/services/jobs.
+     * MUST NOT perform IO, MUST NOT return a Promise.
+     */
+    configure?: (ctx: DotConfigureContext) => void;
+    /** Async open-resources hook. Returns published services for DI. */
+    boot?: (ctx: DotBootContext) => Promise<DotBootResult<TServices>> | DotBootResult<TServices>;
+    /** Async begin-active-work hook. Runs after every plugin's `boot` succeeds. */
+    start?: (ctx: DotStartContext<TServices>) => Promise<void> | void;
+    /** Async halt-active-work hook. Runs in reverse-topological order. */
+    stop?: (ctx: DotStopContext<TServices>) => Promise<void> | void;
+    /** Async release-resources hook. Runs in reverse-topological order. */
+    dispose?: (ctx: DotDisposeContext<TServices>) => Promise<void> | void;
+};
+/**
+ * Type-narrowing helper for plugin authors.
+ *
+ * @example
+ * export const myPlugin = defineDotPlugin<{ db: MyDb }>({
+ *   name: 'my-plugin',
+ *   async boot() {
+ *     const db = await openDb();
+ *     return { services: { db } };
+ *   },
+ *   async dispose({ services }) {
+ *     await services.db.close();
+ *   },
+ * });
+ */
+export declare function defineDotPlugin<TServices extends Record<string, unknown> = Record<string, never>>(plugin: DotPlugin<TServices>): DotPlugin<TServices>;
+/** Internal type alias used by the kernel to erase plugin service generics. */
+export type AnyDotPlugin = DotPlugin<Record<string, unknown>, DotManifestContribution>;
+/** Internal helper: extract the `provides` field from a plugin (always returns an array). */
+export declare function pluginProvides(plugin: AnyDotPlugin): readonly string[];
+/** Internal helper: extract the `dependencies` field from a plugin (always returns an array). */
+export declare function pluginDependencies(plugin: AnyDotPlugin): readonly string[];
+/** Re-exported for downstream typing. */
+export { type DotAppManifest, type PluginManifest } from './manifest.js';
+//# sourceMappingURL=plugin-contract.d.ts.map

package/dist/plugin-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-contract.d.ts","sourceRoot":"","sources":["../src/plugin-contract.ts"],"names":[],"mappings":"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"}

package/dist/plugin-contract.js

@@ -0,0 +1,45 @@
+/**
+ * Public plugin contract for the DOT kernel.
+ *
+ * A `DotPlugin` is a plain object with a name, optional dependency list, and
+ * up to five lifecycle hooks. The kernel calls each hook in dependency order
+ * (or reverse-dependency order for `stop`/`dispose`).
+ *
+ * Design constraints:
+ *
+ *  - `configure` is SYNC. Returning a Promise is an error — the kernel will
+ *    throw {@link DotLifecycleError} with code `DOT_LIFECYCLE_E001`.
+ *  - `boot` may publish services into the app; downstream plugins see them via
+ *    {@link DotBootContext.services}.
+ *  - `stop` and `dispose` continue through individual plugin failures and
+ *    report an aggregate error.
+ */
+/**
+ * Type-narrowing helper for plugin authors.
+ *
+ * @example
+ * export const myPlugin = defineDotPlugin<{ db: MyDb }>({
+ *   name: 'my-plugin',
+ *   async boot() {
+ *     const db = await openDb();
+ *     return { services: { db } };
+ *   },
+ *   async dispose({ services }) {
+ *     await services.db.close();
+ *   },
+ * });
+ */
+export function defineDotPlugin(plugin) {
+    return plugin;
+}
+/** Internal helper: extract the `provides` field from a plugin (always returns an array). */
+export function pluginProvides(plugin) {
+    return plugin.provides ?? [];
+}
+/** Internal helper: extract the `dependencies` field from a plugin (always returns an array). */
+export function pluginDependencies(plugin) {
+    return plugin.dependencies ?? [];
+}
+/** Re-exported for downstream typing. */
+export {} from './manifest.js';
+//# sourceMappingURL=plugin-contract.js.map

package/dist/plugin-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-contract.js","sourceRoot":"","sources":["../src/plugin-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAsJH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA4B;IAE5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAKD,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,OAAO,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,OAAO,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,yCAAyC;AAEzC,OAAO,EAA4C,MAAM,eAAe,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Narrow public surface for plugin authors.
+ *
+ * Exposes the new-kernel plugin contract and the entry points a plugin
+ * author needs to author + test plugins — `defineDotPlugin`, `defineApp`,
+ * `testApp` / `bootTestApp`, plus lifecycle / manifest / diagnostics types.
+ *
+ * Does NOT re-export the legacy `Dot` / `createDot` builder or the legacy
+ * auth/db/event-sourcing modules. Adapter packages (e.g. `@arki/env/dot`,
+ * `@arki/kv/dot`, `@arki/db/dot`) import from this subpath so their
+ * `*.d.ts` graphs do not pull in the legacy surface — keeping their
+ * compile times tight and decoupling adapters from the legacy retirement
+ * schedule (Task 12).
+ *
+ * @example
+ * ```ts
+ * import { defineDotPlugin, type DotPlugin } from '@arki/dot/plugin';
+ * ```
+ */
+export { defineDotPlugin } from './plugin-contract.js';
+export type { AnyDotPlugin, DotPlugin, DotBootContext, DotBootResult, DotConfigureContext, DotDisposeContext, DotManifestContext, DotManifestContribution, DotStartContext, DotStopContext, } from './plugin-contract.js';
+export { defineApp } from './define-app.js';
+export type { DotApp, DotAppBuilder, DotAppConfigured } from './define-app.js';
+export { testApp, bootTestApp } from './test-harness.js';
+export type { TestAppOptions } from './test-harness.js';
+export type { DotLifecycleHook, DotLifecycleState, DotLifecyclePluginFailure, DotLifecycleErrorCodeValue, } from './lifecycle.js';
+export { DotLifecycleError, DotLifecycleErrorCode, DOT_LIFECYCLE_HOOKS } from './lifecycle.js';
+export type { DotAppManifest, PluginManifest, RouteManifest, ServiceManifest, LifecycleManifest, DependencyEdge, DependencyEdgeKind, ServiceKind, RouteTransport, } from './manifest.js';
+export type { DotDiagnosticsSnapshot, PluginDiagnostic, RouteDiagnostic, ServiceDiagnostic, LifecycleDiagnostic, DiagnosticIssue, DiagnosticSeverity, DiagnosticStatus, } from './diagnostics.js';
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE/F,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,24 @@
+/**
+ * Narrow public surface for plugin authors.
+ *
+ * Exposes the new-kernel plugin contract and the entry points a plugin
+ * author needs to author + test plugins — `defineDotPlugin`, `defineApp`,
+ * `testApp` / `bootTestApp`, plus lifecycle / manifest / diagnostics types.
+ *
+ * Does NOT re-export the legacy `Dot` / `createDot` builder or the legacy
+ * auth/db/event-sourcing modules. Adapter packages (e.g. `@arki/env/dot`,
+ * `@arki/kv/dot`, `@arki/db/dot`) import from this subpath so their
+ * `*.d.ts` graphs do not pull in the legacy surface — keeping their
+ * compile times tight and decoupling adapters from the legacy retirement
+ * schedule (Task 12).
+ *
+ * @example
+ * ```ts
+ * import { defineDotPlugin, type DotPlugin } from '@arki/dot/plugin';
+ * ```
+ */
+export { defineDotPlugin } from './plugin-contract.js';
+export { defineApp } from './define-app.js';
+export { testApp, bootTestApp } from './test-harness.js';
+export { DotLifecycleError, DotLifecycleErrorCode, DOT_LIFECYCLE_HOOKS } from './lifecycle.js';
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAcvD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AASzD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/test-harness.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Test harness for unit-testing DOT pips.
+ *
+ * Provides `testApp` — a convenience wrapper that lets pip authors verify
+ * lifecycle behaviour, registration, and service publishing without dragging
+ * in concrete framework dependencies.
+ *
+ * @example
+ *   import { testApp, defineDotPip } from '@arki/dot';
+ *
+ *   const myPip = defineDotPip<{ counter: { value: number } }>({
+ *     name: 'counter',
+ *     async boot() {
+ *       return { services: { counter: { value: 0 } } };
+ *     },
+ *   });
+ *
+ *   it('publishes a counter service', async () => {
+ *     const app = await testApp([myPip]).boot();
+ *     expect(app.services.counter.value).toBe(0);
+ *     await app.dispose();
+ *   });
+ */
+import type { DotApp, DotAppBuilder } from './define-app.js';
+import type { AnyDotPip, DotPip } from './pip-contract.js';
+export type TestAppOptions = {
+    /** App name used in the manifest. Defaults to `'test-app'`. */
+    name?: string;
+    /** Runtime config bag passed to every boot hook. */
+    config?: Readonly<Record<string, unknown>>;
+};
+/**
+ * Build a DOT app builder pre-populated with the given pips, ready to
+ * `.configure()`, `.boot()` or `.start()` from a test.
+ */
+export declare function testApp<TServices extends Record<string, unknown> = Record<string, never>>(pips?: readonly DotPip<never>[] | readonly DotPip<Record<string, never>>[] | readonly AnyDotPip[], options?: TestAppOptions): DotAppBuilder<TServices>;
+/**
+ * Convenience: build, boot, return the running app. Caller is responsible for
+ * calling `app.dispose()` when finished.
+ */
+export declare function bootTestApp<TServices extends Record<string, unknown> = Record<string, never>>(pips?: readonly DotPip<never>[] | readonly DotPip<Record<string, never>>[] | readonly AnyDotPip[], options?: TestAppOptions): Promise<DotApp<TServices>>;
+//# sourceMappingURL=test-harness.d.ts.map

package/dist/test-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-harness.d.ts","sourceRoot":"","sources":["../src/test-harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3D,MAAM,MAAM,cAAc,GAAG;IAC3B,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC5C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,OAAO,CAAC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAGvF,IAAI,GAAE,SAAS,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,SAAS,SAAS,EAAO,EACrG,OAAO,GAAE,cAAmB,GAC3B,aAAa,CAAC,SAAS,CAAC,CAM1B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACjG,IAAI,GAAE,SAAS,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,SAAS,SAAS,EAAO,EACrG,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAE5B"}

package/dist/test-harness.js

@@ -0,0 +1,46 @@
+/**
+ * Test harness for unit-testing DOT pips.
+ *
+ * Provides `testApp` — a convenience wrapper that lets pip authors verify
+ * lifecycle behaviour, registration, and service publishing without dragging
+ * in concrete framework dependencies.
+ *
+ * @example
+ *   import { testApp, defineDotPip } from '@arki/dot';
+ *
+ *   const myPip = defineDotPip<{ counter: { value: number } }>({
+ *     name: 'counter',
+ *     async boot() {
+ *       return { services: { counter: { value: 0 } } };
+ *     },
+ *   });
+ *
+ *   it('publishes a counter service', async () => {
+ *     const app = await testApp([myPip]).boot();
+ *     expect(app.services.counter.value).toBe(0);
+ *     await app.dispose();
+ *   });
+ */
+import { defineApp } from './define-app.js';
+/**
+ * Build a DOT app builder pre-populated with the given pips, ready to
+ * `.configure()`, `.boot()` or `.start()` from a test.
+ */
+export function testApp(
+// Accept any pip shape — tests routinely mix services types. Internally
+// we erase to `AnyDotPip` for the kernel.
+pips = [], options = {}) {
+    let builder = defineApp(options.name ?? 'test-app', { config: options.config });
+    for (const pip of pips) {
+        builder = builder.use(pip);
+    }
+    return builder;
+}
+/**
+ * Convenience: build, boot, return the running app. Caller is responsible for
+ * calling `app.dispose()` when finished.
+ */
+export async function bootTestApp(pips = [], options = {}) {
+    return testApp(pips, options).boot();
+}
+//# sourceMappingURL=test-harness.js.map

package/dist/test-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-harness.js","sourceRoot":"","sources":["../src/test-harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C;;;GAGG;AACH,MAAM,UAAU,OAAO;AACrB,wEAAwE;AACxE,0CAA0C;AAC1C,OAAmG,EAAE,EACrG,UAA0B,EAAE;IAE5B,IAAI,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,IAAI,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAsC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,OAAmC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmG,EAAE,EACrG,UAA0B,EAAE;IAE5B,OAAO,OAAO,CAAY,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/dist/timeline.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ASCII waterfall renderer for DOT lifecycle diagnostics.
+ *
+ * Given a `DotDiagnosticsSnapshot`, builds a compact per-phase, per-pip
+ * duration chart suitable for printing in a terminal or embedding in a
+ * `dot doctor` text report. No colour, no Unicode beyond `█` so the
+ * output stays clean in log aggregators and CI.
+ *
+ * @example
+ * ```
+ * Timeline: my-app (state=booted)
+ * ─────────────────────────────────────────────────────────
+ * configure
+ *   env       0.5ms  █
+ *   db        1.4ms  █████
+ *   kv        0.3ms  █
+ *
+ * boot
+ *   env       2.8ms  █████████
+ *   db       32.9ms  ███████████████████████████████████████████
+ *   kv        3.9ms  ████████████
+ * ─────────────────────────────────────────────────────────
+ * ```
+ *
+ * @see packages/dot/docs/observability.md
+ */
+import type { DotDiagnosticsSnapshot } from './diagnostics.js';
+export type RenderTimelineOptions = {
+    /** Maximum bar width in characters (default `50`). */
+    readonly barWidth?: number;
+    /**
+     * When `true`, also emit any pip's diagnostic `issues[]` underneath
+     * the bar so failure reasons are visible in the timeline view.
+     * Default `true`.
+     */
+    readonly showIssues?: boolean;
+};
+/**
+ * Render the snapshot's lifecycle records as a per-phase waterfall.
+ * Pure — no IO. Caller is responsible for printing the result.
+ */
+export declare function renderTimeline(snapshot: DotDiagnosticsSnapshot, opts?: RenderTimelineOptions): string;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAuB,MAAM,kBAAkB,CAAC;AASpF,MAAM,MAAM,qBAAqB,GAAG;IAClC,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,sBAAsB,EAAE,IAAI,GAAE,qBAA0B,GAAG,MAAM,CA+DzG"}

package/dist/timeline.js

@@ -0,0 +1,121 @@
+/**
+ * ASCII waterfall renderer for DOT lifecycle diagnostics.
+ *
+ * Given a `DotDiagnosticsSnapshot`, builds a compact per-phase, per-pip
+ * duration chart suitable for printing in a terminal or embedding in a
+ * `dot doctor` text report. No colour, no Unicode beyond `█` so the
+ * output stays clean in log aggregators and CI.
+ *
+ * @example
+ * ```
+ * Timeline: my-app (state=booted)
+ * ─────────────────────────────────────────────────────────
+ * configure
+ *   env       0.5ms  █
+ *   db        1.4ms  █████
+ *   kv        0.3ms  █
+ *
+ * boot
+ *   env       2.8ms  █████████
+ *   db       32.9ms  ███████████████████████████████████████████
+ *   kv        3.9ms  ████████████
+ * ─────────────────────────────────────────────────────────
+ * ```
+ *
+ * @see packages/dot/docs/observability.md
+ */
+const PHASE_ORDER = ['configure', 'boot', 'start', 'stop', 'dispose'];
+const BAR_CHAR = '█';
+const DEFAULT_BAR_WIDTH = 50;
+const MIN_BAR_FOR_NONZERO = 1;
+/**
+ * Render the snapshot's lifecycle records as a per-phase waterfall.
+ * Pure — no IO. Caller is responsible for printing the result.
+ */
+export function renderTimeline(snapshot, opts = {}) {
+    const barWidth = opts.barWidth ?? DEFAULT_BAR_WIDTH;
+    const showIssues = opts.showIssues ?? true;
+    // Group lifecycle entries by phase, preserving execution order within
+    // each phase. The kernel pushes entries in execution order; we filter
+    // and re-order here to make the output deterministic when phases are
+    // interleaved (currently they aren't, but be defensive).
+    const byPhase = new Map();
+    for (const entry of snapshot.lifecycle) {
+        const bucket = byPhase.get(entry.hook);
+        if (bucket)
+            bucket.push(entry);
+        else
+            byPhase.set(entry.hook, [entry]);
+    }
+    // Scale: the longest duration across all entries sets the full-width bar.
+    // Using a single global scale lets readers compare durations across
+    // phases at a glance ("boot.db is 10x configure.env").
+    let maxDuration = 0;
+    for (const entry of snapshot.lifecycle) {
+        const d = entry.durationMs ?? 0;
+        if (d > maxDuration)
+            maxDuration = d;
+    }
+    const lines = [];
+    const title = `Timeline: ${snapshot.app.name} (state=${snapshot.app.state})`;
+    lines.push(title);
+    lines.push('─'.repeat(title.length));
+    // Layout: 2-space indent, 10-char pip column, 8-char duration column, then bar.
+    const PIP_COL = 12;
+    const DUR_COL = 8;
+    const indent = '  ';
+    let anyRendered = false;
+    for (const phase of PHASE_ORDER) {
+        const entries = byPhase.get(phase);
+        if (!entries || entries.length === 0)
+            continue;
+        if (anyRendered)
+            lines.push('');
+        anyRendered = true;
+        lines.push(phase);
+        for (const entry of entries) {
+            const durationMs = entry.durationMs ?? 0;
+            const bar = makeBar(durationMs, maxDuration, barWidth);
+            const failedMark = entry.state === 'failed' ? ' ✗' : '';
+            const pipCol = entry.pip.padEnd(PIP_COL);
+            const durCol = formatDuration(durationMs).padStart(DUR_COL);
+            lines.push(`${indent}${pipCol}${durCol}  ${bar}${failedMark}`);
+            if (showIssues && entry.issues.length > 0) {
+                for (const issue of entry.issues) {
+                    lines.push(`${indent}  └─ ${issue.code}: ${issue.message}`);
+                }
+            }
+        }
+    }
+    if (!anyRendered) {
+        lines.push('(no lifecycle entries — app has not run any phase yet)');
+    }
+    else {
+        lines.push('─'.repeat(title.length));
+    }
+    return lines.join('\n');
+}
+/**
+ * Build the bar string. Zero-duration entries get a single block (so they
+ * are still visually present); otherwise width is proportional to the
+ * global max.
+ */
+function makeBar(duration, max, width) {
+    if (max <= 0)
+        return '';
+    if (duration <= 0)
+        return BAR_CHAR.repeat(MIN_BAR_FOR_NONZERO);
+    const cells = Math.max(MIN_BAR_FOR_NONZERO, Math.round((duration / max) * width));
+    return BAR_CHAR.repeat(cells);
+}
+/**
+ * Format a duration in milliseconds with one decimal place. Caps the
+ * decimal at sub-second values; values ≥ 1000ms render as integer ms
+ * to keep the column tight.
+ */
+function formatDuration(ms) {
+    if (ms >= 1000)
+        return `${Math.round(ms)}ms`;
+    return `${ms.toFixed(1)}ms`;
+}
+//# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@arki/dot",
+  "version": "0.1.0",
+  "description": "TypeScript-first application composition framework for the ARKI package family — lifecycle-aware pips, deterministic boot order, manifest/diagnostics envelopes, and an agent-native CLI. A DOT app is the sum of its pips.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arki-labs/arki.git"
+  },
+  "homepage": "https://arki.dev/dot",
+  "bugs": {
+    "url": "https://github.com/arki-labs/arki/issues"
+  },
+  "keywords": [
+    "arki",
+    "typescript",
+    "framework",
+    "pip",
+    "pips",
+    "lifecycle",
+    "diagnostics",
+    "manifest",
+    "agent-native",
+    "dot"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./pip": {
+      "types": "./dist/pip.d.ts",
+      "import": "./dist/pip.js",
+      "default": "./dist/pip.js"
+    },
+    "./package.json": "./package.json",
+    "./cli": {
+      "types": "./dist/cli/index.d.ts",
+      "import": "./src/cli/index.ts",
+      "default": "./dist/cli/index.js"
+    },
+    "./test-harness": {
+      "types": "./dist/test-harness.d.ts",
+      "import": "./src/test-harness.ts",
+      "default": "./dist/test-harness.js"
+    }
+  },
+  "files": [
+    "dist/**",
+    "templates/**",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "dependencies": {
+    "@arki/assert": "0.0.1",
+    "@arki/contracts": "0.0.1",
+    "@arki/log": "0.0.1",
+    "@opentelemetry/api": "^1.9.0",
+    "zod": "4.3.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/templates/app-minimal/.gitignore.tmpl

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+.env
+.env.*
+*.log
+.DS_Store