@dboio/cli 0.20.4 → 0.20.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dboio/cli",
-  "version": "0.20.4",
+  "version": "0.20.5",
   "description": "CLI for the DBO.io framework",
   "type": "module",
   "bin": {

package/plugins/claude/dbo/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dbo",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "DBO.io CLI integration for Claude Code",
   "author": {
     "name": "DBO.io"

package/plugins/claude/track/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "track",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Changelog and Track API logging for Claude Code — automatically logs changes to changelog.md and the remote Track task_log on every session",
   "author": {
     "name": "DBO.io"

package/src/commands/clone.js

@@ -4556,6 +4556,30 @@ async function _promoteNoBinContentToRoot(contentRefs, handledUids, rootFiles) {
   }
 }
 
+/**
+ * Read ~/.claude/plugins/installed_plugins.json and return install paths for
+ * relevant plugins. Returns an object with optional `dbo` and `track` keys.
+ */
+async function _getInstalledPluginPaths() {
+  const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+  if (!homeDir) return {};
+  const installedPath = join(homeDir, '.claude', 'plugins', 'installed_plugins.json');
+  try {
+    const raw = await readFile(installedPath, 'utf8');
+    const data = JSON.parse(raw);
+    const result = {};
+    for (const [key, entries] of Object.entries(data.plugins || {})) {
+      const installPath = entries[0]?.installPath;
+      if (!installPath) continue;
+      if (key.startsWith('dbo@')) result.dbo = installPath;
+      if (key.startsWith('track@')) result.track = installPath;
+    }
+    return result;
+  } catch {
+    return {};
+  }
+}
+
 /**
  * Generate a fallback stub for a root content file when the server has no record.
  * Skips if the file already exists at the project root.
@@ -4583,6 +4607,11 @@ async function _generateRootFileStub(filename, appJson) {
       const label = s.Title || s.Name || s.ShortName;
       return `- \`${url}\` — ${label} (add \`?dev=true\` to serve uncompiled JS; add \`&console=true\` for verbose debug logging)`;
     });
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+    const toTilde = (p) => homeDir ? p.replace(homeDir, '~') : p;
+    const pluginPaths = await _getInstalledPluginPaths();
+    const dboDocsPath = pluginPaths.dbo ? toTilde(join(pluginPaths.dbo, 'docs')) : null;
+    const trackPluginPath = pluginPaths.track ? toTilde(pluginPaths.track) : null;
     const stub = [
       `# ${appName}`,
       ...(siteLines.length > 0 ? [``, `## App Sites`, ``, ...siteLines] : []),
@@ -4623,6 +4652,20 @@ async function _generateRootFileStub(filename, appJson) {
       ``,
       `1. \`app_dependencies/_system/lib/bins/docs/\` — authoritative source`,
       `2. \`plugins/claude/dbo/skills/white-paper/references/\` — fallback reference`,
+      ...(dboDocsPath ? [
+        `3. \`${dboDocsPath}/\` — installed dbo plugin reference docs:`,
+        `   - \`${dboDocsPath}/dbo-cheat-sheet.md\` — quick reference`,
+        `   - \`${dboDocsPath}/dbo-cli-readme.md\` — CLI usage`,
+        `   - \`${dboDocsPath}/dbo-core-entities.md\` — core entity schema`,
+        `   - \`${dboDocsPath}/dbo-output-query.md\` — output query syntax`,
+        `   - \`${dboDocsPath}/dbo-output-customsql.md\` — custom SQL outputs`,
+      ] : []),
+      ...(trackPluginPath ? [
+        ``,
+        `### Track Plugin Reference`,
+        ``,
+        `Track plugin docs are available at \`${trackPluginPath}/\`.`,
+      ] : []),
       ``,
     ].join('\n');
     await writeFile(rootPath, stub);

package/plugins/claude/dbo/docs/_audit_required/API/all.md

@@ -1,40 +0,0 @@
-# All
-
-These parameters work on all endpoints
-
-## Parameters
-
-| Impersonation |                                                              |
-| ------------- | ------------------------------------------------------------ |
-| _as           | The request key that is used to indicate that a request should be run as another user |
-| _as_cookie    | The request key that is used to indicate that a cookie should be set for the _as user that is being used |
-| _security_log | The request key that is used to request a full security log to be included in the response headers |
-
-| Debug                      |                                                             |
-| -------------------------- | ----------------------------------------------------------- |
-| _debug                     | Nuclear debug option                                        |
-| _debug_sql                 | The (legacy) request key that will trigger debug output sql |
-| _debug:sql                 | Debugging only SQL key                                      |
-| _debug:http_modules        | Debugging only HTTP modules                                 |
-| _debug:instance            | Debugging only instance                                     |
-| _debug:rewrites            | Debugging only rewrites                                     |
-| _debug:cache               | Debugging only cache                                        |
-| _debug:com                 | Debugging only COM                                          |
-| _debug:executable_contents | Debugging only executable contents                          |
-| _debug:request_log         | Debugging only request logs                                 |
-| _debug:security            | Debugging only security                                     |
-| _debug:controllers         | Debugging only controllers                                  |
-| _debug:embeds              | Debugging only embeds                                       |
-| _debug:includes            | Debugging only includes                                     |
-| _debug:contents            | Debugging only contents                                     |
-| _debug:template_render     | Debugging only template render                              |
-| _debug:result_set_access   | Debugging only result set access                            |
-| _debug:template_parsing    | Debugging only template parsing                             |
-| _debug:entity_internals    | Debugging only entity internal operations/save              |
-| _debug:query_execution     | Debugging only query execution                              |
-| _debug:query_building      | Debugging only query building                               |
-| _debug:tokens              | Debugging only tokens                                       |
-| _debug:messages            | Debugging only messages                                     |
-| _debug:request_stack       | Debugging only request stack                                |
-| _debug:skip                |                                                             |
-| _really_cmon_doit          | The really-cmon-doit request key                            |

package/plugins/claude/dbo/docs/_audit_required/API/app.md

@@ -1,38 +0,0 @@
-# App
-
-## URL Endpoints
-
-- api/app/delete/{appUid}
-- api/app/import/{appUid}
-- api/app_version/populate/{appVersionUid}
-- api/app_version/clear/{appVersionUid}
-- api/app/export/{appUid}
-
-## Parameters
-
-| Parameter                            | Description                                                  |
-| ------------------------------------ | ------------------------------------------------------------ |
-| _app_version_info                    | Request parameter that can be included (as 'false', '0', or 'no') to turn off addressing app version info on app import |
-| _app_data                            | Request parameter that can be included (as 'false', '0', or 'no') to turn off addressing app data on app import |
-| _app_media                           | Request parameter that can be included (as 'false', '0', or 'no') to turn off addressing app media on app import |
-| _schema_migration_check              | Request parameter that can be included (as 'false', '0', or 'no') to turn off checking the schema migration of the import against that of the local core |
-| _skip_media_rearch_2020_validation   | When truthy, app import will not fail if the import account's MediaRearch2020 is false and the app's is true |
-| _skip_dboio_version_validation       | When truthy, app import will not fail if the import system's dbo.io version is less than the export system's |
-| _legacy_import_data_generation       | When truthy, app import generate app version and app version updates in the legacy (pre-.9.48) fashion |
-| _app_url                             | Request parameter that can be used to specify a url to import an app from |
-| _skip_archival_export                | Request parameter that can be included (as 'true', '1', or 'yes') to skip the archival export that is normally done before deleting an app |
-| _legacy_by_appid                     | For use after MediaRearch2020, when truthy app operations will use asset AppID to collect app assets, instead of bin structure |
-| _force_local_record_check            | Request parameter to force an app import to check for all records locally, by record UID |
-| _patch                               | DEPRECATED Parameter to use when exporting a patch version   |
-| _type                                | Parameter to use when exporting, to specify "update" (patch) version |
-| _continue_on_execution_group_failure | During import, if this is truthy, then when an execution group fails, the import process will log it as a warning and continue |
-| _no_rollback                         | During import, if this is truthy, then when a failure causes the import to stop, there will be no rollback performed |
-| _media_only                          | During import, if this is truthy, then when a failure causes the import to stop, there will be no rollback performed |
-| _nullify_parentbinid                 |                                                              |
-| _legacy_app_delete                   | When true, will use legacy app delete (instead of app_delete SPROC) |
-| _modify_key                          | Request parameter used to indicate a valid update of an app asset by a client (non-owner) of the app |
-| _modify_key_check_override           | Modify key check override.  If this key is set in HttpContext.Current.Items = true, then the check for whether a modify key is present to modify an app will be bypassed (used in app import, for example). |
-| _db_timeout_seconds                  | Request parameter to indicate a custom db timeout            |
-| _no_transaction                      | Request parameter to indicate that a transaction should NOT be used |
-| _no_db_ops                           | Request parameter to indicate that db ops should not be executed for the given request |
-| _skip_minimum_content_uid_length     | When this is truthy, we'll skip the validation that says contents must be less than 5 characters |

package/plugins/claude/dbo/docs/_audit_required/API/athenticate.md

@@ -1,26 +0,0 @@
-# Authenticate
-
-Used to log users in an out of dbo.io. Can be invoked through any endpoint by use of `_login=true` parameter.
-
-
-
-## URL Endpoint
-
-api/authenticate
-
-
-
-## Parameters
-
-| Paremeter    | Description                                                  | Shorthand |
-| ------------ | ------------------------------------------------------------ | --------- |
-| _username    | Corresponds to user.username                                 | _un       |
-| _email       | Corresponds to user.email                                    | _em       |
-| _phonenumber | Corresponds to user.PhoneNumber                              | _pn       |
-| _password    | Corresponds to user.Password                                 | _pw       |
-| _passkey     | Corresponds to user.Passkey                                  | _pk       |
-| _login       | When true the `athenticate` API is invoked for all endpoints |           |
-| _logout      | Logs the user out of [dbo.io](http://dbo.io/)                | _lo       |
-
-
-

package/plugins/claude/dbo/docs/_audit_required/API/cache.md

@@ -1,29 +0,0 @@
-# Cache
-
-Used to retreive and refresh asset cache.
-
-
-
-## URL Endpoints
-
-api/cache/list
-api/cache/refresh
-
-
-
-## Parameters
-
-_key=[entity]:meta:[AssetUID]
-
-_key=secure:[entity]:meta:[AssetUID]
-
-
-
-### Example
-
-Voiding cache on output with UID `nd7vddus4kayiga4fbnhqw` requires two calls, the second is for `https`.
-
-`/api/cache/refresh?_key=output:meta:nd7vddus4kayiga4fbnhqw`
-
-`/api/cache/refresh?_key=secure:output:meta:nd7vddus4kayiga4fbnhqw`
-

package/plugins/claude/dbo/docs/_audit_required/API/content.md

@@ -1,14 +0,0 @@
-# Content
-
-## URL Endpoints
-
-- api/content/{uid}
-
-`content` can be shortened to `c`
-
-## Parameters
-
-| Parameter             | Description                                                  |
-| --------------------- | ------------------------------------------------------------ |
-| _format               | The request key that is used to manually specify OutputFormat - NOPE, THIS IS NOW USED FOR WHAT THE NEW summary INDICATES!! |
-| _template_content_uid | The key that is used to specify master template content UID  |

package/plugins/claude/dbo/docs/_audit_required/API/data_source.md

@@ -1,28 +0,0 @@
-# Data Source
-
-
-
-## URL Endpoints
-
-- api/data_source/metadata/synchronize/in/{dataSourceUidOrShortName}
-- api/data_source/metadata/synchronize/out/{dataSourceUidOrShortName}
-- api/data_source/metadata/synchronize/{dataSourceUidOrShortName}
-- api/data_source/migrate/core/{num}
-
-## Parameters
-
-| Parameter                             | Description                                                  |
-| ------------------------------------- | ------------------------------------------------------------ |
-| _include_data_source_uids             | When synchronizing a data source, this parameter can specify a comma-separated list of data source UIDs that need to be included in the synchronization process for foreign key resolution |
-| _entity_column_updates                | When synchronizing a data source, this parameter can specify a value that indicates to perform any updates encountered for entity column metadata.  It can be the literal value "entity_column" (which indicates that ALL entity_column metadata updates should be executed), or it can be a comma-separated list of entity column UIDs (ie. "entity_column.NotNull,entity_column.DefaultValue"). This is ALSO used for /api/media/metadata/apply, to specify which entity columns to apply any applicable updates to. |
-| _tables                               | Instead of trying to synchronize ALL tables from an external data source, a comma-separated list of physical table names can be included with this parameter. Can be "_all", defaults to NONE! SAME AS _entities parameter! |
-| _entities                             | Instead of trying to synchronize ALL tables from an external data source, a comma-separated list of entity.PhysicalNames can be included with this parameter. Can be "_all", defaults to NONE! SAME AS _tables parameter! |
-| _columns                              | Use to provide a comma-separated list of physical column names to include in synchronization. Defaults to "_all", but restricted to tables included! SAME AS _entity_column parameter! |
-| _entity_columns                       | Use to provide a comma-separated list of physical column names to include in synchronization. Defaults to "_all", but restricted to tables included! SAME AS _columns parameter! |
-| _attributes                           | Use to provide a comma-separated list of attributes (columns of entity_column) to include in synchronization. Defaults to "_all", but restricted to tables/columns included! |
-| _db_timeout_seconds                   | Request parameter to indicate a custom db timeout            |
-| _no_transaction                       | Request parameter to indicate that a transaction should NOT be used |
-| _no_db_ops                            | Request parameter to indicate that db ops should not be executed for the given request |
-| _protect_after                        | Request parameter to indicate a date/time that specifies a date/time to check for overwrite protection |
-| _skip_auto_update_columns_LastUpdated | When this is truthy, then we will not update any _LastUpdated auto-update columns that are usually set automatically |
-| _skip_minimum_content_uid_length      | When this is truthy, we'll skip the validation that says contents must be less than 5 characters |

package/plugins/claude/dbo/docs/_audit_required/API/email.md

@@ -1,18 +0,0 @@
-# Email
-
-## URL Endpoints
-
-- api/content/email/{uid}
-- api/message/content/{uid}
-- api/message/receive/{messageServerUid}
-- api/message/c/{messageServerUid}
-
-### Shorter versions
-
-`content` can be shortened to `c`
-
-`message` can be shortened to `m`
-
-`receive` can be shortened to `r`
-
-## Parameters

package/plugins/claude/dbo/docs/_audit_required/API/input.md

@@ -1,25 +0,0 @@
-# Input
-
-
-
-## URL Endpoint
-
-- api/input/submit
-
-## Parameters
-
-| Parameter                             | Description                                                  |
-| ------------------------------------- | ------------------------------------------------------------ |
-| _input_field_delimiter                | Can be used to indicate a custom field delimiter on an input submission |
-| _input_descriptor_delimiter           | Can be used to indicate a custom descriptor delimiter on an input submission |
-| _media_filename_suffix                | Key used to automatically append a suffix to a media file uploaded (if value is 'uid', will use the UID of the media) |
-| _root                                 | DEPRECATED/UNUSED? Can be used to indicate a custom root directory for a media upload |
-| _media_server_uid                     | Key used to specify a media server to use with entity API submission, if there are multiple media_server records associated to the entity (media_server.UID) |
-| _media_server_id                      | Key used to specify a media server to use with entity API submission, if there are multiple media_server records associated to the entity (media_server.MediaServerID) |
-| _download                             | Key used to force download, instead of inline browser display |
-| _db_timeout_seconds                   | Request parameter to indicate a custom db timeout            |
-| _no_transaction                       | Request parameter to indicate that a transaction should NOT be used |
-| _no_db_ops                            | Request parameter to indicate that db ops should not be executed for the given request |
-| _protect_after                        | Request parameter to indicate a date/time that specifies a date/time to check for overwrite protection |
-| _skip_auto_update_columns_LastUpdated | When this is truthy, then we will not update any _LastUpdated auto-update columns that are usually set automatically |
-| _skip_minimum_content_uid_length      | When this is truthy, we'll skip the validation that says contents must be less than 5 characters |

package/plugins/claude/dbo/docs/_audit_required/API/instance.md

@@ -1,28 +0,0 @@
-# Instance
-
-
-
-## URL Endpoints
-
-- api/instance/debug
-- api/instance/export
-- api/instance/import
-- api/instance/generate/{accountUid}
-- api/instance/build/{instanceUid}
-
-
-
-## Parameters
-
-| Parameter           | Description                                                  |
-| ------------------- | ------------------------------------------------------------ |
-| _no_ddl             | [InstanceGenerator] When truthy, the DDL portion of instance generation will be skipped |
-| _pk_override        | When truthy, allows setting a value for a primary key value  |
-| _skip_control_data  | [InstanceGenerator] When truthy, the Control data portion of instance generation will be skipped |
-| _skip_baseline      | [InstanceGenerator] When truthy, the core baseline portion of instance generation will be skipped |
-| _skip_migrations    | [InstanceGenerator] When truthy, the core migrations portion of instance generation will be skipped |
-| _skip_core_data     | [InstanceGenerator] When truthy, the core data portion of instance generation will be skipped |
-| _model_url          | Request parameter that can be used to specify a url to a model to build with |
-| _model              | Request parameter that can be used to specify a zip package for the model to build with |
-| _skip_non_core_data | Request parameter to skip non-core data when exporting an instance |
-| _callback_url       | Request parameter to provide a callback URL (for an offline operation) |

package/plugins/claude/dbo/docs/_audit_required/API/log.md

@@ -1,8 +0,0 @@
-# Log
-
-## URL Endpoints
-
-- api/log/request/parse
-
-## Parameters
-

package/plugins/claude/dbo/docs/_audit_required/API/media.md

@@ -1,12 +0,0 @@
-# Media
-
-## URL Endpoints
-
-- api/media/metadata/debug
-- api/media/metadata/apply
-- api/media/id/`{id}`
-- api/media/`{uid}`
-- dir/`{*path}`
-- ext/`{mediaServerUid}`/`{rowId}`
-
-## Parameters

package/plugins/claude/dbo/docs/_audit_required/API/output_by_entity.md

@@ -1,12 +0,0 @@
-# Output by Entity
-
-## URL Endpoints
-
-- api/output/entity/`{entityUid}`/`{rowId}`
-- api/output/entity/`{entityUid}`
-
-`output` can be shortened to `o`
-
-`entity` can be shortened to `e`
-
-## Parameters

package/plugins/claude/dbo/docs/_audit_required/API/upload.md

@@ -1,7 +0,0 @@
-# Upload
-
-## URL Endpoints
-
-- api/upload/submit
-
-## Parameters