@terpjs/spec 0.14.0 → 0.15.0

package/corpus/backend/schemas_exclude_sensitive_fields/violation-02/modules/connectors/router.py

@@ -1,8 +1,8 @@
-class ConnectorStatus:
-    name: str
-    api_key: str
-
-
-@router.get('/status', response_model=ConnectorStatus)
-def connector_status() -> ConnectorStatus:
-    return ConnectorStatus()
+class ConnectorStatus:
+    name: str
+    api_key: str
+
+
+@router.get('/status', response_model=ConnectorStatus)
+def connector_status() -> ConnectorStatus:
+    return ConnectorStatus()

package/corpus/backend/schemas_exclude_sensitive_fields/violation-03/expected-findings.json

@@ -1,17 +1,17 @@
-[
-  {
-    "rule": "backend/schemas_exclude_sensitive_fields",
-    "path": "modules/integrations/schemas.py",
-    "line": 5
-  },
-  {
-    "rule": "backend/schemas_exclude_sensitive_fields",
-    "path": "modules/integrations/schemas.py",
-    "line": 6
-  },
-  {
-    "rule": "backend/schemas_exclude_sensitive_fields",
-    "path": "modules/integrations/schemas.py",
-    "line": 7
-  }
-]
+[
+  {
+    "rule": "backend/schemas_exclude_sensitive_fields",
+    "path": "modules/integrations/schemas.py",
+    "line": 5
+  },
+  {
+    "rule": "backend/schemas_exclude_sensitive_fields",
+    "path": "modules/integrations/schemas.py",
+    "line": 6
+  },
+  {
+    "rule": "backend/schemas_exclude_sensitive_fields",
+    "path": "modules/integrations/schemas.py",
+    "line": 7
+  }
+]

package/corpus/backend/schemas_exclude_sensitive_fields/violation-03/modules/integrations/schemas.py

@@ -1,7 +1,7 @@
-from terp.core import BaseSchema
-
-
-class IntegrationRead(BaseSchema):
-    client_secret: str
-    private_key: str
-    refresh_token: str
+from terp.core import BaseSchema
+
+
+class IntegrationRead(BaseSchema):
+    client_secret: str
+    private_key: str
+    refresh_token: str

package/corpus/backend/session_imported_from_sqlmodel/compliant-01/modules/notes/service.py

@@ -1,5 +1,5 @@
-from sqlmodel import Session
-
-
-def note_count(session: Session) -> int:
-    return len(session.exec(query).all())
+from sqlmodel import Session
+
+
+def note_count(session: Session) -> int:
+    return len(session.exec(query).all())

package/corpus/backend/session_imported_from_sqlmodel/violation-01/modules/notes/service.py

@@ -1,5 +1,5 @@
-from sqlalchemy.orm import Session
-
-
-def note_count(session: Session) -> int:
-    return len(session.exec(query).all())
+from sqlalchemy.orm import Session
+
+
+def note_count(session: Session) -> int:
+    return len(session.exec(query).all())

package/corpus/backend/table_models_use_base_table/compliant-01/modules/notes/models.py

@@ -1,6 +1,6 @@
-from sqlmodel import Field
-from terp.core import BaseTable
-
-
-class Note(BaseTable, table=True):
-    title: str = Field(max_length=200)
+from sqlmodel import Field
+from terp.core import BaseTable
+
+
+class Note(BaseTable, table=True):
+    title: str = Field(max_length=200)

package/corpus/backend/table_models_use_base_table/violation-01/modules/notes/models.py

@@ -1,5 +1,5 @@
-from sqlmodel import Field, SQLModel
-
-
-class Note(SQLModel, table=True):
-    title: str = Field(max_length=200)
+from sqlmodel import Field, SQLModel
+
+
+class Note(SQLModel, table=True):
+    title: str = Field(max_length=200)

package/corpus/backend/tables_have_migrations/compliant-01/modules/notes/migrations/versions/0a1b2c3d4e5f_create_notes_tables.py

