objectstack-vscode 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> objectstack-vscode@0.1.0 build /home/runner/work/spec/spec/packages/vscode-objectstack
+> tsc -p ./tsconfig.json
+

package/LICENSE

@@ -0,0 +1,202 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute
+          must include a readable copy of the attribution notices
+          contained within such NOTICE file, excluding those notices
+          that do not pertain to any part of the Derivative Works,
+          in at least one of the following places: within a NOTICE
+          text file distributed as part of the Derivative Works; within
+          the Source form or documentation, if provided along with
+          the Derivative Works; or, within a display generated by the
+          Derivative Works, if and wherever such third-party notices
+          normally appear. The contents of the NOTICE file are for
+          informational purposes only and do not modify the License.
+          You may add Your own attribution notices within Derivative
+          Works that You distribute, alongside or as an addendum to
+          the NOTICE text from the Work, provided that such additional
+          attribution notices cannot be construed as modifying the
+          License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 ObjectStack
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,81 @@
+# ObjectStack for Visual Studio Code
+
+> Autocomplete, validation, and inline diagnostics for ObjectStack Protocol files.
+
+## Features
+
+- **Snippets** — Quickly scaffold objects, fields, views, flows, agents, and full `defineStack` configs with `os-` prefixed snippets.
+- **Hover Documentation** — Hover over `defineStack`, `defineView`, field types (`text`, `lookup`, `select`, etc.) to see inline descriptions.
+- **Diagnostics** — Real-time warnings for common mistakes:
+  - Missing `manifest` in `defineStack()`
+  - camelCase names that should be `snake_case`
+- **Config File Watching** — Automatically re-validates when `objectstack.config.ts` changes.
+- **JSON Schema Validation** — Validates `objectstack.json` files against the bundled schema.
+- **Quick Fix Stubs** — Code action provider for quick fixes (add missing label, convert to snake_case).
+
+## Snippets
+
+| Prefix | Description |
+|--------|-------------|
+| `os-object` | Define a new business object |
+| `os-field-text` | Add a text field |
+| `os-field-select` | Add a select (picklist) field |
+| `os-field-lookup` | Add a lookup (reference) field |
+| `os-view-grid` | Define a grid list view |
+| `os-flow` | Define an automation flow |
+| `os-stack` | Full `defineStack` boilerplate |
+| `os-agent` | Define an AI agent |
+
+## Installation
+
+### From Source
+
+```bash
+cd packages/vscode-objectstack
+npm install
+npm run build
+npm run package
+# Install the generated .vsix file in VSCode
+```
+
+### From Marketplace (Coming Soon)
+
+Search for "ObjectStack" in the VSCode Extensions marketplace.
+
+## Usage
+
+1. Open a project containing `objectstack.config.ts`
+2. The extension activates automatically for `.object.ts`, `.view.ts`, and `objectstack.config.ts` files
+3. Start typing `os-` to see available snippets
+4. Hover over ObjectStack keywords for inline documentation
+
+## Supported File Types
+
+| Pattern | Description |
+|---------|-------------|
+| `*.object.ts` | Business object definitions |
+| `*.view.ts` | View configurations (list, form, kanban) |
+| `objectstack.config.ts` | Stack configuration file |
+| `objectstack.json` | JSON configuration (with schema validation) |
+
+## Development
+
+```bash
+# Build the extension
+npm run build
+
+# Watch for changes
+npm run watch
+
+# Package as .vsix
+npm run package
+```
+
+## Requirements
+
+- VSCode 1.85.0 or later
+- TypeScript project using `@objectstack/spec`
+
+## License
+
+Apache-2.0 — see [LICENSE](../../LICENSE) for details.

package/dist/extension.d.ts

@@ -0,0 +1,3 @@
+import * as vscode from 'vscode';
+export declare function activate(context: vscode.ExtensionContext): void;
+export declare function deactivate(): void;

package/dist/extension.js

