neotoma 0.3.6 → 0.3.8

package/README.md

@@ -236,14 +236,16 @@ neotoma init
 neotoma api start
 ```
 
-CLI transport defaults are API-first. Use `--offline` only when you explicitly want in-process local transport:
+Source checkout resolution precedence is: explicit CLI inputs (where supported), then `NEOTOMA_REPO_ROOT`, then directory-local checkout from current working directory, then saved config fallback.
+
+CLI transport defaults are offline-first. Use `--api-only` when you explicitly want remote API transport:
 
 ```bash
-# Default (API transport; no implicit local fallback)
+# Default (in-process local transport; no API server required)
 neotoma entities list --type task
 
-# Explicit local inline mode (no API server required)
-neotoma --offline entities list --type task
+# Explicit remote API mode (fail if API is unreachable)
+neotoma --api-only entities list --type task
 ```
 
 After installation, configure MCP for your AI tool:
@@ -252,6 +254,8 @@ After installation, configure MCP for your AI tool:
 neotoma mcp config
 ```
 
+For first-run agent-guided setup (install + init + preview-before-save confirmation), see [Agent onboarding](docs/developer/agent_onboarding.md).
+
 Marketing site: **https://neotoma.io** (GitHub Pages, deployed from **main**; custom domain set in repo Settings → Pages). See [Deployment](docs/infrastructure/deployment.md#marketing-site-neotomaio).
 
 ### Option 2: Clone source checkout (for development)
@@ -315,6 +319,8 @@ After installation:
 
 This gives you a quick end-to-end validation that memory is persisting and retrievable across sessions and tools. For full setup steps, see [Getting started](docs/developer/getting_started.md).
 
+If you want onboarding handled by an agent, use the first-run confirmation workflow in [Agent onboarding](docs/developer/agent_onboarding.md). That flow is onboarding-only and does not replace normal ongoing behavior.
+
 ---
 
 ## Development

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AA6EA,eAAO,MAAM,GAAG,6CAAY,CAAC;AA2vI7B,wBAAsB,eAAe;;;eAkCpC"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AA8EA,eAAO,MAAM,GAAG,6CAAY,CAAC;AA0vI7B,wBAAsB,eAAe;;;eAkCpC"}

package/dist/actions.js

@@ -27,6 +27,7 @@ import { isOauthKeyCredentialValid, normalizeOauthNextPath, OAuthKeySessionStore
 import { AnalyzeSchemaCandidatesRequestSchema, CorrectEntityRequestSchema, CreateRelationshipRequestSchema, DeleteEntityRequestSchema, DeleteRelationshipRequestSchema, EntitiesQueryRequestSchema, EntitySnapshotRequestSchema, FieldProvenanceRequestSchema, GetSchemaRecommendationsRequestSchema, ListObservationsRequestSchema, ListRelationshipsRequestSchema, MergeEntitiesRequestSchema, ObservationsQueryRequestSchema, RegisterSchemaRequestSchema, RelationshipSnapshotRequestSchema, ReinterpretRequestSchema, InterpretUninterpretedRequestSchema, RestoreEntityRequestSchema, RestoreRelationshipRequestSchema, RetrieveEntityByIdentifierSchema, RetrieveGraphNeighborhoodSchema, RetrieveRelatedEntitiesSchema, StoreRequestSchema, StoreUnstructuredRequestSchema, UpdateSchemaIncrementalRequestSchema, } from "./shared/action_schemas.js";
 import { queryEntitiesWithCount } from "./shared/action_handlers/entity_handlers.js";
 import { prepareEntitySnapshotWithEmbedding, upsertEntitySnapshotWithEmbedding, } from "./services/entity_snapshot_embedding.js";
+import { readOpenApiFile } from "./shared/openapi_file.js";
 export const app = express();
 // Trust proxy headers (required for express-rate-limit when X-Forwarded-For is present)
 app.set("trust proxy", true);
@@ -3487,8 +3488,7 @@ app.post("/health_check_snapshots", async (req, res) => {
 // Chat endpoint removed - violates Application Layer constraint "MUST NOT contain conversational logic"
 // Conversational interactions should be externalized to MCP-compatible agents per architecture
 app.get("/openapi.yaml", (req, res) => {
-    const openApiPath = path.join(process.cwd(), "openapi.yaml");
-    const openApiContent = fs.readFileSync(openApiPath, "utf-8");
+    const openApiContent = readOpenApiFile();
     const spec = yaml.load(openApiContent);
     const baseUrl = (config.apiBase || "").replace(/\/$/, "");
     if (spec.servers?.length && baseUrl) {