@loomstack/core 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,472 @@
+interface FeatureRoute {
+    id: string;
+    path: string;
+    view: string;
+}
+interface FeatureManifest {
+    id: string;
+    name: string;
+    description?: string;
+    entities: string[];
+    routes: FeatureRoute[];
+    actions: string[];
+    queries: string[];
+    permissions?: Record<string, string>;
+}
+interface LoomStackProjectConfig {
+    appName: string;
+    packageManager: "pnpm";
+    frontend: "react";
+    backend: "koa";
+    database: "postgres";
+    featuresDir: string;
+    generatedDir: string;
+}
+interface FrameworkError {
+    code: string;
+    severity: "error" | "warning";
+    message: string;
+    file?: string;
+    location?: {
+        line?: number;
+        column?: number;
+    };
+    repair: string;
+    relatedFiles?: string[];
+    docs?: string;
+}
+interface CommandResult<T = Record<string, unknown>> {
+    ok: boolean;
+    data?: T;
+    errors?: FrameworkError[];
+}
+interface NamedFile {
+    name: string;
+    file: string;
+}
+interface ViewFile extends NamedFile {
+    route?: string;
+}
+interface ScannedFeature {
+    id: string;
+    directory: string;
+    manifestPath: string;
+    manifest: FeatureManifest;
+    schemas: NamedFile[];
+    actions: NamedFile[];
+    queries: NamedFile[];
+    views: ViewFile[];
+    tests: string[];
+}
+interface FeatureGraphNode {
+    id: string;
+    manifest: string;
+    entities: string[];
+    actions: NamedFile[];
+    queries: NamedFile[];
+    views: ViewFile[];
+    tests: string[];
+    routes: string[];
+}
+interface FeatureGraph {
+    features: FeatureGraphNode[];
+    dependencies: Array<{
+        from: string;
+        to: string;
+    }>;
+}
+interface LoomStackProject {
+    root: string;
+    configPath: string;
+    config: LoomStackProjectConfig;
+    features: ScannedFeature[];
+    graph: FeatureGraph;
+}
+interface ScanResult {
+    project?: LoomStackProject;
+    errors: FrameworkError[];
+}
+interface VerifyResult {
+    ok: boolean;
+    errors: FrameworkError[];
+    warnings: FrameworkError[];
+}
+interface GeneratedFileRecord {
+    path: string;
+    sha256: string;
+}
+interface GeneratedFilesManifest {
+    generatedBy: "loomstack";
+    doNotEdit: true;
+    files: GeneratedFileRecord[];
+}
+
+interface ErrorDefinition {
+    title: string;
+    defaultMessage: string;
+    repair: string;
+    docs: string;
+}
+declare const ERROR_CATALOG: {
+    readonly loomstack1001: {
+        readonly title: "Feature ID does not match folder name";
+        readonly defaultMessage: "The feature manifest ID must match its folder name.";
+        readonly repair: "Rename the folder or update feature.yaml so the feature ID matches the folder name.";
+        readonly docs: "implementation-plan/docs/10-verifier-and-error-system.md";
+    };
+    readonly loomstack1002: {
+        readonly title: "Missing or invalid feature manifest field";
+        readonly defaultMessage: "A required feature manifest field is missing or invalid.";
+        readonly repair: "Add the required field to feature.yaml using the canonical manifest shape.";
+        readonly docs: "implementation-plan/docs/03-feature-contract.md";
+    };
+    readonly loomstack1003: {
+        readonly title: "Manifest action is not exported";
+        readonly defaultMessage: "An action declared in the manifest has no implementation.";
+        readonly repair: "Create the action file or update the manifest action name.";
+        readonly docs: "implementation-plan/docs/05-action-query-runtime.md";
+    };
+    readonly loomstack1004: {
+        readonly title: "Exported action is missing from manifest";
+        readonly defaultMessage: "An exported action is not declared in feature.yaml.";
+        readonly repair: "Add the action name to feature.yaml or remove the action implementation.";
+        readonly docs: "implementation-plan/docs/05-action-query-runtime.md";
+    };
+    readonly loomstack1005: {
+        readonly title: "Duplicate route path";
+        readonly defaultMessage: "Route paths must be globally unique.";
+        readonly repair: "Change one route path so every route path is globally unique.";
+        readonly docs: "implementation-plan/docs/03-feature-contract.md";
+    };
+    readonly loomstack1006: {
+        readonly title: "Invalid feature manifest YAML";
+        readonly defaultMessage: "feature.yaml could not be parsed.";
+        readonly repair: "Fix the YAML syntax and run loomstack verify again.";
+        readonly docs: "implementation-plan/docs/03-feature-contract.md";
+    };
+    readonly loomstack1007: {
+        readonly title: "Manifest query is not exported";
+        readonly defaultMessage: "A query declared in the manifest has no implementation.";
+        readonly repair: "Create the query file or update the manifest query name.";
+        readonly docs: "implementation-plan/docs/05-action-query-runtime.md";
+    };
+    readonly loomstack1008: {
+        readonly title: "Exported query is missing from manifest";
+        readonly defaultMessage: "An exported query is not declared in feature.yaml.";
+        readonly repair: "Add the query name to feature.yaml or remove the query implementation.";
+        readonly docs: "implementation-plan/docs/05-action-query-runtime.md";
+    };
+    readonly loomstack1009: {
+        readonly title: "Manifest view is not exported";
+        readonly defaultMessage: "A route references a view that does not exist.";
+        readonly repair: "Create the declared *.view.tsx file or update the route view in feature.yaml.";
+        readonly docs: "implementation-plan/docs/06-react-frontend-adapter.md";
+    };
+    readonly loomstack1010: {
+        readonly title: "Manifest entity is not exported";
+        readonly defaultMessage: "An entity declared in the manifest has no schema export.";
+        readonly repair: "Export the entity from model.schema.ts or update the manifest entity name.";
+        readonly docs: "implementation-plan/docs/04-schema-and-domain-layer.md";
+    };
+    readonly loomstack1011: {
+        readonly title: "Invalid feature name";
+        readonly defaultMessage: "Feature IDs must be kebab-case.";
+        readonly repair: "Use a lowercase kebab-case feature name such as project-notes.";
+        readonly docs: "implementation-plan/docs/03-feature-contract.md";
+    };
+    readonly loomstack2001: {
+        readonly title: "Forbidden database import in UI file";
+        readonly defaultMessage: "Database imports are forbidden in React UI files.";
+        readonly repair: "Move database access into queries/*.query.ts or actions/*.action.ts.";
+        readonly docs: "implementation-plan/docs/10-verifier-and-error-system.md";
+    };
+    readonly loomstack2002: {
+        readonly title: "Forbidden raw fetch in UI file";
+        readonly defaultMessage: "Raw fetch is forbidden in React UI files.";
+        readonly repair: "Use the generated loomstack action/query client.";
+        readonly docs: "implementation-plan/docs/10-verifier-and-error-system.md";
+    };
+    readonly loomstack2003: {
+        readonly title: "Koa import in feature logic";
+        readonly defaultMessage: "Feature logic must be transport-independent.";
+        readonly repair: "Remove the Koa dependency and use LoomStackRequestContext.";
+        readonly docs: "implementation-plan/docs/10-verifier-and-error-system.md";
+    };
+    readonly loomstack3001: {
+        readonly title: "Action input validation failed";
+        readonly defaultMessage: "Action input did not match its schema.";
+        readonly repair: "Send input matching the action input schema.";
+        readonly docs: "implementation-plan/docs/05-action-query-runtime.md";
+    };
+    readonly loomstack3002: {
+        readonly title: "Runtime output validation failed";
+        readonly defaultMessage: "Action or query output did not match its schema.";
+        readonly repair: "Return a value matching the declared output schema.";
+        readonly docs: "implementation-plan/docs/05-action-query-runtime.md";
+    };
+    readonly loomstack3003: {
+        readonly title: "Authentication required";
+        readonly defaultMessage: "This operation requires an authenticated user.";
+        readonly repair: "Authenticate the request before calling this operation.";
+        readonly docs: "implementation-plan/docs/05-action-query-runtime.md";
+    };
+    readonly loomstack4040: {
+        readonly title: "Unknown action";
+        readonly defaultMessage: "The requested action is not registered.";
+        readonly repair: "Use an action declared in feature.yaml and run loomstack generate.";
+        readonly docs: "implementation-plan/docs/07-koa-backend-adapter.md";
+    };
+    readonly loomstack4041: {
+        readonly title: "Unknown query";
+        readonly defaultMessage: "The requested query is not registered.";
+        readonly repair: "Use a query declared in feature.yaml and run loomstack generate.";
+        readonly docs: "implementation-plan/docs/07-koa-backend-adapter.md";
+    };
+    readonly loomstack4050: {
+        readonly title: "Invalid RPC method";
+        readonly defaultMessage: "loomstack RPC endpoints accept only HTTP POST.";
+        readonly repair: "Send the action or query request with HTTP POST.";
+        readonly docs: "implementation-plan/docs/07-koa-backend-adapter.md";
+    };
+    readonly loomstack4001: {
+        readonly title: "Generated file was manually modified";
+        readonly defaultMessage: "A generated file does not match its recorded hash.";
+        readonly repair: "Run loomstack generate or move custom logic out of the generated file.";
+        readonly docs: "implementation-plan/docs/09-code-generation.md";
+    };
+    readonly loomstack4002: {
+        readonly title: "Generated file is stale";
+        readonly defaultMessage: "Generated output does not match current feature contracts.";
+        readonly repair: "Run loomstack generate.";
+        readonly docs: "implementation-plan/docs/09-code-generation.md";
+    };
+    readonly loomstack5001: {
+        readonly title: "Missing loomstack config";
+        readonly defaultMessage: "No loomstack.config.ts was found.";
+        readonly repair: "Create loomstack.config.ts or run the command inside a loomstack project.";
+        readonly docs: "implementation-plan/docs/02-repository-structure.md";
+    };
+    readonly loomstack5002: {
+        readonly title: "Target already exists";
+        readonly defaultMessage: "The requested target already exists.";
+        readonly repair: "Choose another name or remove the existing target first.";
+        readonly docs: "implementation-plan/docs/08-cli-specification.md";
+    };
+    readonly loomstack5003: {
+        readonly title: "Invalid project configuration";
+        readonly defaultMessage: "loomstack.config.ts does not contain the required golden-path values.";
+        readonly repair: "Use React, Koa, PostgreSQL, pnpm, and explicit featuresDir/generatedDir values.";
+        readonly docs: "implementation-plan/docs/02-repository-structure.md";
+    };
+    readonly loomstack6001: {
+        readonly title: "Unsupported PostgreSQL field";
+        readonly defaultMessage: "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+        readonly repair: "Use a supported scalar field or provide explicit persistence logic.";
+        readonly docs: "implementation-plan/docs/04-schema-and-domain-layer.md";
+    };
+};
+type ErrorCode = keyof typeof ERROR_CATALOG;
+declare function frameworkError(code: ErrorCode, options?: {
+    message?: string;
+    severity?: "error" | "warning";
+    file?: string;
+    relatedFiles?: string[];
+    location?: {
+        line?: number;
+        column?: number;
+    };
+}): FrameworkError;
+declare function serializeFrameworkError(error: FrameworkError): FrameworkError;
+declare function explainError(code: string): {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Feature ID does not match folder name";
+    defaultMessage: "The feature manifest ID must match its folder name.";
+    repair: "Rename the folder or update feature.yaml so the feature ID matches the folder name.";
+    docs: "implementation-plan/docs/10-verifier-and-error-system.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Missing or invalid feature manifest field";
+    defaultMessage: "A required feature manifest field is missing or invalid.";
+    repair: "Add the required field to feature.yaml using the canonical manifest shape.";
+    docs: "implementation-plan/docs/03-feature-contract.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Manifest action is not exported";
+    defaultMessage: "An action declared in the manifest has no implementation.";
+    repair: "Create the action file or update the manifest action name.";
+    docs: "implementation-plan/docs/05-action-query-runtime.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Exported action is missing from manifest";
+    defaultMessage: "An exported action is not declared in feature.yaml.";
+    repair: "Add the action name to feature.yaml or remove the action implementation.";
+    docs: "implementation-plan/docs/05-action-query-runtime.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Duplicate route path";
+    defaultMessage: "Route paths must be globally unique.";
+    repair: "Change one route path so every route path is globally unique.";
+    docs: "implementation-plan/docs/03-feature-contract.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Invalid feature manifest YAML";
+    defaultMessage: "feature.yaml could not be parsed.";
+    repair: "Fix the YAML syntax and run loomstack verify again.";
+    docs: "implementation-plan/docs/03-feature-contract.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Manifest query is not exported";
+    defaultMessage: "A query declared in the manifest has no implementation.";
+    repair: "Create the query file or update the manifest query name.";
+    docs: "implementation-plan/docs/05-action-query-runtime.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Exported query is missing from manifest";
+    defaultMessage: "An exported query is not declared in feature.yaml.";
+    repair: "Add the query name to feature.yaml or remove the query implementation.";
+    docs: "implementation-plan/docs/05-action-query-runtime.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Manifest view is not exported";
+    defaultMessage: "A route references a view that does not exist.";
+    repair: "Create the declared *.view.tsx file or update the route view in feature.yaml.";
+    docs: "implementation-plan/docs/06-react-frontend-adapter.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Manifest entity is not exported";
+    defaultMessage: "An entity declared in the manifest has no schema export.";
+    repair: "Export the entity from model.schema.ts or update the manifest entity name.";
+    docs: "implementation-plan/docs/04-schema-and-domain-layer.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Invalid feature name";
+    defaultMessage: "Feature IDs must be kebab-case.";
+    repair: "Use a lowercase kebab-case feature name such as project-notes.";
+    docs: "implementation-plan/docs/03-feature-contract.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Forbidden database import in UI file";
+    defaultMessage: "Database imports are forbidden in React UI files.";
+    repair: "Move database access into queries/*.query.ts or actions/*.action.ts.";
+    docs: "implementation-plan/docs/10-verifier-and-error-system.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Forbidden raw fetch in UI file";
+    defaultMessage: "Raw fetch is forbidden in React UI files.";
+    repair: "Use the generated loomstack action/query client.";
+    docs: "implementation-plan/docs/10-verifier-and-error-system.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Koa import in feature logic";
+    defaultMessage: "Feature logic must be transport-independent.";
+    repair: "Remove the Koa dependency and use LoomStackRequestContext.";
+    docs: "implementation-plan/docs/10-verifier-and-error-system.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Action input validation failed";
+    defaultMessage: "Action input did not match its schema.";
+    repair: "Send input matching the action input schema.";
+    docs: "implementation-plan/docs/05-action-query-runtime.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Runtime output validation failed";
+    defaultMessage: "Action or query output did not match its schema.";
+    repair: "Return a value matching the declared output schema.";
+    docs: "implementation-plan/docs/05-action-query-runtime.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Authentication required";
+    defaultMessage: "This operation requires an authenticated user.";
+    repair: "Authenticate the request before calling this operation.";
+    docs: "implementation-plan/docs/05-action-query-runtime.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Unknown action";
+    defaultMessage: "The requested action is not registered.";
+    repair: "Use an action declared in feature.yaml and run loomstack generate.";
+    docs: "implementation-plan/docs/07-koa-backend-adapter.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Unknown query";
+    defaultMessage: "The requested query is not registered.";
+    repair: "Use a query declared in feature.yaml and run loomstack generate.";
+    docs: "implementation-plan/docs/07-koa-backend-adapter.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Invalid RPC method";
+    defaultMessage: "loomstack RPC endpoints accept only HTTP POST.";
+    repair: "Send the action or query request with HTTP POST.";
+    docs: "implementation-plan/docs/07-koa-backend-adapter.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Generated file was manually modified";
+    defaultMessage: "A generated file does not match its recorded hash.";
+    repair: "Run loomstack generate or move custom logic out of the generated file.";
+    docs: "implementation-plan/docs/09-code-generation.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Generated file is stale";
+    defaultMessage: "Generated output does not match current feature contracts.";
+    repair: "Run loomstack generate.";
+    docs: "implementation-plan/docs/09-code-generation.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Missing loomstack config";
+    defaultMessage: "No loomstack.config.ts was found.";
+    repair: "Create loomstack.config.ts or run the command inside a loomstack project.";
+    docs: "implementation-plan/docs/02-repository-structure.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Target already exists";
+    defaultMessage: "The requested target already exists.";
+    repair: "Choose another name or remove the existing target first.";
+    docs: "implementation-plan/docs/08-cli-specification.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Invalid project configuration";
+    defaultMessage: "loomstack.config.ts does not contain the required golden-path values.";
+    repair: "Use React, Koa, PostgreSQL, pnpm, and explicit featuresDir/generatedDir values.";
+    docs: "implementation-plan/docs/02-repository-structure.md";
+    code: string;
+} | {
+    why: "The feature manifest ID must match its folder name." | "A required feature manifest field is missing or invalid." | "An action declared in the manifest has no implementation." | "An exported action is not declared in feature.yaml." | "Route paths must be globally unique." | "feature.yaml could not be parsed." | "A query declared in the manifest has no implementation." | "An exported query is not declared in feature.yaml." | "A route references a view that does not exist." | "An entity declared in the manifest has no schema export." | "Feature IDs must be kebab-case." | "Database imports are forbidden in React UI files." | "Raw fetch is forbidden in React UI files." | "Feature logic must be transport-independent." | "Action input did not match its schema." | "Action or query output did not match its schema." | "This operation requires an authenticated user." | "The requested action is not registered." | "The requested query is not registered." | "loomstack RPC endpoints accept only HTTP POST." | "A generated file does not match its recorded hash." | "Generated output does not match current feature contracts." | "No loomstack.config.ts was found." | "The requested target already exists." | "loomstack.config.ts does not contain the required golden-path values." | "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    title: "Unsupported PostgreSQL field";
+    defaultMessage: "An entity field cannot be represented by the v0.1 PostgreSQL adapter.";
+    repair: "Use a supported scalar field or provide explicit persistence logic.";
+    docs: "implementation-plan/docs/04-schema-and-domain-layer.md";
+    code: string;
+} | undefined;
+
+declare function toProjectPath(path: string): string;
+declare function discoverProjectRoot(start: string): string | undefined;
+declare function loadProjectConfig(root: string): {
+    config?: LoomStackProjectConfig;
+    errors: ReturnType<typeof frameworkError>[];
+};
+declare function scanProject(rootInput: string): ScanResult;
+
+export { type CommandResult, ERROR_CATALOG, type ErrorCode, type ErrorDefinition, type FeatureGraph, type FeatureGraphNode, type FeatureManifest, type FeatureRoute, type FrameworkError, type GeneratedFileRecord, type GeneratedFilesManifest, type LoomStackProject, type LoomStackProjectConfig, type NamedFile, type ScanResult, type ScannedFeature, type VerifyResult, type ViewFile, discoverProjectRoot, explainError, frameworkError, loadProjectConfig, scanProject, serializeFrameworkError, toProjectPath };