@@ -1,22 +1,22 @@
-"""create notes tables
-
-Revision ID: 0a1b2c3d4e5f
-Revises:
-"""
-from alembic import op
-import sqlalchemy as sa
-
-revision = "0a1b2c3d4e5f"
-down_revision = None
-
-
-def upgrade() -> None:
-    op.create_table(
-        "note",
-        sa.Column("id", sa.Uuid(), primary_key=True),
-        sa.Column("title", sa.String(length=200), nullable=False),
-    )
-
-
-def downgrade() -> None:
-    op.drop_table("note")
+"""create notes tables
+
+Revision ID: 0a1b2c3d4e5f
+Revises:
+"""
+from alembic import op
+import sqlalchemy as sa
+
+revision = "0a1b2c3d4e5f"
+down_revision = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "note",
+        sa.Column("id", sa.Uuid(), primary_key=True),
+        sa.Column("title", sa.String(length=200), nullable=False),
+    )
+
+
+def downgrade() -> None:
+    op.drop_table("note")

package/corpus/backend/tables_have_migrations/compliant-01/modules/notes/models.py

@@ -1,6 +1,6 @@
-from sqlmodel import Field
-from terp.core import BaseTable
-
-
-class Note(BaseTable, table=True):
-    title: str = Field(max_length=200)
+from sqlmodel import Field
+from terp.core import BaseTable
+
+
+class Note(BaseTable, table=True):
+    title: str = Field(max_length=200)

package/corpus/backend/tables_have_migrations/compliant-02/capabilities/ledger/models.py

@@ -1,6 +1,6 @@
-from sqlmodel import Field
-from terp.core import BaseTable
-
-
-class LedgerEntry(BaseTable, table=True):
-    amount_cents: int = Field(default=0)
+from sqlmodel import Field
+from terp.core import BaseTable
+
+
+class LedgerEntry(BaseTable, table=True):
+    amount_cents: int = Field(default=0)

package/corpus/backend/tables_have_migrations/violation-01/expected-findings.json

@@ -1,7 +1,7 @@
-[
-  {
-    "rule": "backend/tables_have_migrations",
-    "path": "modules/notes/models.py",
-    "line": 5
-  }
-]
+[
+  {
+    "rule": "backend/tables_have_migrations",
+    "path": "modules/notes/models.py",
+    "line": 5
+  }
+]

package/corpus/backend/tables_have_migrations/violation-01/modules/notes/models.py

@@ -1,6 +1,6 @@
-from sqlmodel import Field
-from terp.core import BaseTable
-
-
-class Note(BaseTable, table=True):
-    title: str = Field(max_length=200)
+from sqlmodel import Field
+from terp.core import BaseTable
+
+
+class Note(BaseTable, table=True):
+    title: str = Field(max_length=200)

package/corpus/backend/tables_have_migrations/violation-02/expected-findings.json

@@ -1,7 +1,7 @@
-[
-  {
-    "rule": "backend/tables_have_migrations",
-    "path": "modules/notes/models.py",
-    "line": 5
-  }
-]
+[
+  {
+    "rule": "backend/tables_have_migrations",
+    "path": "modules/notes/models.py",
+    "line": 5
+  }
+]

package/corpus/backend/tables_have_migrations/violation-02/modules/notes/models.py

@@ -1,10 +1,10 @@
-from sqlmodel import Field
-from terp.core import BaseTable
-
-
-class NoteTag(BaseTable, table=True):
-    label: str = Field(max_length=40)
-
-
-class Note(BaseTable, table=True):
-    title: str = Field(max_length=200)
+from sqlmodel import Field
+from terp.core import BaseTable
+
+
+class NoteTag(BaseTable, table=True):
+    label: str = Field(max_length=40)
+
+
+class Note(BaseTable, table=True):
+    title: str = Field(max_length=200)

package/corpus/backend/tenant_scoped_models_use_scoped_service/compliant-01/modules/projects/models.py

@@ -1,6 +1,6 @@
-from sqlmodel import Field
-from terp.core import BaseTable, TenantScopedMixin
-
-
-class Project(BaseTable, TenantScopedMixin, table=True):
-    name: str = Field(max_length=200)
+from sqlmodel import Field
+from terp.core import BaseTable, TenantScopedMixin
+
+
+class Project(BaseTable, TenantScopedMixin, table=True):
+    name: str = Field(max_length=200)

package/corpus/backend/tenant_scoped_models_use_scoped_service/compliant-01/modules/projects/service.py

