namel3ss 0.1.0a0__tar.gz

namel3ss-0.1.0a0/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## v0.1.0-alpha
+
+- Language core (Phases 1–3): Stable keywords, parser/AST/IR contracts, deterministic defaults.
+- Full-stack UI + actions (Phase 4): Pages, actions, and runtime wiring for forms/buttons/tables.
+- AI + memory + tools (Phase 5): AI declarations with memory profiles and tool exposure.
+- Multi-agent workflows (Phase 6): Agent declarations plus sequential/parallel agent execution.
+- CLI, formatter, linter (Phase 7): File-first CLI, formatting rules, linting for grammar/safety.
+- Studio (viewer → interactor → safe edits) (Phase 8): Manifest viewer, action runner, and guarded edits.
+- Templates & scaffolding (Phase 10): `n3 new` with CRUD, AI assistant, and multi-agent templates.

namel3ss-0.1.0a0/MANIFEST.in

@@ -0,0 +1,4 @@
+include VERSION
+include CHANGELOG.md
+recursive-include src/namel3ss/templates *
+recursive-include src/namel3ss/studio/web *

namel3ss-0.1.0a0/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: namel3ss
+Version: 0.1.0a0
+Summary: Namel3ss is an English-first, AI-native programming language for full-stack apps with inspectable AI.
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Intended Audience :: Developers
+Classifier: Development Status :: 3 - Alpha
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+
+# Namel3ss
+
+Namel3ss is an English-first, AI-native programming language for building full-stack applications with deterministic behavior and inspectable AI.
+
+```
+pip install namel3ss
+n3 new crud
+n3 crud/app.ai studio
+```
+
+- [Quickstart](docs/quickstart.md)
+- [Examples](examples/)
+- [Changelog](CHANGELOG.md)
+
+## Installation
+- Requires Python 3.10+
+- `pip install namel3ss`
+- `n3 --help` to confirm the CLI entrypoint after installation.
+
+## Run with Ollama (local)
+- Ensure Ollama is running locally.
+- In your `.ai`, set `provider is "ollama"` and a local model (e.g., `model is "llama3.1"`). If omitted, the provider defaults to `mock`.
+- Optional env overrides: `NAMEL3SS_OLLAMA_HOST`, `NAMEL3SS_OLLAMA_TIMEOUT_SECONDS`.
+
+## Run with Tier-1 providers (cloud)
+- Env-first config (config file optional).
+- OpenAI: export `NAMEL3SS_OPENAI_API_KEY` (optional `NAMEL3SS_OPENAI_BASE_URL`, defaults to `https://api.openai.com`).
+- Anthropic (Claude): export `NAMEL3SS_ANTHROPIC_API_KEY`.
+- Gemini: export `NAMEL3SS_GEMINI_API_KEY`.
+- Mistral: export `NAMEL3SS_MISTRAL_API_KEY`.
+
+### Provider selection example (.ai)
+```
+ai "assistant":
+  provider is "openai"
+  model is "gpt-4.1"
+  system_prompt is "You are helpful."
+
+flow "demo":
+  ask ai "assistant" with input: "Hello!" as reply
+  return reply
+```
+Swap `provider`/`model` to `anthropic`+`claude-3`, `gemini`+`gemini-1.5-flash`, `mistral`+`mistral-medium`, or `ollama`+`llama3.1`.
+
+## Now / Next / Later
+- Now: Phase 0 skeleton with docs, CI guardrails, and package scaffolding.
+- Now: Core language contract captured for stable keywords and boundaries.
+- Now: Editable install flow for local development and automation.
+- Next: Lexer tokens, parser entrypoints, and AST node contracts.
+- Next: Deterministic runtime shell with hooks for AI-augmented paths.
+- Next: CLI stub for compile/run loops and ergonomic feedback.
+- Later: IR lowering, optimizer passes, and reproducible execution traces.
+- Later: Deterministic stdlib surface with sandboxed IO and tracing.
+- Later: AI-augmented behaviors (prompted blocks, planners) gated and logged.
+- Later: Performance profiling, caching, and correctness hardening toward v3.
+
+## Getting Started
+- Install editable package: `pip install -e .`
+- Run tests: `python -m pytest -q`
+- Compile check: `python -m compileall src -q`
+- Enforce line limit: `python tools/line_limit_check.py`
+
+## Start a New App
+- Scaffold: `n3 new <template> [project_name]` (templates: `crud`, `ai-assistant`, `multi-agent`)
+- Names default to the template; hyphens become underscores on disk.
+- After scaffolding: `cd <project>` then `n3 app.ai studio` or `n3 app.ai actions`.
+
+## Repository Layout
+- `src/namel3ss/`: language packages (lexer, parser, ast, ir, runtime, cli, errors, utils)
+- `tests/`: pytest suite (add coverage for every feature)
+- `docs/`: roadmap and language contracts
+- `tools/`: repo-level utilities (line-limit enforcement)
+- `.github/workflows/`: CI automation
+
+## Architecture at a Glance
+- Lexer → Parser → AST → IR → Runtime executor pipeline with deterministic defaults and explicit AI boundaries.
+- CLI is file-first (`n3 app.ai ...`) with modes for run, check, lint, format, actions, and studio UI.
+- Runtime supports providers via registry (mock, ollama, openai, anthropic, gemini, mistral) with env-first config and standardized errors.
+- Memory manager handles short-term, semantic, and profile contexts passed into AI calls.
+- Templates (`n3 new ...`) ship starter apps plus `.env`-safe `.gitignore` for secrets.
+
+## Development Notes
+- Each source file must stay under 500 lines.
+- One responsibility per file; if it grows, split into a folder with smaller modules.
+- Prefer folder-first naming (e.g., `parser/core.py`, not `parser_core.py`).
+
+### Migration note (buttons)
+- Buttons are block-only (to avoid grammar chaos):
+  ```
+  button "Run":
+    calls flow "demo"
+  ```
+- Old one-line form is rejected:
+  ```
+  button "Run" calls flow "demo"
+  ```
+
+## Docs
+- [IR Reference](docs/ir.md)
+- [Runtime Model](docs/runtime.md)
+- [Error Reference](docs/errors.md)
+- [Quickstart](docs/quickstart.md)
+- [Providers](docs/providers.md)
+- [Roadmap](docs/roadmap.md)
+
+## Troubleshooting (providers)
+- `Provider '<name>' requires <ENV_VAR>` → set the env var for that provider.
+- `Provider '<name>' authentication failed` → check API key/permissions.
+- `Provider '<name>' unreachable` → check network/DNS/firewall or ensure Ollama is running for local.
+- `Provider '<name>' returned an invalid response` → verify model name, upstream status, and try again.