package/dist/index.js

@@ -0,0 +1,415 @@
+// src/errors.ts
+var ERROR_CATALOG = {
+  loomstack1001: {
+    title: "Feature ID does not match folder name",
+    defaultMessage: "The feature manifest ID must match its folder name.",
+    repair: "Rename the folder or update feature.yaml so the feature ID matches the folder name.",
+    docs: "implementation-plan/docs/10-verifier-and-error-system.md"
+  },
+  loomstack1002: {
+    title: "Missing or invalid feature manifest field",
+    defaultMessage: "A required feature manifest field is missing or invalid.",
+    repair: "Add the required field to feature.yaml using the canonical manifest shape.",
+    docs: "implementation-plan/docs/03-feature-contract.md"
+  },
+  loomstack1003: {
+    title: "Manifest action is not exported",
+    defaultMessage: "An action declared in the manifest has no implementation.",
+    repair: "Create the action file or update the manifest action name.",
+    docs: "implementation-plan/docs/05-action-query-runtime.md"
+  },
+  loomstack1004: {
+    title: "Exported action is missing from manifest",
+    defaultMessage: "An exported action is not declared in feature.yaml.",
+    repair: "Add the action name to feature.yaml or remove the action implementation.",
+    docs: "implementation-plan/docs/05-action-query-runtime.md"
+  },
+  loomstack1005: {
+    title: "Duplicate route path",
+    defaultMessage: "Route paths must be globally unique.",
+    repair: "Change one route path so every route path is globally unique.",
+    docs: "implementation-plan/docs/03-feature-contract.md"
+  },
+  loomstack1006: {
+    title: "Invalid feature manifest YAML",
+    defaultMessage: "feature.yaml could not be parsed.",
+    repair: "Fix the YAML syntax and run loomstack verify again.",
+    docs: "implementation-plan/docs/03-feature-contract.md"
+  },
+  loomstack1007: {
+    title: "Manifest query is not exported",
+    defaultMessage: "A query declared in the manifest has no implementation.",
+    repair: "Create the query file or update the manifest query name.",
+    docs: "implementation-plan/docs/05-action-query-runtime.md"
+  },
+  loomstack1008: {
+    title: "Exported query is missing from manifest",
+    defaultMessage: "An exported query is not declared in feature.yaml.",
+    repair: "Add the query name to feature.yaml or remove the query implementation.",
+    docs: "implementation-plan/docs/05-action-query-runtime.md"
+  },
+  loomstack1009: {
+    title: "Manifest view is not exported",
+    defaultMessage: "A route references a view that does not exist.",
+    repair: "Create the declared *.view.tsx file or update the route view in feature.yaml.",
+    docs: "implementation-plan/docs/06-react-frontend-adapter.md"
+  },
+  loomstack1010: {
+    title: "Manifest entity is not exported",
+    defaultMessage: "An entity declared in the manifest has no schema export.",
+    repair: "Export the entity from model.schema.ts or update the manifest entity name.",
+    docs: "implementation-plan/docs/04-schema-and-domain-layer.md"
+  },
+  loomstack1011: {
+    title: "Invalid feature name",
+    defaultMessage: "Feature IDs must be kebab-case.",
+    repair: "Use a lowercase kebab-case feature name such as project-notes.",
+    docs: "implementation-plan/docs/03-feature-contract.md"
+  },
+  loomstack2001: {
+    title: "Forbidden database import in UI file",
+    defaultMessage: "Database imports are forbidden in React UI files.",
+    repair: "Move database access into queries/*.query.ts or actions/*.action.ts.",
+    docs: "implementation-plan/docs/10-verifier-and-error-system.md"
+  },
+  loomstack2002: {
+    title: "Forbidden raw fetch in UI file",
+    defaultMessage: "Raw fetch is forbidden in React UI files.",
+    repair: "Use the generated loomstack action/query client.",
+    docs: "implementation-plan/docs/10-verifier-and-error-system.md"
+  },
+  loomstack2003: {
+    title: "Koa import in feature logic",
+    defaultMessage: "Feature logic must be transport-independent.",
+    repair: "Remove the Koa dependency and use LoomStackRequestContext.",
+    docs: "implementation-plan/docs/10-verifier-and-error-system.md"
+  },
+  loomstack3001: {
+    title: "Action input validation failed",
+    defaultMessage: "Action input did not match its schema.",
+    repair: "Send input matching the action input schema.",
+    docs: "implementation-plan/docs/05-action-query-runtime.md"
+  },
+  loomstack3002: {
+    title: "Runtime output validation failed",
+    defaultMessage: "Action or query output did not match its schema.",
+    repair: "Return a value matching the declared output schema.",
+    docs: "implementation-plan/docs/05-action-query-runtime.md"
+  },
+  loomstack3003: {
+    title: "Authentication required",
+    defaultMessage: "This operation requires an authenticated user.",
+    repair: "Authenticate the request before calling this operation.",
+    docs: "implementation-plan/docs/05-action-query-runtime.md"
+  },
+  loomstack4040: {
+    title: "Unknown action",
+    defaultMessage: "The requested action is not registered.",
+    repair: "Use an action declared in feature.yaml and run loomstack generate.",
+    docs: "implementation-plan/docs/07-koa-backend-adapter.md"
+  },
+  loomstack4041: {
+    title: "Unknown query",
+    defaultMessage: "The requested query is not registered.",
+    repair: "Use a query declared in feature.yaml and run loomstack generate.",
+    docs: "implementation-plan/docs/07-koa-backend-adapter.md"
+  },
+  loomstack4050: {
+    title: "Invalid RPC method",
+    defaultMessage: "loomstack RPC endpoints accept only HTTP POST.",
+    repair: "Send the action or query request with HTTP POST.",
+    docs: "implementation-plan/docs/07-koa-backend-adapter.md"
+  },
+  loomstack4001: {
+    title: "Generated file was manually modified",
+    defaultMessage: "A generated file does not match its recorded hash.",
+    repair: "Run loomstack generate or move custom logic out of the generated file.",
+    docs: "implementation-plan/docs/09-code-generation.md"
+  },
+  loomstack4002: {
+    title: "Generated file is stale",
+    defaultMessage: "Generated output does not match current feature contracts.",
+    repair: "Run loomstack generate.",
+    docs: "implementation-plan/docs/09-code-generation.md"
+  },
+  loomstack5001: {
+    title: "Missing loomstack config",
+    defaultMessage: "No loomstack.config.ts was found.",
+    repair: "Create loomstack.config.ts or run the command inside a loomstack project.",
+    docs: "implementation-plan/docs/02-repository-structure.md"
+  },
+  loomstack5002: {
+    title: "Target already exists",
+    defaultMessage: "The requested target already exists.",
+    repair: "Choose another name or remove the existing target first.",
+    docs: "implementation-plan/docs/08-cli-specification.md"
+  },
+  loomstack5003: {
+    title: "Invalid project configuration",
+    defaultMessage: "loomstack.config.ts does not contain the required golden-path values.",
+    repair: "Use React, Koa, PostgreSQL, pnpm, and explicit featuresDir/generatedDir values.",
+    docs: "implementation-plan/docs/02-repository-structure.md"
+  },
+  loomstack6001: {
+    title: "Unsupported PostgreSQL field",
+    defaultMessage: "An entity field cannot be represented by the v0.1 PostgreSQL adapter.",
+    repair: "Use a supported scalar field or provide explicit persistence logic.",
+    docs: "implementation-plan/docs/04-schema-and-domain-layer.md"
+  }
+};
+function frameworkError(code, options = {}) {
+  const definition = ERROR_CATALOG[code];
+  return {
+    code,
+    severity: options.severity ?? "error",
+    message: options.message ?? definition.defaultMessage,
+    repair: definition.repair,
+    docs: definition.docs,
+    ...options.file ? { file: options.file } : {},
+    ...options.relatedFiles ? { relatedFiles: options.relatedFiles } : {},
+    ...options.location ? { location: options.location } : {}
+  };
+}
+function serializeFrameworkError(error) {
+  return JSON.parse(JSON.stringify(error));
+}
+function explainError(code) {
+  const definition = ERROR_CATALOG[code];
+  if (!definition) return void 0;
+  return { code, ...definition, why: definition.defaultMessage };
+}
+
+// src/scanner.ts
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
+import { dirname, join, relative, resolve, sep } from "path";
+import { parse } from "yaml";
+var FEATURE_ID = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+var DEFAULT_CONFIG = {
+  packageManager: "pnpm",
+  frontend: "react",
+  backend: "koa",
+  database: "postgres",
+  featuresDir: "features",
+  generatedDir: ".loomstack"
+};
+function toProjectPath(path) {
+  return path.split(sep).join("/");
+}
+function discoverProjectRoot(start) {
+  let current = resolve(start);
+  while (true) {
+    if (existsSync(join(current, "loomstack.config.ts"))) return current;
+    const parent = dirname(current);
+    if (parent === current) return void 0;
+    current = parent;
+  }
+}
+function quotedValue(source, key) {
+  const match = source.match(new RegExp(`${key}\\s*:\\s*["']([^"']+)["']`));
+  return match?.[1];
+}
+function loadProjectConfig(root) {
+  const configPath = join(root, "loomstack.config.ts");
+  if (!existsSync(configPath)) {
+    return { errors: [frameworkError("loomstack5001", { file: "loomstack.config.ts" })] };
+  }
+  const source = readFileSync(configPath, "utf8");
+  const appName = quotedValue(source, "appName");
+  const values = {
+    packageManager: quotedValue(source, "packageManager"),
+    frontend: quotedValue(source, "frontend"),
+    backend: quotedValue(source, "backend"),
+    database: quotedValue(source, "database"),
+    featuresDir: quotedValue(source, "featuresDir"),
+    generatedDir: quotedValue(source, "generatedDir")
+  };
+  if (!appName || values.packageManager !== DEFAULT_CONFIG.packageManager || values.frontend !== DEFAULT_CONFIG.frontend || values.backend !== DEFAULT_CONFIG.backend || values.database !== DEFAULT_CONFIG.database || values.featuresDir !== DEFAULT_CONFIG.featuresDir || values.generatedDir !== DEFAULT_CONFIG.generatedDir) {
+    return { errors: [frameworkError("loomstack5003", { file: "loomstack.config.ts" })] };
+  }
+  return {
+    config: {
+      appName,
+      packageManager: "pnpm",
+      frontend: "react",
+      backend: "koa",
+      database: "postgres",
+      featuresDir: values.featuresDir,
+      generatedDir: values.generatedDir
+    },
+    errors: []
+  };
+}
+function filesIn(directory, suffix) {
+  if (!existsSync(directory)) return [];
+  return readdirSync(directory).filter((name) => name.endsWith(suffix) && statSync(join(directory, name)).isFile()).sort().map((name) => join(directory, name));
+}
+function discoverNamedFiles(root, directory, suffix, kind) {
+  const expression = new RegExp(`export\\s+const\\s+([A-Za-z_$][\\w$]*)\\s*=\\s*${kind}\\b`);
+  return filesIn(directory, suffix).flatMap((file) => {
+    const match = readFileSync(file, "utf8").match(expression);
+    return match?.[1] ? [{ name: match[1], file: toProjectPath(relative(root, file)) }] : [];
+  });
+}
+function discoverViews(root, directory) {
+  return filesIn(directory, ".view.tsx").flatMap((file) => {
+    const source = readFileSync(file, "utf8");
+    const loomStackName = source.match(/\bname\s*:\s*["']([A-Za-z_$][\w$]*)["']/)?.[1];
+    const namedExport = source.match(/export\s+const\s+([A-Za-z_$][\w$]*)\s*=\s*view\s*\(/)?.[1];
+    const name = loomStackName ?? namedExport;
+    return name ? [{ name, file: toProjectPath(relative(root, file)) }] : [];
+  });
+}
+function discoverSchemas(root, featureDirectory) {
+  const file = join(featureDirectory, "model.schema.ts");
+  if (!existsSync(file)) return [];
+  const source = readFileSync(file, "utf8");
+  return [...source.matchAll(/export\s+const\s+([A-Za-z_$][\w$]*)Schema\s*=\s*entity\s*\(\s*["']([^"']+)["']/g)].map((match) => ({ name: match[2] ?? match[1] ?? "", file: toProjectPath(relative(root, file)) })).filter((item) => item.name);
+}
+function validateManifest(value, manifestPath, folderName) {
+  const errors = [];
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return { errors: [frameworkError("loomstack1002", { file: manifestPath })] };
+  }
+  const input = value;
+  const requiredStrings = ["id", "name"];
+  for (const key of requiredStrings) {
+    if (typeof input[key] !== "string" || input[key].length === 0) {
+      errors.push(frameworkError("loomstack1002", { message: `Missing or invalid required field: ${key}.`, file: manifestPath }));
+    }
+  }
+  for (const key of ["entities", "routes", "actions", "queries"]) {
+    if (!Array.isArray(input[key])) {
+      errors.push(frameworkError("loomstack1002", { message: `Missing or invalid required array: ${key}.`, file: manifestPath }));
+    }
+  }
+  if (errors.length > 0) return { errors };
+  const id = input.id;
+  if (!FEATURE_ID.test(id)) errors.push(frameworkError("loomstack1011", { file: manifestPath }));
+  if (id !== folderName) {
+    errors.push(frameworkError("loomstack1001", { message: `Feature ID "${id}" does not match folder "${folderName}".`, file: manifestPath }));
+  }
+  if (input.description !== void 0 && typeof input.description !== "string") {
+    errors.push(frameworkError("loomstack1002", { message: "description must be a string when provided.", file: manifestPath }));
+  }
+  if (input.permissions !== void 0 && (!input.permissions || typeof input.permissions !== "object" || Array.isArray(input.permissions) || Object.values(input.permissions).some((value2) => typeof value2 !== "string"))) {
+    errors.push(frameworkError("loomstack1002", { message: "permissions must map string names to string requirements.", file: manifestPath }));
+  }
+  for (const key of ["entities", "actions", "queries"]) {
+    const values = input[key];
+    if (values.some((value2) => typeof value2 !== "string" || value2.length === 0) || new Set(values).size !== values.length) {
+      errors.push(frameworkError("loomstack1002", { message: `${key} must contain unique, non-empty strings.`, file: manifestPath }));
+    }
+  }
+  if (input.entities.some((name) => !/^[A-Z][A-Za-z0-9]*$/.test(name))) {
+    errors.push(frameworkError("loomstack1002", { message: "Entity names must be PascalCase identifiers.", file: manifestPath }));
+  }
+  for (const key of ["actions", "queries"]) {
+    if (input[key].some((name) => !/^[A-Za-z_$][\w$]*$/.test(name))) {
+      errors.push(frameworkError("loomstack1002", { message: `${key} names must be JavaScript identifiers.`, file: manifestPath }));
+    }
+  }
+  const routes = input.routes;
+  const routeIds = /* @__PURE__ */ new Set();
+  for (const route of routes) {
+    if (!route || typeof route !== "object") {
+      errors.push(frameworkError("loomstack1002", { message: "Every route must be an object with id, path, and view.", file: manifestPath }));
+      continue;
+    }
+    const candidate = route;
+    if (["id", "path", "view"].some((key) => typeof candidate[key] !== "string" || candidate[key].length === 0)) {
+      errors.push(frameworkError("loomstack1002", { message: "Every route requires string id, path, and view fields.", file: manifestPath }));
+    } else if (!candidate.path.startsWith("/") || !/^[A-Za-z_$][\w$]*$/.test(candidate.view)) {
+      errors.push(frameworkError("loomstack1002", { message: "Route paths must start with / and route views must be JavaScript identifiers.", file: manifestPath }));
+    }
+    if (typeof candidate.id === "string") {
+      if (routeIds.has(candidate.id)) errors.push(frameworkError("loomstack1002", { message: `Duplicate route ID: ${candidate.id}.`, file: manifestPath }));
+      routeIds.add(candidate.id);
+    }
+  }
+  if (errors.length > 0) return { errors };
+  return { manifest: input, errors };
+}
+function scanProject(rootInput) {
+  const root = resolve(rootInput);
+  const loaded = loadProjectConfig(root);
+  if (!loaded.config) return { errors: loaded.errors };
+  const config = loaded.config;
+  const featuresDirectory = join(root, config.featuresDir);
+  const errors = [...loaded.errors];
+  const features = [];
+  if (existsSync(featuresDirectory)) {
+    const featureFolders = readdirSync(featuresDirectory).filter((name) => statSync(join(featuresDirectory, name)).isDirectory()).sort();
+    for (const folderName of featureFolders) {
+      const directory = join(featuresDirectory, folderName);
+      const absoluteManifest = join(directory, "feature.yaml");
+      if (!existsSync(absoluteManifest)) continue;
+      const manifestPath = toProjectPath(relative(root, absoluteManifest));
+      let raw;
+      try {
+        raw = parse(readFileSync(absoluteManifest, "utf8"));
+      } catch (error) {
+        errors.push(frameworkError("loomstack1006", { message: `Invalid YAML: ${error instanceof Error ? error.message : String(error)}`, file: manifestPath }));
+        continue;
+      }
+      const validated = validateManifest(raw, manifestPath, folderName);
+      errors.push(...validated.errors);
+      if (!validated.manifest) continue;
+      const feature = {
+        id: folderName,
+        directory: toProjectPath(relative(root, directory)),
+        manifestPath,
+        manifest: validated.manifest,
+        schemas: discoverSchemas(root, directory),
+        actions: discoverNamedFiles(root, join(directory, "actions"), ".action.ts", "action"),
+        queries: discoverNamedFiles(root, join(directory, "queries"), ".query.ts", "query"),
+        views: discoverViews(root, join(directory, "ui")),
+        tests: filesIn(join(directory, "tests"), ".test.ts").map((file) => toProjectPath(relative(root, file)))
+      };
+      feature.views = feature.views.map((view) => {
+        const route = feature.manifest.routes.find((candidate) => candidate.view === view.name)?.path;
+        return route ? { ...view, route } : view;
+      });
+      features.push(feature);
+    }
+  }
+  const paths = /* @__PURE__ */ new Map();
+  for (const feature of features) {
+    for (const route of feature.manifest.routes) {
+      const owner = paths.get(route.path);
+      if (owner) {
+        errors.push(frameworkError("loomstack1005", {
+          message: `Route path "${route.path}" is declared by both ${owner} and ${feature.id}.`,
+          file: feature.manifestPath,
+          relatedFiles: [features.find((item) => item.id === owner)?.manifestPath ?? owner]
+        }));
+      } else paths.set(route.path, feature.id);
+    }
+  }
+  const graph = {
+    features: features.map((feature) => ({
+      id: feature.id,
+      manifest: feature.manifestPath,
+      entities: [...feature.manifest.entities].sort(),
+      actions: [...feature.actions].sort((a, b) => a.name.localeCompare(b.name)),
+      queries: [...feature.queries].sort((a, b) => a.name.localeCompare(b.name)),
+      views: [...feature.views].sort((a, b) => a.name.localeCompare(b.name)),
+      tests: [...feature.tests].sort(),
+      routes: feature.manifest.routes.map((route) => route.path).sort()
+    })),
+    dependencies: []
+  };
+  return {
+    project: { root, configPath: "loomstack.config.ts", config, features, graph },
+    errors
+  };
+}
+export {
+  ERROR_CATALOG,
+  discoverProjectRoot,
+  explainError,
+  frameworkError,
+  loadProjectConfig,
+  scanProject,
+  serializeFrameworkError,
+  toProjectPath
+};

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@loomstack/core",
+  "version": "0.0.1",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "yaml": "^2.8.1"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "test": "vitest run"
+  }
+}