@@ -0,0 +1,205 @@
+"use strict";
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activate = activate;
+exports.deactivate = deactivate;
+const vscode = __importStar(require("vscode"));
+/** Well-known ObjectStack field types for hover documentation */
+const FIELD_TYPE_DOCS = {
+    text: 'Single-line text field (max 255 chars by default)',
+    textarea: 'Multi-line text area for longer content',
+    richtext: 'Rich text editor with HTML formatting',
+    number: 'Decimal number with configurable precision',
+    integer: 'Whole number without decimals',
+    currency: 'Monetary value with currency code',
+    boolean: 'True/false toggle',
+    date: 'Calendar date (no time)',
+    datetime: 'Date with time and timezone',
+    select: 'Single-choice picklist (requires `options`)',
+    multiselect: 'Multi-choice picklist (requires `options`)',
+    lookup: 'Reference to another object (requires `reference`)',
+    master_detail: 'Parent-child relationship with cascade delete',
+    formula: 'Computed field using expressions',
+    email: 'Email address with validation',
+    phone: 'Phone number',
+    url: 'URL with protocol validation',
+    image: 'Image file reference',
+    file: 'File attachment reference',
+    json: 'Arbitrary JSON data',
+    uuid: 'Universally unique identifier',
+    slug: 'URL-friendly identifier (auto-generated from name)',
+    rating: 'Numeric star rating',
+    color: 'Hex color value (#RRGGBB)',
+    vector: 'Numeric vector for AI embeddings and similarity search',
+    encrypted: 'Encrypted at rest — displayed masked in UI',
+    autonumber: 'Auto-incrementing display number',
+    geo_point: 'Geographic coordinates (lat/lng)',
+};
+/** ObjectStack schema keywords for hover tooltips */
+const SCHEMA_DOCS = {
+    defineStack: 'Define an ObjectStack project or plugin. Validates against ObjectStackDefinitionSchema.',
+    defineView: 'Type-safe helper to define a list or form view for an object.',
+    defineApp: 'Type-safe helper to define an application with navigation.',
+    defineFlow: 'Type-safe helper to define an automation flow.',
+    defineAgent: 'Type-safe helper to define an AI agent with tools and instructions.',
+    manifest: 'Project package configuration — name, version, label, and metadata.',
+    objects: 'Business object definitions with fields, validation, and relationships.',
+    views: 'List and form view configurations for object data display.',
+    flows: 'Automation flows — screen flows, auto-launched, or scheduled.',
+    agents: 'AI agent definitions with model config, tools, and instructions.',
+    actions: 'Button actions, batch operations, and URL redirects.',
+    dashboards: 'Analytics dashboard layouts with widget grids.',
+    permissions: 'Permission sets defining CRUD access per object and field.',
+    roles: 'User role hierarchy for access control.',
+    plugins: 'External plugins to load into the stack.',
+    ownership: "Record ownership model: 'own' (creator-owned) or 'shared'.",
+    objectName: 'Snake_case reference to a business object (e.g. project_task).',
+};
+let diagnosticCollection;
+function activate(context) {
+    diagnosticCollection = vscode.languages.createDiagnosticCollection('objectstack');
+    context.subscriptions.push(diagnosticCollection);
+    // Watch for objectstack.config.ts changes
+    const configWatcher = vscode.workspace.createFileSystemWatcher('**/objectstack.config.ts');
+    configWatcher.onDidChange((uri) => {
+        validateConfigFile(uri);
+    });
+    configWatcher.onDidCreate((uri) => {
+        validateConfigFile(uri);
+    });
+    context.subscriptions.push(configWatcher);
+    // Register hover provider for TypeScript files
+    const hoverProvider = vscode.languages.registerHoverProvider([
+        { scheme: 'file', pattern: '**/*.object.ts' },
+        { scheme: 'file', pattern: '**/*.view.ts' },
+        { scheme: 'file', pattern: '**/objectstack.config.ts' },
+        { scheme: 'file', language: 'typescript' },
+    ], {
+        provideHover(document, position) {
+            const range = document.getWordRangeAtPosition(position);
+            if (!range)
+                return undefined;
+            const word = document.getText(range);
+            // Check schema-level keywords
+            if (SCHEMA_DOCS[word]) {
+                return new vscode.Hover(new vscode.MarkdownString(`**ObjectStack** — \`${word}\`\n\n${SCHEMA_DOCS[word]}`));
+            }
+            // Check field type values (e.g. type: 'text')
+            const line = document.lineAt(position.line).text;
+            const typeMatch = line.match(/type:\s*['"](\w+)['"]/);
+            if (typeMatch && FIELD_TYPE_DOCS[typeMatch[1]]) {
+                const fieldType = typeMatch[1];
+                if (word === fieldType || word === 'type') {
+                    return new vscode.Hover(new vscode.MarkdownString(`**ObjectStack Field Type** — \`${fieldType}\`\n\n${FIELD_TYPE_DOCS[fieldType]}`));
+                }
+            }
+            return undefined;
+        },
+    });
+    context.subscriptions.push(hoverProvider);
+    // Register code action provider stub for quick fixes
+    const codeActionProvider = vscode.languages.registerCodeActionsProvider([
+        { scheme: 'file', pattern: '**/*.object.ts' },
+        { scheme: 'file', pattern: '**/*.view.ts' },
+        { scheme: 'file', pattern: '**/objectstack.config.ts' },
+    ], {
+        provideCodeActions(document, range, context) {
+            const actions = [];
+            for (const diagnostic of context.diagnostics) {
+                if (diagnostic.source !== 'objectstack')
+                    continue;
+                // Quick fix: add missing label
+                if (diagnostic.message.includes('missing label')) {
+                    const fix = new vscode.CodeAction('Add missing label property', vscode.CodeActionKind.QuickFix);
+                    fix.diagnostics = [diagnostic];
+                    fix.isPreferred = true;
+                    actions.push(fix);
+                }
+                // Quick fix: convert to snake_case
+                if (diagnostic.message.includes('snake_case')) {
+                    const fix = new vscode.CodeAction('Convert name to snake_case', vscode.CodeActionKind.QuickFix);
+                    fix.diagnostics = [diagnostic];
+                    actions.push(fix);
+                }
+            }
+            return actions;
+        },
+    }, { providedCodeActionKinds: [vscode.CodeActionKind.QuickFix] });
+    context.subscriptions.push(codeActionProvider);
+    // Validate open config files on activation
+    if (vscode.window.activeTextEditor) {
+        const uri = vscode.window.activeTextEditor.document.uri;
+        if (uri.fsPath.endsWith('objectstack.config.ts')) {
+            validateConfigFile(uri);
+        }
+    }
+}
+/**
+ * Basic validation for objectstack.config.ts files.
+ * Checks for common structural issues and reports diagnostics.
+ */
+function validateConfigFile(uri) {
+    const document = vscode.workspace.textDocuments.find((doc) => doc.uri.toString() === uri.toString());
+    if (!document)
+        return;
+    const diagnostics = [];
+    const text = document.getText();
+    // Check for missing manifest
+    if (text.includes('defineStack') && !text.includes('manifest')) {
+        const defineStackPos = text.indexOf('defineStack');
+        const pos = document.positionAt(defineStackPos);
+        diagnostics.push(new vscode.Diagnostic(new vscode.Range(pos, pos.translate(0, 'defineStack'.length)), 'defineStack requires a "manifest" property with name and version', vscode.DiagnosticSeverity.Warning));
+    }
+    // Check for camelCase object names (should be snake_case)
+    const nameMatches = text.matchAll(/name:\s*['"]([a-z][a-zA-Z]+)['"]/g);
+    for (const match of nameMatches) {
+        if (match[1] && /[A-Z]/.test(match[1]) && match.index !== undefined) {
+            const pos = document.positionAt(match.index);
+            const endPos = document.positionAt(match.index + match[0].length);
+            diagnostics.push(new vscode.Diagnostic(new vscode.Range(pos, endPos), `Object/field name "${match[1]}" should use snake_case (e.g. "${toSnakeCase(match[1])}")`, vscode.DiagnosticSeverity.Warning));
+        }
+    }
+    diagnosticCollection.set(uri, diagnostics);
+}
+function toSnakeCase(str) {
+    return str.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+function deactivate() {
+    if (diagnosticCollection) {
+        diagnosticCollection.dispose();
+    }
+}
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"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"}

package/language-configuration.json

@@ -0,0 +1,19 @@
+{
+  "comments": {
+    "lineComment": "//",
+    "blockComment": ["/*", "*/"]
+  },
+  "brackets": [
+    ["{", "}"],
+    ["[", "]"],
+    ["(", ")"]
+  ],
+  "autoClosingPairs": [
+    { "open": "{", "close": "}" },
+    { "open": "[", "close": "]" },
+    { "open": "(", "close": ")" },
+    { "open": "'", "close": "'", "notIn": ["string", "comment"] },
+    { "open": "\"", "close": "\"", "notIn": ["string"] },
+    { "open": "`", "close": "`", "notIn": ["string", "comment"] }
+  ]
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "objectstack-vscode",
+  "displayName": "ObjectStack",
+  "description": "ObjectStack Protocol — Autocomplete, validation, and inline diagnostics for .object.ts, .view.ts, and objectstack.config.ts files",
+  "version": "0.1.0",
+  "publisher": "objectstack",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nickmessing/spec"
+  },
+  "engines": {
+    "vscode": "^1.85.0"
+  },
+  "categories": [
+    "Programming Languages",
+    "Linters",
+    "Snippets"
+  ],
+  "activationEvents": [
+    "workspaceContains:**/*.object.ts",
+    "workspaceContains:**/*.view.ts",
+    "workspaceContains:objectstack.config.ts"
+  ],
+  "main": "./dist/extension.js",
+  "contributes": {
+    "jsonValidation": [
+      {
+        "fileMatch": "objectstack.json",
+        "url": "./schemas/objectstack.schema.json"
+      }
+    ],
+    "languages": [
+      {
+        "id": "objectstack",
+        "aliases": [
+          "ObjectStack",
+          "objectstack"
+        ],
+        "extensions": [
+          ".object.ts",
+          ".view.ts"
+        ],
+        "configuration": "./language-configuration.json"
+      }
+    ],
+    "snippets": [
+      {
+        "language": "typescript",
+        "path": "./snippets/objectstack.json"
+      }
+    ]
+  },
+  "devDependencies": {
+    "@types/vscode": "^1.85.0",
+    "typescript": "^5.3.0",
+    "@vscode/vsce": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p ./tsconfig.json",
+    "watch": "tsc -watch -p ./tsconfig.json",
+    "package": "vsce package"
+  }
+}

package/snippets/objectstack.json

@@ -0,0 +1,168 @@
+{
+  "ObjectStack: Define Object": {
+    "prefix": "os-object",
+    "description": "Define a new ObjectStack business object",
+    "body": [
+      "import { Data } from '@objectstack/spec';",
+      "",
+      "const ${1:myObject}: Data.Object = {",
+      "  name: '${2:my_object}',",
+      "  label: '${3:My Object}',",
+      "  pluralLabel: '${3:My Object}s',",
+      "  ownership: 'own',",
+      "  fields: {",
+      "    name: {",
+      "      type: 'text',",
+      "      label: 'Name',",
+      "      required: true,",
+      "      maxLength: 255,",
+      "    },",
+      "    $0",
+      "  },",
+      "};",
+      "",
+      "export default ${1:myObject};"
+    ]
+  },
+  "ObjectStack: Text Field": {
+    "prefix": "os-field-text",
+    "description": "Add a text field to an object",
+    "body": [
+      "${1:field_name}: {",
+      "  type: 'text',",
+      "  label: '${2:Field Label}',",
+      "  required: ${3|false,true|},",
+      "  maxLength: ${4:255},",
+      "},"
+    ]
+  },
+  "ObjectStack: Select Field": {
+    "prefix": "os-field-select",
+    "description": "Add a select (picklist) field to an object",
+    "body": [
+      "${1:status}: {",
+      "  type: 'select',",
+      "  label: '${2:Status}',",
+      "  required: ${3|false,true|},",
+      "  options: [",
+      "    { label: '${4:Active}', value: '${5:active}' },",
+      "    { label: '${6:Inactive}', value: '${7:inactive}' },",
+      "  ],",
+      "  defaultValue: '${5:active}',",
+      "},"
+    ]
+  },
+  "ObjectStack: Lookup Field": {
+    "prefix": "os-field-lookup",
+    "description": "Add a lookup (reference) field to an object",
+    "body": [
+      "${1:related_object}: {",
+      "  type: 'lookup',",
+      "  label: '${2:Related Object}',",
+      "  required: ${3|false,true|},",
+      "  reference: {",
+      "    object: '${4:target_object}',",
+      "    labelField: '${5:name}',",
+      "  },",
+      "},"
+    ]
+  },
+  "ObjectStack: Grid List View": {
+    "prefix": "os-view-grid",
+    "description": "Define a grid list view for an object",
+    "body": [
+      "import { UI } from '@objectstack/spec';",
+      "",
+      "const ${1:myObject}ListView: UI.View = {",
+      "  name: '${2:my_object}_list',",
+      "  label: '${3:My Object} List',",
+      "  type: 'list',",
+      "  objectName: '${2:my_object}',",
+      "  list: {",
+      "    type: 'grid',",
+      "    columns: [",
+      "      { field: 'name', width: 200 },",
+      "      $0",
+      "    ],",
+      "    defaultSort: { field: 'name', direction: 'asc' },",
+      "    pageSize: 25,",
+      "  },",
+      "};",
+      "",
+      "export default ${1:myObject}ListView;"
+    ]
+  },
+  "ObjectStack: Automation Flow": {
+    "prefix": "os-flow",
+    "description": "Define an automation flow",
+    "body": [
+      "import { Automation } from '@objectstack/spec';",
+      "",
+      "const ${1:myFlow}: Automation.Flow = {",
+      "  name: '${2:my_flow}',",
+      "  label: '${3:My Flow}',",
+      "  type: '${4|autolaunched,screen,schedule|}',",
+      "  status: 'draft',",
+      "  trigger: {",
+      "    type: 'record_change',",
+      "    object: '${5:my_object}',",
+      "    events: ['after_insert', 'after_update'],",
+      "  },",
+      "  nodes: [",
+      "    {",
+      "      id: 'start',",
+      "      type: 'start',",
+      "      name: 'Start',",
+      "      next: '${6:end}',",
+      "    },",
+      "    $0",
+      "  ],",
+      "};",
+      "",
+      "export default ${1:myFlow};"
+    ]
+  },
+  "ObjectStack: defineStack Boilerplate": {
+    "prefix": "os-stack",
+    "description": "Full defineStack boilerplate for objectstack.config.ts",
+    "body": [
+      "import { defineStack } from '@objectstack/spec';",
+      "",
+      "export default defineStack({",
+      "  manifest: {",
+      "    name: '${1:my_app}',",
+      "    version: '${2:0.1.0}',",
+      "    label: '${3:My Application}',",
+      "  },",
+      "  objects: [",
+      "    $0",
+      "  ],",
+      "  views: [],",
+      "  plugins: [],",
+      "});"
+    ]
+  },
+  "ObjectStack: AI Agent Definition": {
+    "prefix": "os-agent",
+    "description": "Define an AI agent",
+    "body": [
+      "import { AI } from '@objectstack/spec';",
+      "",
+      "const ${1:myAgent}: AI.Agent = {",
+      "  name: '${2:my_agent}',",
+      "  label: '${3:My Agent}',",
+      "  role: '${4:Assistant}',",
+      "  instructions: '${5:You are a helpful assistant.}',",
+      "  model: {",
+      "    provider: '${6|openai,anthropic,google|}',",
+      "    model: '${7:gpt-4o}',",
+      "  },",
+      "  tools: [",
+      "    $0",
+      "  ],",
+      "};",
+      "",
+      "export default ${1:myAgent};"
+    ]
+  }
+}

package/src/extension.ts

@@ -0,0 +1,226 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+
+import * as vscode from 'vscode';
+
+/** Well-known ObjectStack field types for hover documentation */
+const FIELD_TYPE_DOCS: Record<string, string> = {
+  text: 'Single-line text field (max 255 chars by default)',
+  textarea: 'Multi-line text area for longer content',
+  richtext: 'Rich text editor with HTML formatting',
+  number: 'Decimal number with configurable precision',
+  integer: 'Whole number without decimals',
+  currency: 'Monetary value with currency code',
+  boolean: 'True/false toggle',
+  date: 'Calendar date (no time)',
+  datetime: 'Date with time and timezone',
+  select: 'Single-choice picklist (requires `options`)',
+  multiselect: 'Multi-choice picklist (requires `options`)',
+  lookup: 'Reference to another object (requires `reference`)',
+  master_detail: 'Parent-child relationship with cascade delete',
+  formula: 'Computed field using expressions',
+  email: 'Email address with validation',
+  phone: 'Phone number',
+  url: 'URL with protocol validation',
+  image: 'Image file reference',
+  file: 'File attachment reference',
+  json: 'Arbitrary JSON data',
+  uuid: 'Universally unique identifier',
+  slug: 'URL-friendly identifier (auto-generated from name)',
+  rating: 'Numeric star rating',
+  color: 'Hex color value (#RRGGBB)',
+  vector: 'Numeric vector for AI embeddings and similarity search',
+  encrypted: 'Encrypted at rest — displayed masked in UI',
+  autonumber: 'Auto-incrementing display number',
+  geo_point: 'Geographic coordinates (lat/lng)',
+};
+
+/** ObjectStack schema keywords for hover tooltips */
+const SCHEMA_DOCS: Record<string, string> = {
+  defineStack: 'Define an ObjectStack project or plugin. Validates against ObjectStackDefinitionSchema.',
+  defineView: 'Type-safe helper to define a list or form view for an object.',
+  defineApp: 'Type-safe helper to define an application with navigation.',
+  defineFlow: 'Type-safe helper to define an automation flow.',
+  defineAgent: 'Type-safe helper to define an AI agent with tools and instructions.',
+  manifest: 'Project package configuration — name, version, label, and metadata.',
+  objects: 'Business object definitions with fields, validation, and relationships.',
+  views: 'List and form view configurations for object data display.',
+  flows: 'Automation flows — screen flows, auto-launched, or scheduled.',
+  agents: 'AI agent definitions with model config, tools, and instructions.',
+  actions: 'Button actions, batch operations, and URL redirects.',
+  dashboards: 'Analytics dashboard layouts with widget grids.',
+  permissions: 'Permission sets defining CRUD access per object and field.',
+  roles: 'User role hierarchy for access control.',
+  plugins: 'External plugins to load into the stack.',
+  ownership: "Record ownership model: 'own' (creator-owned) or 'shared'.",
+  objectName: 'Snake_case reference to a business object (e.g. project_task).',
+};
+
+let diagnosticCollection: vscode.DiagnosticCollection;
+
+export function activate(context: vscode.ExtensionContext): void {
+  diagnosticCollection = vscode.languages.createDiagnosticCollection('objectstack');
+  context.subscriptions.push(diagnosticCollection);
+
+  // Watch for objectstack.config.ts changes
+  const configWatcher = vscode.workspace.createFileSystemWatcher('**/objectstack.config.ts');
+
+  configWatcher.onDidChange((uri) => {
+    validateConfigFile(uri);
+  });
+
+  configWatcher.onDidCreate((uri) => {
+    validateConfigFile(uri);
+  });
+
+  context.subscriptions.push(configWatcher);
+
+  // Register hover provider for TypeScript files
+  const hoverProvider = vscode.languages.registerHoverProvider(
+    [
+      { scheme: 'file', pattern: '**/*.object.ts' },
+      { scheme: 'file', pattern: '**/*.view.ts' },
+      { scheme: 'file', pattern: '**/objectstack.config.ts' },
+      { scheme: 'file', language: 'typescript' },
+    ],
+    {
+      provideHover(document, position) {
+        const range = document.getWordRangeAtPosition(position);
+        if (!range) return undefined;
+
+        const word = document.getText(range);
+
+        // Check schema-level keywords
+        if (SCHEMA_DOCS[word]) {
+          return new vscode.Hover(
+            new vscode.MarkdownString(`**ObjectStack** — \`${word}\`\n\n${SCHEMA_DOCS[word]}`),
+          );
+        }
+
+        // Check field type values (e.g. type: 'text')
+        const line = document.lineAt(position.line).text;
+        const typeMatch = line.match(/type:\s*['"](\w+)['"]/);
+        if (typeMatch && FIELD_TYPE_DOCS[typeMatch[1]]) {
+          const fieldType = typeMatch[1];
+          if (word === fieldType || word === 'type') {
+            return new vscode.Hover(
+              new vscode.MarkdownString(
+                `**ObjectStack Field Type** — \`${fieldType}\`\n\n${FIELD_TYPE_DOCS[fieldType]}`,
+              ),
+            );
+          }
+        }
+
+        return undefined;
+      },
+    },
+  );
+
+  context.subscriptions.push(hoverProvider);
+
+  // Register code action provider stub for quick fixes
+  const codeActionProvider = vscode.languages.registerCodeActionsProvider(
+    [
+      { scheme: 'file', pattern: '**/*.object.ts' },
+      { scheme: 'file', pattern: '**/*.view.ts' },
+      { scheme: 'file', pattern: '**/objectstack.config.ts' },
+    ],
+    {
+      provideCodeActions(document, range, context) {
+        const actions: vscode.CodeAction[] = [];
+
+        for (const diagnostic of context.diagnostics) {
+          if (diagnostic.source !== 'objectstack') continue;
+
+          // Quick fix: add missing label
+          if (diagnostic.message.includes('missing label')) {
+            const fix = new vscode.CodeAction(
+              'Add missing label property',
+              vscode.CodeActionKind.QuickFix,
+            );
+            fix.diagnostics = [diagnostic];
+            fix.isPreferred = true;
+            actions.push(fix);
+          }
+
+          // Quick fix: convert to snake_case
+          if (diagnostic.message.includes('snake_case')) {
+            const fix = new vscode.CodeAction(
+              'Convert name to snake_case',
+              vscode.CodeActionKind.QuickFix,
+            );
+            fix.diagnostics = [diagnostic];
+            actions.push(fix);
+          }
+        }
+
+        return actions;
+      },
+    },
+    { providedCodeActionKinds: [vscode.CodeActionKind.QuickFix] },
+  );
+
+  context.subscriptions.push(codeActionProvider);
+
+  // Validate open config files on activation
+  if (vscode.window.activeTextEditor) {
+    const uri = vscode.window.activeTextEditor.document.uri;
+    if (uri.fsPath.endsWith('objectstack.config.ts')) {
+      validateConfigFile(uri);
+    }
+  }
+}
+
+/**
+ * Basic validation for objectstack.config.ts files.
+ * Checks for common structural issues and reports diagnostics.
+ */
+function validateConfigFile(uri: vscode.Uri): void {
+  const document = vscode.workspace.textDocuments.find(
+    (doc) => doc.uri.toString() === uri.toString(),
+  );
+  if (!document) return;
+
+  const diagnostics: vscode.Diagnostic[] = [];
+  const text = document.getText();
+
+  // Check for missing manifest
+  if (text.includes('defineStack') && !text.includes('manifest')) {
+    const defineStackPos = text.indexOf('defineStack');
+    const pos = document.positionAt(defineStackPos);
+    diagnostics.push(
+      new vscode.Diagnostic(
+        new vscode.Range(pos, pos.translate(0, 'defineStack'.length)),
+        'defineStack requires a "manifest" property with name and version',
+        vscode.DiagnosticSeverity.Warning,
+      ),
+    );
+  }
+
+  // Check for camelCase object names (should be snake_case)
+  const nameMatches = text.matchAll(/name:\s*['"]([a-z][a-zA-Z]+)['"]/g);
+  for (const match of nameMatches) {
+    if (match[1] && /[A-Z]/.test(match[1]) && match.index !== undefined) {
+      const pos = document.positionAt(match.index);
+      const endPos = document.positionAt(match.index + match[0].length);
+      diagnostics.push(
+        new vscode.Diagnostic(
+          new vscode.Range(pos, endPos),
+          `Object/field name "${match[1]}" should use snake_case (e.g. "${toSnakeCase(match[1])}")`,
+          vscode.DiagnosticSeverity.Warning,
+        ),
+      );
+    }
+  }
+
+  diagnosticCollection.set(uri, diagnostics);
+}
+
+function toSnakeCase(str: string): string {
+  return str.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+
+export function deactivate(): void {
+  if (diagnosticCollection) {
+    diagnosticCollection.dispose();
+  }
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}