namel3ss-0.1.0a0/README.md

@@ -0,0 +1,110 @@
+# Namel3ss
+
+Namel3ss is an English-first, AI-native programming language for building full-stack applications with deterministic behavior and inspectable AI.
+
+```
+pip install namel3ss
+n3 new crud
+n3 crud/app.ai studio
+```
+
+- [Quickstart](docs/quickstart.md)
+- [Examples](examples/)
+- [Changelog](CHANGELOG.md)
+
+## Installation
+- Requires Python 3.10+
+- `pip install namel3ss`
+- `n3 --help` to confirm the CLI entrypoint after installation.
+
+## Run with Ollama (local)
+- Ensure Ollama is running locally.
+- In your `.ai`, set `provider is "ollama"` and a local model (e.g., `model is "llama3.1"`). If omitted, the provider defaults to `mock`.
+- Optional env overrides: `NAMEL3SS_OLLAMA_HOST`, `NAMEL3SS_OLLAMA_TIMEOUT_SECONDS`.
+
+## Run with Tier-1 providers (cloud)
+- Env-first config (config file optional).
+- OpenAI: export `NAMEL3SS_OPENAI_API_KEY` (optional `NAMEL3SS_OPENAI_BASE_URL`, defaults to `https://api.openai.com`).
+- Anthropic (Claude): export `NAMEL3SS_ANTHROPIC_API_KEY`.
+- Gemini: export `NAMEL3SS_GEMINI_API_KEY`.
+- Mistral: export `NAMEL3SS_MISTRAL_API_KEY`.
+
+### Provider selection example (.ai)
+```
+ai "assistant":
+  provider is "openai"
+  model is "gpt-4.1"
+  system_prompt is "You are helpful."
+
+flow "demo":
+  ask ai "assistant" with input: "Hello!" as reply
+  return reply
+```
+Swap `provider`/`model` to `anthropic`+`claude-3`, `gemini`+`gemini-1.5-flash`, `mistral`+`mistral-medium`, or `ollama`+`llama3.1`.
+
+## Now / Next / Later
+- Now: Phase 0 skeleton with docs, CI guardrails, and package scaffolding.
+- Now: Core language contract captured for stable keywords and boundaries.
+- Now: Editable install flow for local development and automation.
+- Next: Lexer tokens, parser entrypoints, and AST node contracts.
+- Next: Deterministic runtime shell with hooks for AI-augmented paths.
+- Next: CLI stub for compile/run loops and ergonomic feedback.
+- Later: IR lowering, optimizer passes, and reproducible execution traces.
+- Later: Deterministic stdlib surface with sandboxed IO and tracing.
+- Later: AI-augmented behaviors (prompted blocks, planners) gated and logged.
+- Later: Performance profiling, caching, and correctness hardening toward v3.
+
+## Getting Started
+- Install editable package: `pip install -e .`
+- Run tests: `python -m pytest -q`
+- Compile check: `python -m compileall src -q`
+- Enforce line limit: `python tools/line_limit_check.py`
+
+## Start a New App
+- Scaffold: `n3 new <template> [project_name]` (templates: `crud`, `ai-assistant`, `multi-agent`)
+- Names default to the template; hyphens become underscores on disk.
+- After scaffolding: `cd <project>` then `n3 app.ai studio` or `n3 app.ai actions`.
+
+## Repository Layout
+- `src/namel3ss/`: language packages (lexer, parser, ast, ir, runtime, cli, errors, utils)
+- `tests/`: pytest suite (add coverage for every feature)
+- `docs/`: roadmap and language contracts
+- `tools/`: repo-level utilities (line-limit enforcement)
+- `.github/workflows/`: CI automation
+
+## Architecture at a Glance
+- Lexer → Parser → AST → IR → Runtime executor pipeline with deterministic defaults and explicit AI boundaries.
+- CLI is file-first (`n3 app.ai ...`) with modes for run, check, lint, format, actions, and studio UI.
+- Runtime supports providers via registry (mock, ollama, openai, anthropic, gemini, mistral) with env-first config and standardized errors.
+- Memory manager handles short-term, semantic, and profile contexts passed into AI calls.
+- Templates (`n3 new ...`) ship starter apps plus `.env`-safe `.gitignore` for secrets.
+
+## Development Notes
+- Each source file must stay under 500 lines.
+- One responsibility per file; if it grows, split into a folder with smaller modules.
+- Prefer folder-first naming (e.g., `parser/core.py`, not `parser_core.py`).
+
+### Migration note (buttons)
+- Buttons are block-only (to avoid grammar chaos):
+  ```
+  button "Run":
+    calls flow "demo"
+  ```
+- Old one-line form is rejected:
+  ```
+  button "Run" calls flow "demo"
+  ```
+
+## Docs
+- [IR Reference](docs/ir.md)
+- [Runtime Model](docs/runtime.md)
+- [Error Reference](docs/errors.md)
+- [Quickstart](docs/quickstart.md)
+- [Providers](docs/providers.md)
+- [Roadmap](docs/roadmap.md)
+
+## Troubleshooting (providers)
+- `Provider '<name>' requires <ENV_VAR>` → set the env var for that provider.
+- `Provider '<name>' authentication failed` → check API key/permissions.
+- `Provider '<name>' unreachable` → check network/DNS/firewall or ensure Ollama is running for local.
+- `Provider '<name>' returned an invalid response` → verify model name, upstream status, and try again.