@@ -1,5 +1,5 @@
-from terp.core import TenantScopedService
-
-
-class ProjectService(TenantScopedService):
-    model = Project
+from terp.core import TenantScopedService
+
+
+class ProjectService(TenantScopedService):
+    model = Project

package/corpus/backend/tenant_scoped_models_use_scoped_service/compliant-02/modules/projects/models.py

@@ -1,8 +1,8 @@
-from sqlmodel import Field
-from terp.core import BaseTable
-
-
-class Attachment(BaseTable, table=True):
-    """Not tenant-scoped (no TenantScopedMixin) — a plain BaseService is fine."""
-
-    name: str = Field(max_length=200)
+from sqlmodel import Field
+from terp.core import BaseTable
+
+
+class Attachment(BaseTable, table=True):
+    """Not tenant-scoped (no TenantScopedMixin) — a plain BaseService is fine."""
+
+    name: str = Field(max_length=200)

package/corpus/backend/tenant_scoped_models_use_scoped_service/compliant-02/modules/projects/service.py

@@ -1,5 +1,5 @@
-from terp.core import BaseService
-
-
-class AttachmentService(BaseService):
-    model = Attachment
+from terp.core import BaseService
+
+
+class AttachmentService(BaseService):
+    model = Attachment

package/corpus/backend/tenant_scoped_models_use_scoped_service/violation-01/modules/projects/models.py

@@ -1,6 +1,6 @@
-from sqlmodel import Field
-from terp.core import BaseTable, TenantScopedMixin
-
-
-class Project(BaseTable, TenantScopedMixin, table=True):
-    name: str = Field(max_length=200)
+from sqlmodel import Field
+from terp.core import BaseTable, TenantScopedMixin
+
+
+class Project(BaseTable, TenantScopedMixin, table=True):
+    name: str = Field(max_length=200)

package/corpus/backend/tenant_scoped_models_use_scoped_service/violation-01/modules/projects/service.py

@@ -1,5 +1,5 @@
-from terp.core import BaseService
-
-
-class ProjectService(BaseService):
-    model = Project
+from terp.core import BaseService
+
+
+class ProjectService(BaseService):
+    model = Project

package/corpus/backend/ungoverned_escape_hatch/compliant-01/modules/notes/service.py

@@ -1,5 +1,5 @@
-from terp.core import BaseService
-
-
-class NoteService(BaseService):
-    model = Note
+from terp.core import BaseService
+
+
+class NoteService(BaseService):
+    model = Note

package/corpus/backend/ungoverned_escape_hatch/compliant-02/modules/notes/service.py

@@ -1,4 +1,4 @@
-def render_help():
-    # Marker-shaped text inside a string is not an opt-out marker: it is neither
-    # honoured nor counted, so this file carries no ungoverned marker.
-    return "suppress with '# arch-allow-no-dynamic-sql: <reason>' after review"
+def render_help():
+    # Marker-shaped text inside a string is not an opt-out marker: it is neither
+    # honoured nor counted, so this file carries no ungoverned marker.
+    return "suppress with '# arch-allow-no-dynamic-sql: <reason>' after review"

package/corpus/backend/ungoverned_escape_hatch/violation-01/modules/notes/service.py

@@ -1,2 +1,2 @@
-def legacy_report(session, sql):
-    return session.execute(text(sql))  # arch-allow-no-dynamic-sql: legacy reporting query, parameterised upstream
+def legacy_report(session, sql):
+    return session.execute(text(sql))  # arch-allow-no-dynamic-sql: legacy reporting query, parameterised upstream

package/corpus/backend/update_schemas_inherit_base_update_schema/compliant-01/modules/notes/schemas.py

@@ -1,2 +1,2 @@
-class NoteUpdate(BaseUpdateSchema):
-    title: str
+class NoteUpdate(BaseUpdateSchema):
+    title: str

package/corpus/backend/update_schemas_inherit_base_update_schema/violation-01/modules/notes/schemas.py

@@ -1,2 +1,2 @@
-class NoteUpdate(BaseSchema):
-    title: str
+class NoteUpdate(BaseSchema):
+    title: str

package/corpus/backend/update_schemas_inherit_base_update_schema/violation-02/modules/notes/schemas.py

