@hasna/instructions 0.3.0

package/dist/server/openapi.d.ts

@@ -0,0 +1,578 @@
+export declare function buildV1OpenApiDocument(version?: string): {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description: string;
+    };
+    servers: {
+        url: string;
+    }[];
+    components: {
+        securitySchemes: {
+            apiKey: {
+                type: string;
+                in: string;
+                name: string;
+            };
+        };
+        schemas: {
+            Config: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly slug: {
+                        readonly type: "string";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                    };
+                    readonly category: {
+                        readonly type: "string";
+                    };
+                    readonly agent: {
+                        readonly type: "string";
+                    };
+                    readonly target_path: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly outputs: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                        };
+                    };
+                    readonly format: {
+                        readonly type: "string";
+                    };
+                    readonly content: {
+                        readonly type: "string";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly tags: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly is_template: {
+                        readonly type: "boolean";
+                    };
+                    readonly version: {
+                        readonly type: "number";
+                    };
+                    readonly created_at: {
+                        readonly type: "string";
+                    };
+                    readonly updated_at: {
+                        readonly type: "string";
+                    };
+                    readonly synced_at: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                };
+            };
+            Profile: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly slug: {
+                        readonly type: "string";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly selectors: {
+                        readonly type: "object";
+                    };
+                    readonly variables: {
+                        readonly type: "object";
+                    };
+                    readonly created_at: {
+                        readonly type: "string";
+                    };
+                    readonly updated_at: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            CreateConfigInput: {
+                type: string;
+                required: string[];
+                properties: {
+                    name: {
+                        type: string;
+                    };
+                    category: {
+                        type: string;
+                    };
+                    content: {
+                        type: string;
+                    };
+                    kind: {
+                        type: string;
+                    };
+                    agent: {
+                        type: string;
+                    };
+                    target_path: {
+                        type: string;
+                    };
+                    format: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                    tags: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                    is_template: {
+                        type: string;
+                    };
+                };
+            };
+            UpdateConfigInput: {
+                type: string;
+                properties: {
+                    name: {
+                        type: string;
+                    };
+                    category: {
+                        type: string;
+                    };
+                    agent: {
+                        type: string;
+                    };
+                    content: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                    tags: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                    is_template: {
+                        type: string;
+                    };
+                };
+            };
+            CreateProfileInput: {
+                type: string;
+                required: string[];
+                properties: {
+                    name: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                    selectors: {
+                        type: string;
+                    };
+                    variables: {
+                        type: string;
+                    };
+                };
+            };
+        };
+    };
+    security: {
+        apiKey: never[];
+    }[];
+    paths: {
+        "/v1/configs": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        configs: {
+                                            type: string;
+                                            items: {
+                                                $ref: string;
+                                            };
+                                        };
+                                        count: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            post: {
+                operationId: string;
+                summary: string;
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "201": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        config: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/configs/{id}": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        config: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            patch: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        config: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            delete: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        deleted: {
+                                            type: string;
+                                        };
+                                        id: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/configs/{id}/snapshots": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        snapshots: {
+                                            type: string;
+                                            items: {
+                                                type: string;
+                                            };
+                                        };
+                                        count: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            post: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "201": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        snapshot: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/profiles": {
+            get: {
+                operationId: string;
+                summary: string;
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        profiles: {
+                                            type: string;
+                                            items: {
+                                                $ref: string;
+                                            };
+                                        };
+                                        count: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            post: {
+                operationId: string;
+                summary: string;
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "201": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        profile: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/profiles/{id}": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        profile: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            delete: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        deleted: {
+                                            type: string;
+                                        };
+                                        id: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/stats": {
+            get: {
+                operationId: string;
+                summary: string;
+                responses: {
+                    "200": {
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        total: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=openapi.d.ts.map

package/dist/server/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/server/openapi.ts"],"names":[],"mappings":"AA4CA,wBAAgB,sBAAsB,CAAC,OAAO,SAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0NnE"}

package/dist/server/server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.test.d.ts.map

package/dist/server/server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.d.ts","sourceRoot":"","sources":["../../src/server/server.test.ts"],"names":[],"mappings":""}

package/dist/server/v1.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Handle a `/v1/*` request. Authentication + read/write scope enforcement is
+ * performed UPSTREAM by the contracts `honoApiKey` middleware (see
+ * server/index.ts); by the time this runs the caller is an authorized principal.
+ * Returns `null` when the path is not a `/v1` route so the caller can fall
+ * through to other handlers.
+ */
+export declare function handleV1Request(req: Request, url: URL): Promise<Response | null>;
+//# sourceMappingURL=v1.d.ts.map

package/dist/server/v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.d.ts","sourceRoot":"","sources":["../../src/server/v1.ts"],"names":[],"mappings":"AAkCA;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA4HtF"}

package/dist/status.d.ts

@@ -0,0 +1,56 @@
+import type { Database } from "bun:sqlite";
+type ActiveDbEnv = "HASNA_CONFIGS_DB_PATH" | "CONFIGS_DB_PATH" | null;
+type DatabaseKind = "memory" | "file";
+type ContractStatus = "ok" | "warn";
+export interface ConfigsStatusContract {
+    service: "configs";
+    schemaVersion: "1.0";
+    package: {
+        name: string;
+        version: string;
+    };
+    env: {
+        database: {
+            primary: "HASNA_CONFIGS_DB_PATH";
+            fallback: "CONFIGS_DB_PATH";
+            active: ActiveDbEnv;
+            kind: DatabaseKind;
+        };
+    };
+    counts: {
+        configs: {
+            total: number;
+            file: number;
+            reference: number;
+            templates: number;
+        };
+        byCategory: Record<string, number>;
+        byAgent: Record<string, number>;
+        byFormat: Record<string, number>;
+        profiles: number;
+        profileLinks: number;
+        machines: number;
+        snapshots: number;
+        knownTargets: number;
+    };
+    health: {
+        status: ContractStatus;
+        databaseReachable: boolean;
+        driftedTargets: number;
+        missingTargets: number;
+        unredactedSecretFindings: number;
+        hasDrift: boolean;
+        hasMissingTargets: boolean;
+        hasUnredactedSecrets: boolean;
+    };
+    safety: {
+        includesConfigValues: false;
+        includesPrivatePaths: false;
+        includesHostnames: false;
+        includesSecretValues: false;
+        statusOutputIsMetadataOnly: true;
+    };
+}
+export declare function getConfigsStatus(db?: Database): ConfigsStatusContract;
+export {};
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAW3C,KAAK,WAAW,GAAG,uBAAuB,GAAG,iBAAiB,GAAG,IAAI,CAAC;AACtE,KAAK,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AACtC,KAAK,cAAc,GAAG,IAAI,GAAG,MAAM,CAAC;AAEpC,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,SAAS,CAAC;IACnB,aAAa,EAAE,KAAK,CAAC;IACrB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,GAAG,EAAE;QACH,QAAQ,EAAE;YACR,OAAO,EAAE,uBAAuB,CAAC;YACjC,QAAQ,EAAE,iBAAiB,CAAC;YAC5B,MAAM,EAAE,WAAW,CAAC;YACpB,IAAI,EAAE,YAAY,CAAC;SACpB,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE;YACP,KAAK,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC;QACF,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,MAAM,EAAE;QACN,MAAM,EAAE,cAAc,CAAC;QACvB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,wBAAwB,EAAE,MAAM,CAAC;QACjC,QAAQ,EAAE,OAAO,CAAC;QAClB,iBAAiB,EAAE,OAAO,CAAC;QAC3B,oBAAoB,EAAE,OAAO,CAAC;KAC/B,CAAC;IACF,MAAM,EAAE;QACN,oBAAoB,EAAE,KAAK,CAAC;QAC5B,oBAAoB,EAAE,KAAK,CAAC;QAC5B,iBAAiB,EAAE,KAAK,CAAC;QACzB,oBAAoB,EAAE,KAAK,CAAC;QAC5B,0BAA0B,EAAE,IAAI,CAAC;KAClC,CAAC;CACH;AAgCD,wBAAgB,gBAAgB,CAAC,EAAE,GAAE,QAAwB,GAAG,qBAAqB,CAmGpF"}

package/dist/status.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=status.test.d.ts.map

package/dist/status.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.test.d.ts","sourceRoot":"","sources":["../src/status.test.ts"],"names":[],"mappings":""}

package/dist/storage/cloud-store.d.ts

@@ -0,0 +1,17 @@
+import type { TypedQueryClient } from "../generated/storage-kit/index.js";
+import { type Config, type ConfigFilter, type ConfigSnapshot, type CreateConfigInput, type CreateProfileInput, type Profile, type UpdateConfigInput, type UpdateProfileInput } from "../types/index.js";
+export declare function listConfigs(client: TypedQueryClient, filter?: ConfigFilter): Promise<Config[]>;
+export declare function getConfig(client: TypedQueryClient, idOrSlug: string): Promise<Config>;
+export declare function createConfig(client: TypedQueryClient, input: CreateConfigInput): Promise<Config>;
+export declare function updateConfig(client: TypedQueryClient, idOrSlug: string, input: UpdateConfigInput): Promise<Config>;
+export declare function deleteConfig(client: TypedQueryClient, idOrSlug: string): Promise<void>;
+export declare function getConfigStats(client: TypedQueryClient): Promise<Record<string, number>>;
+export declare function createSnapshot(client: TypedQueryClient, idOrSlug: string): Promise<ConfigSnapshot>;
+export declare function listSnapshots(client: TypedQueryClient, idOrSlug: string): Promise<ConfigSnapshot[]>;
+export declare function listProfiles(client: TypedQueryClient): Promise<Profile[]>;
+export declare function getProfile(client: TypedQueryClient, idOrSlug: string): Promise<Profile>;
+export declare function getProfileConfigs(client: TypedQueryClient, idOrSlug: string): Promise<Config[]>;
+export declare function createProfile(client: TypedQueryClient, input: CreateProfileInput): Promise<Profile>;
+export declare function updateProfile(client: TypedQueryClient, idOrSlug: string, input: UpdateProfileInput): Promise<Profile>;
+export declare function deleteProfile(client: TypedQueryClient, idOrSlug: string): Promise<void>;
+//# sourceMappingURL=cloud-store.d.ts.map