namel3ss-0.1.0a0/VERSION

@@ -0,0 +1 @@
+0.1.0-alpha

namel3ss-0.1.0a0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "namel3ss"
+version = "0.1.0-alpha"
+description = "Namel3ss is an English-first, AI-native programming language for full-stack apps with inspectable AI."
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = []
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Intended Audience :: Developers",
+    "Development Status :: 3 - Alpha",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"namel3ss.templates" = ["**/*.ai", "**/*.md"]
+"namel3ss.studio.web" = ["**/*"]
+
+[project.scripts]
+n3 = "namel3ss.cli.main:main"

namel3ss-0.1.0a0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

namel3ss-0.1.0a0/src/namel3ss/__init__.py

@@ -0,0 +1,4 @@
+"""
+Namel3ss: an English-first, AI-native full-stack programming language runtime package.
+"""
+

namel3ss-0.1.0a0/src/namel3ss/ast/__init__.py

@@ -0,0 +1,5 @@
+"""Abstract syntax tree definitions for Namel3ss."""
+
+from namel3ss.ast import nodes  # noqa: F401
+
+__all__ = ["nodes"]

namel3ss-0.1.0a0/src/namel3ss/ast/agents.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Optional
+
+from namel3ss.ast.base import Node
+
+
+@dataclass
+class AgentDecl(Node):
+    name: str
+    ai_name: str
+    system_prompt: Optional[str]