@@ -1,5 +1,5 @@
-class NotePatch(BaseSchema):
-    title: str
-
-
-router = build_crud_router(update_schema=NotePatch)
+class NotePatch(BaseSchema):
+    title: str
+
+
+router = build_crud_router(update_schema=NotePatch)

package/corpus/frontend/escape-hatch/compliant-01/src/modules/widgets/Widget.tsx

@@ -1,4 +1,4 @@
-export function Widget() {
-  // terp-allow-token-styled-elements: native button needed for a browser extension host
-  return <button>save</button>;
-}
+export function Widget() {
+  // terp-allow-token-styled-elements: native button needed for a browser extension host
+  return <button>save</button>;
+}

package/corpus/frontend/escape-hatch/violation-01/src/modules/widgets/Widget.tsx

@@ -1,4 +1,4 @@
-// terp-allow-token-styled-elements
-export function Widget() {
-  return <button>save</button>;
-}
+// terp-allow-token-styled-elements
+export function Widget() {
+  return <button>save</button>;
+}

package/corpus/frontend/escape-hatch/violation-02/src/modules/widgets/Widget.tsx

@@ -1,7 +1,7 @@
-export function Widget() {
-  // A marker that names no rule with a governed opt-out (a typo, a stale name,
-  // or the governance rule's own name) is itself a violation - it can never be
-  // budgeted into legitimacy.
-  // terp-allow-made-up-rule: stale name
-  return null;
-}
+export function Widget() {
+  // A marker that names no rule with a governed opt-out (a typo, a stale name,
+  // or the governance rule's own name) is itself a violation - it can never be
+  // budgeted into legitimacy.
+  // terp-allow-made-up-rule: stale name
+  return null;
+}

package/corpus/frontend/escape-hatch/violation-03/src/modules/widgets/Widget.tsx

@@ -1,7 +1,7 @@
-export function Widget() {
-  // A marker spelled with a RETIRED tool-internal rule id (the pre-0.6.0
-  // core-id spelling) names no catalog rule, so it waives nothing: the
-  // violation underneath still fires and the stale marker is itself reported.
-  // terp-allow-no-restricted-syntax: pre-0.6.0 spelling (migrate to the catalog rule name)
-  return <button>x</button>;
-}
+export function Widget() {
+  // A marker spelled with a RETIRED tool-internal rule id (the pre-0.6.0
+  // core-id spelling) names no catalog rule, so it waives nothing: the
+  // violation underneath still fires and the stale marker is itself reported.
+  // terp-allow-no-restricted-syntax: pre-0.6.0 spelling (migrate to the catalog rule name)
+  return <button>x</button>;
+}

package/corpus/frontend/generated-client-only/compliant-01/src/modules/widgets/Widget.tsx

@@ -1,6 +1,6 @@
-import { useTerpClient } from "@terp/react-core";
-export function Widget() {
-  const client = useTerpClient();
-  void client;
-  return null;
-}
+import { useTerpClient } from "@terp/react-core";
+export function Widget() {
+  const client = useTerpClient();
+  void client;
+  return null;
+}

package/corpus/frontend/generated-client-only/compliant-02/src/modules/widgets/Widget.tsx

@@ -1,21 +1,21 @@
-import { useTerpClient } from "@terp/react-core";
-
-const repository = {
-  fetch(id: string): string {
-    return id;
-  },
-  sendBeacon(payload: string): number {
-    return payload.length;
-  },
-};
-
-export function Widget() {
-  const client = useTerpClient();
-  void client;
-  // fetch("/api/notes") would be refused; the typed client is the one egress path.
-  const doc = "WebSocket / XMLHttpRequest / EventSource / fetch are refused in app modules";
-  void doc;
-  void repository.fetch("1");
-  void repository.sendBeacon("x");
-  return null;
-}
+import { useTerpClient } from "@terp/react-core";
+
+const repository = {
+  fetch(id: string): string {
+    return id;
+  },
+  sendBeacon(payload: string): number {
+    return payload.length;
+  },
+};
+
+export function Widget() {
+  const client = useTerpClient();
+  void client;
+  // fetch("/api/notes") would be refused; the typed client is the one egress path.
+  const doc = "WebSocket / XMLHttpRequest / EventSource / fetch are refused in app modules";
+  void doc;
+  void repository.fetch("1");
+  void repository.sendBeacon("x");
+  return null;
+}

