@danypops/papyrus 0.44.8 → 0.44.9

package/src/modules/discuss.ts

@@ -3,8 +3,8 @@
  * domain/discussion.ts and discussion-service.ts for the full design.
  */
 
-import type { Discussions } from "../discussion-service.ts";
-import type { ArtifactEventContext } from "../domain/artifact-event.ts";
+import type { ArtifactEventContext } from "../artifact/artifact-event.ts";
+import type { Discussions } from "../discussion/discussion-service.ts";
 import type { OperationDefinition } from "../module-registry.ts";
 
 const MODULE_ID = "discuss";

package/src/modules/docs.ts

@@ -6,6 +6,9 @@
  * Imports only src/domain-services.ts's Doc functions, which are already generic
  * ArtifactStore-based with no other module's concrete class dependency.
  */
+
+import type { ArtifactScopeStore } from "../artifact/artifact-scope-store.ts";
+import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import type { AuthorityRegistry } from "../authority-registry.ts";
 import {
 	assignDocumentProject,
@@ -18,8 +21,6 @@ import {
 	updateDocument,
 } from "../domain-services.ts";
 import type { OperationDefinition } from "../module-registry.ts";
-import type { ArtifactScopeStore } from "../ports/artifact-scope-store.ts";
-import type { ArtifactStore } from "../ports/artifact-store.ts";
 
 const MODULE_ID = "docs";
 

package/src/modules/graph-projection.ts

@@ -5,6 +5,8 @@
  * src/domain/graph-projection.ts and src/graph-projection-service.ts for the protocol
  * itself; this file only parses/validates raw operation input into that typed shape.
  */
+
+import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import type { AuthorityRegistry } from "../authority-registry.ts";
 import type {
 	GRAPH_PROJECTION_SCHEMA_VERSION,
@@ -12,10 +14,9 @@ import type {
 	ProjectedArtifact,
 	ProjectedEdge,
 } from "../domain/graph-projection.ts";
-import { GraphProjection } from "../graph-projection-service.ts";
+import { GraphProjection } from "../graph-projection/graph-projection-service.ts";
 import type { OperationDefinition } from "../module-registry.ts";
-import type { ArtifactStore } from "../ports/artifact-store.ts";
-import type { GraphProjectionStore } from "../ports/graph-projection-store.ts";
+import type { GraphProjectionStore } from "../stores/graph-projection-store.ts";
 
 const MODULE_ID = "graph_projection";
 

package/src/modules/logs.ts

@@ -6,7 +6,7 @@
  * comment on why `log` is not an Artifact kind).
  */
 import type { JsonValue, LogLevel } from "../domain/log-entry.ts";
-import type { Logs } from "../log-service.ts";
+import type { Logs } from "../log/log-service.ts";
 import type { OperationDefinition } from "../module-registry.ts";
 
 const MODULE_ID = "logs";

package/src/modules/notes.ts

@@ -15,7 +15,7 @@
 
 import type { NoteEventDirection } from "../domain/note-event.ts";
 import type { OperationDefinition } from "../module-registry.ts";
-import type { NoteDisposition, Notes } from "../note-service.ts";
+import type { NoteDisposition, Notes } from "../note/note-service.ts";
 
 const MODULE_ID = "notes";
 

package/src/modules/playbooks.ts

@@ -4,11 +4,14 @@
  * A Playbook is prose-first, whole-artifact composition (contains/depends_on between real
  * Playbook artifacts) rather than a raw JSON blueprint -- but its own step list can also
  * declare Doc/Rule blueprints and typed arguments and nested pipeline calls. playbooks.invoke
- * recycles the shared blueprint materialization engine (playbook-execution.ts compiles a
+ * recycles the shared blueprint materialization engine (playbook/playbook-execution.ts compiles a
  * Playbook's steps and composition tree into a BlueprintDefinition, then hands off to
- * workflow-execution.ts's shared core). See domain-services.ts's Playbook section and
- * playbook-definition.ts for the full rationale.
+ * playbook/workflow-execution.ts's shared core). See domain-services.ts's Playbook section and
+ * playbook/playbook-definition.ts for the full rationale.
  */
+
+import type { ArtifactScopeStore } from "../artifact/artifact-scope-store.ts";
+import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import {
 	assignPlaybookProject,
 	containPlaybook,
@@ -23,13 +26,11 @@ import {
 	updatePlaybook,
 } from "../domain-services.ts";
 import type { OperationDefinition } from "../module-registry.ts";
-import { invokePlaybook } from "../playbook-execution.ts";
-import type { ArtifactScopeStore } from "../ports/artifact-scope-store.ts";
-import type { ArtifactStore } from "../ports/artifact-store.ts";
-import type { TaskEventStore } from "../ports/task-event-store.ts";
-import type { TaskScopeStore } from "../ports/task-scope-store.ts";
-import type { SessionIdentity } from "../session-identity-service.ts";
-import type { Tasks } from "../task-service.ts";
+import { invokePlaybook } from "../playbook/playbook-execution.ts";
+import type { SessionIdentity } from "../session-identity/session-identity-service.ts";
+import type { TaskEventStore } from "../stores/task-event-store.ts";
+import type { TaskScopeStore } from "../stores/task-scope-store.ts";
+import type { Tasks } from "../task/task-service.ts";
 
 const MODULE_ID = "playbooks";
 
@@ -96,7 +97,7 @@ export interface PlaybooksModuleDeps {
 	scopes: TaskScopeStore;
 	/** Docs/Rules/Skills/Playbooks project scoping (distinct from `scopes`, which is Task-run project scoping for playbooks.invoke's materialized tasks). */
 	artifactScopes: ArtifactScopeStore;
-	/** Used for exactly one thing: focusing the entry task after a successful invoke -- the one safety-checked Tasks operation this module needs, not bulk graph construction (that goes straight through artifacts/events/scopes in playbook-execution.ts, mirroring workflow-execution.ts). */
+	/** Used for exactly one thing: focusing the entry task after a successful invoke -- the one safety-checked Tasks operation this module needs, not bulk graph construction (that goes straight through artifacts/events/scopes in playbook/playbook-execution.ts, mirroring playbook/workflow-execution.ts). */
 	tasks: Tasks;
 	/** Guards the same session_secret check tasks.focus's own operation enforces (guardFocusMutation in modules/tasks.ts) -- invoke's internal tasks.focus() call goes straight through the Tasks class, bypassing that operation wrapper entirely, so the check must be applied here instead of silently skipped. */
 	sessionIdentity: SessionIdentity;

package/src/modules/rules.ts

@@ -10,6 +10,9 @@
  * into this module or introducing a premature "modules call each other through the
  * registry" convention.
  */
+
+import type { ArtifactScopeStore } from "../artifact/artifact-scope-store.ts";
+import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import {
 	assignRuleProject,
 	createRule,
@@ -21,8 +24,6 @@ import {
 	updateRule,
 } from "../domain-services.ts";
 import type { OperationDefinition } from "../module-registry.ts";
-import type { ArtifactScopeStore } from "../ports/artifact-scope-store.ts";
-import type { ArtifactStore } from "../ports/artifact-store.ts";
 
 const MODULE_ID = "rules";
 

package/src/modules/session-identity.ts

@@ -4,7 +4,7 @@
  * precedent set by modules/logs.ts. See domain/session-identity.ts for the design rationale.
  */
 import type { OperationDefinition } from "../module-registry.ts";
-import type { SessionIdentity } from "../session-identity-service.ts";
+import type { SessionIdentity } from "../session-identity/session-identity-service.ts";
 
 const MODULE_ID = "session-identity";
 

package/src/modules/tasks.ts

@@ -18,15 +18,16 @@
  * set by modules/notes.ts: a module does not import another module's infrastructure,
  * including the composition root's own helpers.
  */
+
+import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import type { Checklist } from "../domain/checklist.ts";
 import type { TaskEventContext, TaskEventDirection, TaskEventFeedQuery } from "../domain/task-event.ts";
 import type { TaskViewMode } from "../domain/task-scope.ts";
 import type { OperationDefinition } from "../module-registry.ts";
-import type { ArtifactStore } from "../ports/artifact-store.ts";
-import type { SessionIdentity } from "../session-identity-service.ts";
-import { taskContext } from "../task-context.ts";
-import { projectTaskExecution } from "../task-execution.ts";
-import type { TaskStatus, Tasks } from "../task-service.ts";
+import type { SessionIdentity } from "../session-identity/session-identity-service.ts";
+import { taskContext } from "../task/task-context.ts";
+import { projectTaskExecution } from "../task/task-execution.ts";
+import type { TaskStatus, Tasks } from "../task/task-service.ts";
 
 const MODULE_ID = "tasks";
 

package/src/{note-service.ts → note/note-service.ts}

@@ -1,3 +1,6 @@
+import type { Artifact } from "../artifact/artifact.ts";
+import type { ArtifactStore } from "../artifact/artifact-store.ts";
+import { requireAtomicArtifactStore } from "../artifact/atomic-artifact-store.ts";
 import {
 	NOTE_BODY_MAX_CHARACTERS,
 	NOTE_LIST_DEFAULT_LIMIT,
@@ -6,12 +9,9 @@ import {
 	NOTE_REASON_MAX_CHARACTERS,
 	NOTE_TITLE_MAX_CHARACTERS,
 	TASK_PROJECT_ROOT_MAX_LENGTH,
-} from "./constants.ts";
-import type { Artifact } from "./domain/artifact.ts";
-import type { AppendNoteEvent, NoteEventType, NoteHistoryPage, NoteHistoryQuery } from "./domain/note-event.ts";
-import type { ArtifactStore } from "./ports/artifact-store.ts";
-import { requireAtomicArtifactStore } from "./ports/atomic-artifact-store.ts";
-import { InMemoryNoteEventStore, type NoteEventStore } from "./ports/note-event-store.ts";
+} from "../constants.ts";
+import type { AppendNoteEvent, NoteEventType, NoteHistoryPage, NoteHistoryQuery } from "../domain/note-event.ts";
+import { InMemoryNoteEventStore, type NoteEventStore } from "../stores/note-event-store.ts";
 
 export const NOTE_SUBTYPE = "note";
 export const NOTE_DISPOSITIONS = ["completed", "duplicate", "declined", "superseded"] as const;

package/src/ops.ts

@@ -3,14 +3,14 @@
  * Enforces the schema protocol (kinds, statuses, relations) via FK + app validation.
  */
 import { createRequire } from "node:module";
+import type { Artifact, ArtifactQuery, CreateArtifactInput, UpdateArtifactInput } from "./artifact/artifact.ts";
+import { generateUniqueAlias, isValidAlias, slugify } from "./artifact/artifact-alias.ts";
+import type { ArtifactTrashRecord } from "./artifact/artifact-trash.ts";
 import { ARTIFACT_TRASH_RETENTION_MS, DEFAULT_STATUS_BY_KIND } from "./constants.ts";
 import type { Db } from "./db.ts";
 import { inTransaction } from "./db.ts";
-import type { Artifact, ArtifactQuery, CreateArtifactInput, UpdateArtifactInput } from "./domain/artifact.ts";
-import { generateUniqueAlias, isValidAlias, slugify } from "./domain/artifact-alias.ts";
-import type { ArtifactTrashRecord } from "./domain/artifact-trash.ts";
 
-export type { ArtifactTrashRecord } from "./domain/artifact-trash.ts";
+export type { ArtifactTrashRecord } from "./artifact/artifact-trash.ts";
 
 import {
 	type AppendArtifactEvent,
@@ -21,10 +21,10 @@ import {
 	type ArtifactEventType,
 	normalizeArtifactEventQuery,
 	resolveArtifactEvent,
-} from "./domain/artifact-event.ts";
+} from "./artifact/artifact-event.ts";
 import type { Gate, GateResult, GateRunOptions } from "./domain/gate.ts";
 
-export type { Artifact } from "./domain/artifact.ts";
+export type { Artifact } from "./artifact/artifact.ts";
 export type { Gate, GateResult } from "./domain/gate.ts";
 export type CreateInput = CreateArtifactInput;
 

package/src/{playbook-definition.ts → playbook/playbook-definition.ts}

@@ -18,12 +18,14 @@
  * independently by workflow-execution.ts, exactly like a workflow-definition target's own
  * nested pipeline step, since its target's own definition is not knowable at this compile time.
  */
+
+import type { Artifact } from "../artifact/artifact.ts";
+import type { ArtifactStore } from "../artifact/artifact-store.ts";
 import {
 	PLAYBOOK_INVOCATION_MAX_CALL_DEPTH,
 	PLAYBOOK_INVOCATION_MAX_CREATED_TASKS,
 	PLAYBOOK_INVOCATION_MAX_LINKED_ARTIFACTS,
-} from "./constants.ts";
-import type { Artifact } from "./domain/artifact.ts";
+} from "../constants.ts";
 import type {
 	BlueprintDefinition,
 	BlueprintInputDefinition,
@@ -31,10 +33,9 @@ import type {
 	DocBlueprint,
 	RuleBlueprint,
 	TaskBlueprint,
-} from "./domain/blueprint-definition.ts";
-import { validateBlueprintDefinition } from "./domain/blueprint-definition.ts";
-import type { PlaybookArgument, PlaybookStep } from "./domain-services.ts";
-import type { ArtifactStore } from "./ports/artifact-store.ts";
+} from "../domain/blueprint-definition.ts";
+import { validateBlueprintDefinition } from "../domain/blueprint-definition.ts";
+import type { PlaybookArgument, PlaybookStep } from "../domain-services.ts";
 
 /** A non-composing edge touching a playbook node, to be mirrored onto that node's generated root task once real task ids exist -- e.g. a Rule `gates` this playbook, or this playbook `references`/`documents` a Doc. Direction is preserved exactly: `from`/`to` name whichever side is NOT the playbook, and `ownerIsFrom` says which side the playbook (now the generated root task) occupies. */
 export interface PlaybookExternalLink {

package/src/{playbook-execution.ts → playbook/playbook-execution.ts}

@@ -7,11 +7,12 @@
  * (via the existing Task Focus system-prompt pointer), which is what actually avoids the
  * old text-dump problem: one page at a time, not the whole book at once.
  */
-import type { BlueprintArgumentValue } from "./domain/blueprint-definition.ts";
+
+import type { ArtifactStore } from "../artifact/artifact-store.ts";
+import { requireAtomicArtifactStore } from "../artifact/atomic-artifact-store.ts";
+import type { BlueprintArgumentValue } from "../domain/blueprint-definition.ts";
+import type { TaskExecutionPlan } from "../task/task-execution.ts";
 import { compilePlaybookDefinition } from "./playbook-definition.ts";
-import type { ArtifactStore } from "./ports/artifact-store.ts";
-import { requireAtomicArtifactStore } from "./ports/atomic-artifact-store.ts";
-import type { TaskExecutionPlan } from "./task-execution.ts";
 import {
 	applyPlaybookExternalLinks,
 	materializeWorkflowDefinition,

package/src/{workflow-execution.ts → playbook/workflow-execution.ts}

@@ -1,28 +1,28 @@
 import { randomUUID } from "node:crypto";
+import type { Artifact } from "../artifact/artifact.ts";
+import type { ArtifactStore } from "../artifact/artifact-store.ts";
+import { requireAtomicArtifactStore } from "../artifact/atomic-artifact-store.ts";
 import {
 	SKILL_MAX_RENDERED_BYTES,
 	SKILL_RUN_ID_MAX_LENGTH,
 	SKILL_WORKFLOW_MAX_NESTING_DEPTH,
 	TASK_EXECUTION_MAX_EDGES,
-} from "./constants.ts";
-import type { Artifact } from "./domain/artifact.ts";
+} from "../constants.ts";
 import {
 	type BlueprintArgumentValue,
 	type BlueprintDefinition,
 	type CallBlueprint,
 	resolveBlueprintArguments,
 	validateBlueprintDefinition,
-} from "./domain/blueprint-definition.ts";
-import { validateChecklist } from "./domain/checklist.ts";
-import type { TaskEventContext } from "./domain/task-event.ts";
-import { normalizeProjectRoot } from "./domain/task-scope.ts";
+} from "../domain/blueprint-definition.ts";
+import { validateChecklist } from "../domain/checklist.ts";
+import type { TaskEventContext } from "../domain/task-event.ts";
+import { normalizeProjectRoot } from "../domain/task-scope.ts";
+import type { TaskEventStore } from "../stores/task-event-store.ts";
+import type { TaskScopeStore } from "../stores/task-scope-store.ts";
+import { projectTaskExecution, TaskExecutionBoundExceededError, type TaskExecutionPlan } from "../task/task-execution.ts";
+import type { TaskGraph, TaskNode, TaskStatus } from "../task/task-service.ts";
 import { compilePlaybookDefinition, type PlaybookExternalLink } from "./playbook-definition.ts";
-import type { ArtifactStore } from "./ports/artifact-store.ts";
-import { requireAtomicArtifactStore } from "./ports/atomic-artifact-store.ts";
-import type { TaskEventStore } from "./ports/task-event-store.ts";
-import type { TaskScopeStore } from "./ports/task-scope-store.ts";
-import { projectTaskExecution, TaskExecutionBoundExceededError, type TaskExecutionPlan } from "./task-execution.ts";
-import type { TaskGraph, TaskNode, TaskStatus } from "./task-service.ts";
 
 const RUN_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
 const EXACT_PLACEHOLDER_PATTERN = /^{{\s*([A-Za-z][A-Za-z0-9_-]{0,63})\s*}}$/;

package/src/service.ts

@@ -2,29 +2,23 @@ import { VehicleError } from "@danypops/vehicle-core";
 import type { VehicleRegistry } from "@danypops/vehicle-server";
 import { createVehicleHttpApp } from "@danypops/vehicle-server/http";
 import type { Logger } from "@danypops/vehicle-server/logging";
-import { SQLiteArtifactScopeStore } from "./adapters/sqlite-artifact-scope-store.ts";
-import { SQLiteArtifactStore } from "./adapters/sqlite-artifact-store.ts";
-import { SQLiteDiscussionRoundStore } from "./adapters/sqlite-discussion-round-store.ts";
-import { SQLiteGateRunner } from "./adapters/sqlite-gate-runner.ts";
-import { SQLiteGraphProjectionStore } from "./adapters/sqlite-graph-projection-store.ts";
-import { SQLiteLogStore } from "./adapters/sqlite-log-store.ts";
-import { SQLiteNoteEventStore } from "./adapters/sqlite-note-event-store.ts";
-import { SQLiteSessionIdentityStore } from "./adapters/sqlite-session-identity-store.ts";
-import { SQLiteTaskEventStore } from "./adapters/sqlite-task-event-store.ts";
-import { SQLiteTaskFocusStore } from "./adapters/sqlite-task-focus-store.ts";
-import { SQLiteTaskLeaseStore } from "./adapters/sqlite-task-lease-store.ts";
-import { SQLiteTaskScopeStore } from "./adapters/sqlite-task-scope-store.ts";
-import { removeArtifactSubtree } from "./artifact-subtree.ts";
+import type { CreateArtifactInput } from "./artifact/artifact.ts";
+import type { ArtifactEventReader } from "./artifact/artifact-event-reader.ts";
+import type { ArtifactStore } from "./artifact/artifact-store.ts";
+import { removeArtifactSubtree } from "./artifact/artifact-subtree.ts";
+import type { ArtifactTrashStore } from "./artifact/artifact-trash-store.ts";
+import { SQLiteArtifactScopeStore } from "./artifact/sqlite-artifact-scope-store.ts";
+import { SQLiteArtifactStore } from "./artifact/sqlite-artifact-store.ts";
 import { type AuthorityClaim, AuthorityRegistry, AuthorizedArtifactWriter } from "./authority-registry.ts";
 import { SERVICE_MAX_BODY_BYTES, SQLITE_SCHEMA_VERSION } from "./constants.ts";
 import { migrateDb, openDb, schemaVersion } from "./db.ts";
-import { Discussions } from "./discussion-service.ts";
-import type { CreateArtifactInput } from "./domain/artifact.ts";
+import { Discussions } from "./discussion/discussion-service.ts";
 import type { TaskEventContext } from "./domain/task-event.ts";
 import type { TaskViewMode } from "./domain/task-scope.ts";
 import { listInjectableRules } from "./domain-services.ts";
-import { logEvent } from "./log.ts";
-import { Logs } from "./log-service.ts";
+import { createPapyrusVehicleRegistry } from "./handlers/registry.ts";
+import { logEvent } from "./log/log.ts";
+import { Logs } from "./log/log-service.ts";
 import { OperationRegistry } from "./module-registry.ts";
 import { DISCUSS_OPERATION_NAMES, discussOperations } from "./modules/discuss.ts";
 import { DOCS_OPERATION_NAMES, docsOperations } from "./modules/docs.ts";
@@ -35,16 +29,22 @@ import { PLAYBOOKS_OPERATION_NAMES, playbooksOperations } from "./modules/playbo
 import { RULES_OPERATION_NAMES, rulesOperations } from "./modules/rules.ts";
 import { SESSION_IDENTITY_OPERATION_NAMES, sessionIdentityOperations } from "./modules/session-identity.ts";
 import { TASKS_OPERATION_NAMES, tasksOperations } from "./modules/tasks.ts";
-import { NOTE_SUBTYPE, Notes } from "./note-service.ts";
-import type { ArtifactEventReader } from "./ports/artifact-event-reader.ts";
-import type { ArtifactStore } from "./ports/artifact-store.ts";
-import type { ArtifactTrashStore } from "./ports/artifact-trash-store.ts";
-import type { GateRunner } from "./ports/gate-runner.ts";
-import type { TaskEventStore } from "./ports/task-event-store.ts";
-import type { TaskScopeStore } from "./ports/task-scope-store.ts";
-import { InvalidSessionSecretError, SessionIdentity } from "./session-identity-service.ts";
-import { type TaskStatus, Tasks } from "./task-service.ts";
-import { createPapyrusVehicleRegistry } from "./vehicle/papyrus-vehicle.ts";
+import { NOTE_SUBTYPE, Notes } from "./note/note-service.ts";
+import { InvalidSessionSecretError, SessionIdentity } from "./session-identity/session-identity-service.ts";
+import type { GateRunner } from "./stores/gate-runner.ts";
+import { SQLiteDiscussionRoundStore } from "./stores/sqlite-discussion-round-store.ts";
+import { SQLiteGateRunner } from "./stores/sqlite-gate-runner.ts";
+import { SQLiteGraphProjectionStore } from "./stores/sqlite-graph-projection-store.ts";
+import { SQLiteLogStore } from "./stores/sqlite-log-store.ts";
+import { SQLiteNoteEventStore } from "./stores/sqlite-note-event-store.ts";
+import { SQLiteSessionIdentityStore } from "./stores/sqlite-session-identity-store.ts";
+import { SQLiteTaskEventStore } from "./stores/sqlite-task-event-store.ts";
+import { SQLiteTaskFocusStore } from "./stores/sqlite-task-focus-store.ts";
+import { SQLiteTaskLeaseStore } from "./stores/sqlite-task-lease-store.ts";
+import { SQLiteTaskScopeStore } from "./stores/sqlite-task-scope-store.ts";
+import type { TaskEventStore } from "./stores/task-event-store.ts";
+import type { TaskScopeStore } from "./stores/task-scope-store.ts";
+import { type TaskStatus, Tasks } from "./task/task-service.ts";
 import { VERSION } from "./version.ts";
 
 /**
@@ -217,7 +217,7 @@ export interface PapyrusService {
 	execute(operation: string, input?: OperationInput): Promise<unknown>;
 	/**
 	 * Every domain migrated onto Vehicle, merged into one registry/one HTTP mount
-	 * (see ./vehicle/papyrus-vehicle.ts) -- one honest VehicleOperation per real
+	 * (see ./handlers/registry.ts) -- one honest VehicleOperation per real
 	 * action, replacing the Pi extension's old `<domain>(action=X)` mega-tools.
 	 * Not every domain is migrated yet -- see papyrus-vehicle.ts's own doc comment
 	 * for what still isn't and why.
@@ -582,7 +582,7 @@ export function createApp(deps: {
 	/** Defaults to a no-op (createVehicleHttpApp's own default) -- daemon.ts wires vehicleLogger() so a failed invocation is actually logged, not silently discarded. */
 	logger?: Logger;
 }): { fetch(request: Request): Promise<Response> } {
-	// Same Bearer token, daemon, and port as the rest of this API -- see ./vehicle/papyrus-vehicle.ts.
+	// Same Bearer token, daemon, and port as the rest of this API -- see ./handlers/registry.ts.
 	const vehicleApp = createVehicleHttpApp({ registry: deps.service.vehicle, token: deps.token, logger: deps.logger });
 	return {
 		async fetch(request: Request): Promise<Response> {

package/src/{session-identity-service.ts → session-identity/session-identity-service.ts}

@@ -4,8 +4,8 @@ import {
 	releaseSessionIdentity,
 	verifySessionSecret,
 } from "@danypops/vehicle-server/session-identity";
-import { assertValidSessionId } from "./domain/session-identity.ts";
-import type { SessionIdentityStore } from "./ports/session-identity-store.ts";
+import { assertValidSessionId } from "../domain/session-identity.ts";
+import type { SessionIdentityStore } from "../stores/session-identity-store.ts";
 
 export interface RegisterSessionIdentityResult {
 	sessionId: string;

package/src/{ports → stores}/session-identity-store.ts

@@ -2,7 +2,7 @@ import type { SessionIdentityRecord, SessionIdentityStore as VehicleSessionIdent
 
 /**
  * Papyrus's persistence port for @danypops/vehicle-server's storage-agnostic session-identity
- * primitive -- re-exported under this project's own port naming convention (src/ports/*)
+ * primitive -- re-exported under this project's own port naming convention (src/stores/*)
  * rather than importing the vehicle-server interface name directly at every call site.
  */
 export type SessionIdentityStore = VehicleSessionIdentityStore;

package/src/{adapters → stores}/sqlite-discussion-round-store.ts

@@ -9,7 +9,7 @@ import {
 	validateDiscussionContent,
 	validateDiscussionOptions,
 } from "../domain/discussion.ts";
-import type { DiscussionRoundStore } from "../ports/discussion-round-store.ts";
+import type { DiscussionRoundStore } from "./discussion-round-store.ts";
 
 interface DiscussionRoundRow {
 	id: number;

package/src/{adapters → stores}/sqlite-gate-runner.ts

@@ -1,7 +1,7 @@
 import type { Db } from "../db.ts";
 import type { GateResult, GateRunOptions } from "../domain/gate.ts";
 import { runGates, runGatesAsync } from "../ops.ts";
-import type { GateRunner } from "../ports/gate-runner.ts";
+import type { GateRunner } from "./gate-runner.ts";
 
 export class SQLiteGateRunner implements GateRunner {
 	constructor(private readonly db: Db) {}

package/src/{adapters → stores}/sqlite-graph-projection-store.ts

@@ -1,7 +1,7 @@
 import type { Db } from "../db.ts";
 import { inTransaction } from "../db.ts";
 import type { ProjectionCheckpoint } from "../domain/graph-projection.ts";
-import type { GraphProjectionStore } from "../ports/graph-projection-store.ts";
+import type { GraphProjectionStore } from "./graph-projection-store.ts";
 
 export class SQLiteGraphProjectionStore implements GraphProjectionStore {
 	constructor(private readonly db: Db) {}

package/src/{adapters → stores}/sqlite-log-store.ts

@@ -1,6 +1,6 @@
 import type { Db } from "../db.ts";
 import type { JsonValue, LogEntry, LogLevel, LogSource } from "../domain/log-entry.ts";
-import type { LogStore } from "../ports/log-store.ts";
+import type { LogStore } from "./log-store.ts";
 
 interface SourceRow {
 	id: string;

package/src/{adapters → stores}/sqlite-note-event-store.ts

@@ -8,7 +8,7 @@ import {
 	normalizeNoteHistoryQuery,
 	validateNoteEvent,
 } from "../domain/note-event.ts";
-import type { NoteEventStore } from "../ports/note-event-store.ts";
+import type { NoteEventStore } from "./note-event-store.ts";
 
 interface NoteEventRow {
 	id: number;

package/src/{adapters → stores}/sqlite-session-identity-store.ts

@@ -1,7 +1,7 @@
 import { SESSION_IDENTITY_MAX_ROWS } from "../constants.ts";
 import type { Db } from "../db.ts";
 import { inTransaction } from "../db.ts";
-import type { SessionIdentityRecord, SessionIdentityStore } from "../ports/session-identity-store.ts";
+import type { SessionIdentityRecord, SessionIdentityStore } from "./session-identity-store.ts";
 
 export class SQLiteSessionIdentityStore implements SessionIdentityStore {
 	constructor(private readonly db: Db) {}

package/src/{adapters → stores}/sqlite-task-event-store.ts

@@ -14,7 +14,7 @@ import {
 	type TaskLifecycleStatus,
 	validateTaskEvent,
 } from "../domain/task-event.ts";
-import type { TaskEventStore } from "../ports/task-event-store.ts";
+import type { TaskEventStore } from "./task-event-store.ts";
 
 interface TaskEventRow {
 	id: number;

package/src/{adapters → stores}/sqlite-task-focus-store.ts

@@ -1,7 +1,7 @@
 import { TASK_FOCUS_MAX_SCOPES } from "../constants.ts";
 import type { Db } from "../db.ts";
 import { inTransaction } from "../db.ts";
-import { normalizeFocusScope, type TaskFocusState, type TaskFocusStatus, type TaskFocusStore } from "../ports/task-focus-store.ts";
+import { normalizeFocusScope, type TaskFocusState, type TaskFocusStatus, type TaskFocusStore } from "./task-focus-store.ts";
 
 export class SQLiteTaskFocusStore implements TaskFocusStore {
 	constructor(private readonly db: Db) {}

package/src/{adapters → stores}/sqlite-task-lease-store.ts

@@ -2,7 +2,7 @@ import { TASK_LEASE_DEFAULT_TTL_MS } from "../constants.ts";
 import type { Db } from "../db.ts";
 import { inTransaction } from "../db.ts";
 import { isLeaseExpired, type TaskLease, validateLeaseNote, validateLeaseOwner, validateLeaseTtlMs } from "../domain/task-lease.ts";
-import type { TaskLeaseStore } from "../ports/task-lease-store.ts";
+import type { TaskLeaseStore } from "./task-lease-store.ts";
 
 interface TaskLeaseRow {
 	task_id: string;

package/src/{adapters → stores}/sqlite-task-scope-store.ts

@@ -1,7 +1,7 @@
 import type { Db } from "../db.ts";
 import { inTransaction } from "../db.ts";
 import type { TaskProjectScope, TaskScopeSource, TaskViewMode, TaskViewPreference } from "../domain/task-scope.ts";
-import type { TaskScopeStore } from "../ports/task-scope-store.ts";
+import type { TaskScopeStore } from "./task-scope-store.ts";
 
 export class SQLiteTaskScopeStore implements TaskScopeStore {
 	constructor(private readonly db: Db) {}

package/src/{task-context.ts → task/task-context.ts}

@@ -1,7 +1,7 @@
-import { TASK_CONTEXT_CURRENT_LIMIT, TASK_CONTEXT_REJECTED_LIMIT, TASK_RECONCILIATION_INSTRUCTION } from "./constants.ts";
-import type { Artifact } from "./domain/artifact.ts";
-import { DISCUSSION_SUBTYPE, readDiscussionExtra } from "./domain/discussion.ts";
-import type { ArtifactStore } from "./ports/artifact-store.ts";
+import type { Artifact } from "../artifact/artifact.ts";
+import type { ArtifactStore } from "../artifact/artifact-store.ts";
+import { TASK_CONTEXT_CURRENT_LIMIT, TASK_CONTEXT_REJECTED_LIMIT, TASK_RECONCILIATION_INSTRUCTION } from "../constants.ts";
+import { DISCUSSION_SUBTYPE, readDiscussionExtra } from "../domain/discussion.ts";
 
 interface Gate {
 	type?: unknown;

package/src/{task-execution.ts → task/task-execution.ts}

@@ -1,4 +1,4 @@
-import { TASK_EXECUTION_MAX_DEGREE, TASK_EXECUTION_MAX_EDGES, TASK_EXECUTION_MAX_NODES } from "./constants.ts";
+import { TASK_EXECUTION_MAX_DEGREE, TASK_EXECUTION_MAX_EDGES, TASK_EXECUTION_MAX_NODES } from "../constants.ts";
 import type { TaskGraph } from "./task-service.ts";
 
 /** A task execution graph is too large or too densely connected to process safely -- a distinct class (not a plain Error) so the Vehicle adapter layer can classify it into a capacity-category failure instead of an opaque handler-failed. */

package/src/{task-graph-view.ts → task/task-graph-view.ts}

@@ -1,4 +1,4 @@
-import type { DisplayGraph, DisplayGraphEdge } from "./domain/display-graph.ts";
+import type { DisplayGraph, DisplayGraphEdge } from "../domain/display-graph.ts";
 import { projectTaskExecution, type TaskExecutionState } from "./task-execution.ts";
 import type { TaskGraph } from "./task-service.ts";
 

package/src/{task-relationship-view.ts → task/task-relationship-view.ts}

@@ -1,5 +1,5 @@
-import type { Artifact, ArtifactEdge } from "./domain/artifact.ts";
-import type { DisplayGraph, DisplayGraphEdge, DisplayGraphNode } from "./domain/display-graph.ts";
+import type { Artifact, ArtifactEdge } from "../artifact/artifact.ts";
+import type { DisplayGraph, DisplayGraphEdge, DisplayGraphNode } from "../domain/display-graph.ts";
 import type { TaskGraph } from "./task-service.ts";
 
 function normalizeEdge(edge: ArtifactEdge): DisplayGraphEdge {
@@ -9,7 +9,7 @@ function normalizeEdge(edge: ArtifactEdge): DisplayGraphEdge {
 	return { from: edge.from, to: edge.to, label: edge.relation };
 }
 
-/** Best-effort readable label from a bare id when no real title is known -- shared with artifact-relationship-view.ts's generic version of this same problem. */
+/** Best-effort readable label from a bare id when no real title is known -- shared with artifact/artifact-relationship-view.ts's generic version of this same problem. */
 export function fallbackLabel(id: string): string {
 	return id.replace(/-[a-z0-9]{4}$/i, "").replaceAll("-", " ");
 }