namel3ss-0.1.0a0/src/namel3ss/ast/ai.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import List, Optional
+
+from namel3ss.ast.base import Node
+
+
+@dataclass
+class AIMemory(Node):
+    short_term: int = 0
+    semantic: bool = False
+    profile: bool = False
+
+
+@dataclass
+class AIDecl(Node):
+    name: str
+    model: str
+    provider: str | None
+    system_prompt: Optional[str]
+    exposed_tools: List[str]
+    memory: AIMemory

namel3ss-0.1.0a0/src/namel3ss/ast/base.py

@@ -0,0 +1,10 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass
+class Node:
+    line: Optional[int]
+    column: Optional[int]

namel3ss-0.1.0a0/src/namel3ss/ast/expressions.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import List, Optional, Union
+
+from namel3ss.ast.base import Node
+
+
+@dataclass
+class Expression(Node):
+    pass
+
+
+@dataclass
+class Literal(Expression):
+    value: Union[str, int, bool]
+
+
+@dataclass
+class VarReference(Expression):
+    name: str
+
+
+@dataclass
+class AttrAccess(Expression):
+    base: str
+    attrs: List[str]
+
+
+@dataclass
+class StatePath(Expression):
+    path: List[str]
+
+
+@dataclass
+class UnaryOp(Expression):
+    op: str
+    operand: Expression
+
+
+@dataclass
+class BinaryOp(Expression):
+    op: str
+    left: Expression
+    right: Expression
+
+
+@dataclass
+class Comparison(Expression):
+    kind: str  # eq, gt, lt
+    left: Expression
+    right: Expression
+
+
+Assignable = Union[VarReference, StatePath]

namel3ss-0.1.0a0/src/namel3ss/ast/nodes.py