package/corpus/frontend/generated-client-only/compliant-03/src/modules/widgets/Widget.tsx

@@ -1,7 +1,7 @@
-export function Widget() {
-  // One catalog rule, one marker: it covers every detection path of the egress
-  // family (bare and window-qualified alike).
-  // terp-allow-generated-client-only: sanctioned probe for a health widget
-  void window.fetch("/healthz");
-  return null;
-}
+export function Widget() {
+  // One catalog rule, one marker: it covers every detection path of the egress
+  // family (bare and window-qualified alike).
+  // terp-allow-generated-client-only: sanctioned probe for a health widget
+  void window.fetch("/healthz");
+  return null;
+}

package/corpus/frontend/generated-client-only/compliant-04/src/modules/widgets/Widget.tsx

@@ -1,17 +1,17 @@
-import { useRealtimeChannel } from "@terp/react-core";
-
-type Notice = { sequence: number; text: string };
-
-function isNotice(value: unknown): value is Notice {
-  if (typeof value !== "object" || value === null) return false;
-  const item = value as Record<string, unknown>;
-  return typeof item.sequence === "number" && typeof item.text === "string";
-}
-
-export function Widget() {
-  const notices = useRealtimeChannel({
-    channel: "system.notices",
-    validate: isNotice,
-  });
-  return <p>{notices.lastMessage?.text ?? "Waiting"}</p>;
-}
+import { useRealtimeChannel } from "@terp/react-core";
+
+type Notice = { sequence: number; text: string };
+
+function isNotice(value: unknown): value is Notice {
+  if (typeof value !== "object" || value === null) return false;
+  const item = value as Record<string, unknown>;
+  return typeof item.sequence === "number" && typeof item.text === "string";
+}
+
+export function Widget() {
+  const notices = useRealtimeChannel({
+    channel: "system.notices",
+    validate: isNotice,
+  });
+  return <p>{notices.lastMessage?.text ?? "Waiting"}</p>;
+}

package/corpus/frontend/generated-client-only/violation-01/src/modules/widgets/Widget.tsx

@@ -1,3 +1,3 @@
-export async function load() {
-  return fetch("/api/notes");
-}
+export async function load() {
+  return fetch("/api/notes");
+}

package/corpus/frontend/generated-client-only/violation-02/src/modules/widgets/Widget.tsx

@@ -1,9 +1,9 @@
-export async function load(path: string) {
-  return globalThis.fetch(path);
-}
-
-export async function loadComputed(path: string) {
-  return window["fetch"](path);
-}
-
-export const transport = fetch;
+export async function load(path: string) {
+  return globalThis.fetch(path);
+}
+
+export async function loadComputed(path: string) {
+  return window["fetch"](path);
+}
+
+export const transport = fetch;

package/corpus/frontend/generated-client-only/violation-03/src/modules/widgets/Widget.tsx

@@ -1,14 +1,14 @@
-export function connect(url: string) {
-  return new WebSocket(
-    url,
-    ["v1"],
-  );
-}
-
-export function subscribe(url: string) {
-  return new window.EventSource(url);
-}
-
-export function flush(url: string, data: string) {
-  navigator.sendBeacon(url, data);
-}
+export function connect(url: string) {
+  return new WebSocket(
+    url,
+    ["v1"],
+  );
+}
+
+export function subscribe(url: string) {
+  return new window.EventSource(url);
+}
+
+export function flush(url: string, data: string) {
+  navigator.sendBeacon(url, data);
+}

package/corpus/frontend/generated-client-only/violation-04/src/modules/widgets/Widget.tsx

@@ -1,6 +1,6 @@
-export function transportFactory() {
-  const Ctor = XMLHttpRequest;
-  return Ctor;
-}
-
-export const events = EventSource;
+export function transportFactory() {
+  const Ctor = XMLHttpRequest;
+  return Ctor;
+}
+
+export const events = EventSource;

package/corpus/frontend/layout-contract/compliant-01/layout-contract.json

@@ -1,3 +1,3 @@
-{
-  "contract": "standard"
-}
+{
+  "contract": "standard"
+}