@@ -0,0 +1,86 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import List, Optional, Union
+
+from namel3ss.ast.agents import AgentDecl
+from namel3ss.ast.ai import AIDecl, AIMemory
+from namel3ss.ast.base import Node
+from namel3ss.ast.expressions import (
+    Assignable,
+    AttrAccess,
+    BinaryOp,
+    Comparison,
+    Expression,
+    Literal,
+    StatePath,
+    UnaryOp,
+    VarReference,
+)
+from namel3ss.ast.pages import ButtonItem, FormItem, PageDecl, PageItem, TableItem, TextItem, TitleItem
+from namel3ss.ast.program import Flow, Program
+from namel3ss.ast.statements import (
+    AskAIStmt,
+    Find,
+    ForEach,
+    If,
+    Let,
+    Match,
+    MatchCase,
+    ParallelAgentEntry,
+    Repeat,
+    Return,
+    RunAgentStmt,
+    RunAgentsParallelStmt,
+    Save,
+    Set,
+    Statement,
+    TryCatch,
+)
+from namel3ss.ast.tool import ToolDecl
+from namel3ss.ast.records import FieldConstraint, FieldDecl, RecordDecl
+
+__all__ = [
+    "Node",
+    "Flow",
+    "Program",
+    "Statement",
+    "Let",
+    "Set",
+    "If",
+    "Return",
+    "AskAIStmt",
+    "RunAgentStmt",
+    "ParallelAgentEntry",
+    "RunAgentsParallelStmt",
+    "Repeat",
+    "ForEach",
+    "MatchCase",
+    "Match",
+    "TryCatch",
+    "Save",
+    "Find",
+    "Expression",
+    "Literal",
+    "VarReference",
+    "AttrAccess",
+    "StatePath",
+    "UnaryOp",
+    "BinaryOp",
+    "Comparison",
+    "Assignable",
+    "FieldConstraint",
+    "FieldDecl",
+    "RecordDecl",
+    "PageItem",
+    "TitleItem",
+    "TextItem",
+    "FormItem",
+    "TableItem",
+    "ButtonItem",
+    "PageDecl",
+    "AIDecl",
+    "AIMemory",
+    "ToolDecl",
+    "AgentDecl",
+]

namel3ss-0.1.0a0/src/namel3ss/ast/pages.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import List
+
+from namel3ss.ast.base import Node
+
+
+@dataclass
+class PageItem(Node):
+    pass
+
+
+@dataclass
+class TitleItem(PageItem):
+    value: str
+
+
+@dataclass
+class TextItem(PageItem):
+    value: str
+
+
+@dataclass
+class FormItem(PageItem):
+    record_name: str
+
+
+@dataclass
+class TableItem(PageItem):
+    record_name: str
+
+
+@dataclass
+class ButtonItem(PageItem):
+    label: str
+    flow_name: str
+
+
+@dataclass
+class PageDecl(Node):
+    name: str
+    items: List[PageItem]

namel3ss-0.1.0a0/src/namel3ss/ast/program.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import List
+
+from namel3ss.ast.base import Node
+
+
+@dataclass
+class Flow(Node):
+    name: str
+    body: List["Statement"]
+
+
+@dataclass
+class Program(Node):
+    records: List["RecordDecl"]
+    flows: List[Flow]
+    pages: List["PageDecl"]
+    ais: List["AIDecl"]
+    tools: List["ToolDecl"]
+    agents: List["AgentDecl"]

namel3ss-0.1.0a0/src/namel3ss/ast/records.py

@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import List, Optional
+
+from namel3ss.ast.base import Node
+from namel3ss.ast.expressions import Expression
+
+
+@dataclass
+class FieldConstraint(Node):
+    kind: str  # present, unique, gt, lt, pattern, len_min, len_max
+    expression: Optional[Expression] = None
+    pattern: Optional[str] = None
+
+
+@dataclass
+class FieldDecl(Node):
+    name: str
+    type_name: str
+    constraint: Optional[FieldConstraint]
+
+
+@dataclass
+class RecordDecl(Node):
+    name: str
+    fields: List[FieldDecl]