@geraldmaron/construct 1.0.6 → 1.0.8

package/README.md

@@ -1,17 +1,19 @@
 # Construct
 
-> Heads up. Construct is an open source project I started. I am not a developer. This is a side project. There may be bugs, there may be defects, but I'm building it to learn in public. If you'd like to contribute, please do.
+**One AI interface. A team of specialists behind it. Hard gates. Runs locally, or deploys for teams.**
+
+📖 **[Read the docs →](https://geraldmaron.github.io/construct/)** · 🚀 **[5-minute quickstart →](https://geraldmaron.github.io/construct/docs/start)** · 📦 `npm install -g @geraldmaron/construct`
 
-One AI interface. A team of specialists behind it. Hard gates. Runs locally, or deploys for teams.
+---
+
+> Heads up. Construct is an open source project I started. I am not a developer. This is a side project. There may be bugs, there may be defects, but I'm building it to learn in public. If you'd like to contribute, please do.
 
 Construct sits on top of Claude Code, OpenCode, Codex, Cursor, and Copilot. You talk to one persona called `construct`. Behind it is a team of specialists shaped by your **org profile**: software R&D by default, with curated profiles for operations, creative, and research orgs, plus a schema-validated escape hatch for custom profiles. Each profile organizes its specialists by department (Product, Engineering, Operations, etc.) and carries its own intake taxonomy, doc templates, and role set. Sessions survive boundary changes via durable state in `.cx/`, beads, and a local vector index. Solo by default. Can deploy centrally for teams that want shared memory, telemetry, queues, and policy.
 
-`construct profile show|list|set <id>` to switch. See [`docs/concepts/profile-lifecycle.md`](./docs/concepts/profile-lifecycle.md) for how new profiles are built (it's a research process, not a JSON exercise).
+`construct profile show|list|set <id>` to switch. See [Profile lifecycle](https://geraldmaron.github.io/construct/docs/concepts/profile-lifecycle) for how new profiles are built (it's a research process, not a JSON exercise).
 
 The team and enterprise modes exist because I wanted to learn what shipping a real multi-tenant tool would look like. The project is still open source, the code is still public, and the bar is still "does this help me learn." Run it solo if that's all you need.
 
-Full docs: [`geraldmaron.github.io/construct/v2/`](https://geraldmaron.github.io/construct/v2/).
-
 ## Getting started
 
 Install the CLI (once per machine):
@@ -37,20 +39,20 @@ Open your editor and talk to `@construct`. A walkthrough lives in `construct_gui
 
 No Node? Try `brew install geraldmaron/construct/construct`. Cloning a project that already uses Construct? `npx -y @geraldmaron/construct init` wires it up.
 
-[Five minute walkthrough](https://geraldmaron.github.io/construct/v2/docs/start).
+[Five minute walkthrough](https://geraldmaron.github.io/construct/docs/start).
 
 ## What you can do
 
 | If you want to... | Read |
 |---|---|
-| Install and run a first task | [Start](https://geraldmaron.github.io/construct/v2/docs/start) |
-| Understand how it works | [Architecture](https://geraldmaron.github.io/construct/v2/docs/concepts/architecture) |
-| Pick a deployment mode | [Deployment model](https://geraldmaron.github.io/construct/v2/docs/concepts/deployment-model) |
-| Drop a signal and triage it | [Intake and triage](https://geraldmaron.github.io/construct/v2/docs/concepts/intake-and-triage) |
-| Add a custom specialist | [Add a custom agent](https://geraldmaron.github.io/construct/v2/docs/cookbook/add-a-custom-agent) |
-| Fix a blocked commit or red CI | [Fix a policy violation](https://geraldmaron.github.io/construct/v2/docs/cookbook/fix-a-policy-violation) |
-| Plug in your own LLM | [Plug in your own LLM](https://geraldmaron.github.io/construct/v2/docs/cookbook/plug-in-your-own-llm) |
-| Look up a CLI command | [CLI reference](https://geraldmaron.github.io/construct/v2/docs/reference/cli) |
+| Install and run a first task | [Start](https://geraldmaron.github.io/construct/docs/start) |
+| Understand how it works | [Architecture](https://geraldmaron.github.io/construct/docs/concepts/architecture) |
+| Pick a deployment mode | [Deployment model](https://geraldmaron.github.io/construct/docs/concepts/deployment-model) |
+| Drop a signal and triage it | [Intake and triage](https://geraldmaron.github.io/construct/docs/concepts/intake-and-triage) |
+| Add a custom specialist | [Add a custom agent](https://geraldmaron.github.io/construct/docs/cookbook/add-a-custom-agent) |
+| Fix a blocked commit or red CI | [Fix a policy violation](https://geraldmaron.github.io/construct/docs/cookbook/fix-a-policy-violation) |
+| Plug in your own LLM | [Plug in your own LLM](https://geraldmaron.github.io/construct/docs/cookbook/plug-in-your-own-llm) |
+| Look up a CLI command | [CLI reference](https://geraldmaron.github.io/construct/docs/reference/cli) |
 
 Works with Anthropic, OpenRouter, Ollama, and other OpenAI-compatible providers.
 
@@ -62,17 +64,17 @@ Three modes. `solo` is the default and runs everything locally. Filesystem queue
 
 `enterprise` adds tenant isolation, RBAC and ABAC scaffolding, isolated worker containers, signed MCP allowlists, and mandatory audit.
 
-Pick or change modes with `construct config mode [solo|team|enterprise]`. [Deployment model](https://geraldmaron.github.io/construct/v2/docs/concepts/deployment-model).
+Pick or change modes with `construct config mode [solo|team|enterprise]`. [Deployment model](https://geraldmaron.github.io/construct/docs/concepts/deployment-model).
 
 ## Intake
 
 Anything dropped into `.cx/inbox/` (a bug report, a customer comment, a competitor PDF, a postmortem draft) is classified by the active profile's intake taxonomy. The default `rnd` profile uses bug, user-signal, experiment, architecture, incident, security, requirement, research, ops, eval-finding, launch-asset, legal-compliance. The `operations` profile uses request, incident, ops, security, docs. The `creative` profile uses brief, content-request, asset, experiment, report. The `research` profile uses question, study, synthesis, report.
 
-Each signal gets a primary owner and a recommended handoff chain. Inspect with `construct intake list` and `construct intake show <id>`. Generate a task graph with `construct graph from-intake <id>`. The classifier runs in the daemon and is deterministic. The agent in your editor does the actual analysis. [Intake and triage](https://geraldmaron.github.io/construct/v2/docs/concepts/intake-and-triage).
+Each signal gets a primary owner and a recommended handoff chain. Inspect with `construct intake list` and `construct intake show <id>`. Generate a task graph with `construct graph from-intake <id>`. The classifier runs in the daemon and is deterministic. The agent in your editor does the actual analysis. [Intake and triage](https://geraldmaron.github.io/construct/docs/concepts/intake-and-triage).
 
 ## Hard gates
 
-Every code mutation runs through enforcement. No secrets committed, tests green, docs current, comments lint-clean, CI passes. Gates live in three places: write-time, commit-time, CI safety net. They can only be bypassed with explicit env vars so every exception leaves an audit trail. [Gates and enforcement](https://geraldmaron.github.io/construct/v2/docs/concepts/gates-and-enforcement).
+Every code mutation runs through enforcement. No secrets committed, tests green, docs current, comments lint-clean, CI passes. Gates live in three places: write-time, commit-time, CI safety net. They can only be bypassed with explicit env vars so every exception leaves an audit trail. [Gates and enforcement](https://geraldmaron.github.io/construct/docs/concepts/gates-and-enforcement).
 
 ## Learning loops
 
@@ -91,7 +93,6 @@ Construct gets smarter on its own. Every session ends with an automatic capture:
 | `construct init` | Initialize project and start services |
 | `construct install` | Machine setup: install Docker, cm, and bootstrap config |
 | `construct intake` | View and process the active profile's intake queue (queue label varies by profile) |
-| `construct models` | Manage AI model assignments |
 | `construct profile` | Manage the active org profile and its lifecycle (draft, promote, archive, health) |
 | `construct recommendations` | View and manage artifact recommendations |
 | `construct sandbox` | Isolated tmpdir-based environment for QA / specialist dry-runs |
@@ -103,7 +104,7 @@ Construct gets smarter on its own. Every session ends with an automatic capture:
 
 | Command | What it does |
 |---|---|
-| `construct bootstrap` | Import seed observations |
+| `construct bootstrap` | Import seed observation corpus into local memory store for cold-start acceleration |
 | `construct customer` | Manage customer profiles for product intelligence |
 | `construct distill` | Distill documents with query-focused chunking |
 | `construct drop` | Ingest file from Downloads/Desktop |
@@ -114,43 +115,44 @@ Construct gets smarter on its own. Every session ends with an automatic capture:
 | `construct integrations` | Check and manage external system connections |
 | `construct knowledge` | Query, index, or add to the project knowledge base |
 | `construct memory` | Inspect memory layer |
-| `construct reflect` | Capture improvement feedback |
+| `construct reflect` | Capture improvement feedback from chat session and update Construct core |
 | `construct search` | Hybrid search across project state |
 | `construct storage` | Manage storage backend |
-| `construct team` | Team review and templates |
+| `construct tags` | Manage the controlled tag vocabulary (propose, add, deprecate, audit) |
+| `construct team` | Team review and template listing |
 | `construct wireframe` | Generate wireframes from description |
+| `construct workflow` | Instantiate workflow templates (PRD-to-review chains, onboarding, handoffs) |
 | `construct workspace` | Manage PM workspaces for multi-PM signal routing |
 
 ### Integrations
 
 | Command | What it does |
 |---|---|
-| `construct claude:allow` | Manage Claude Code permissions |
-| `construct hosts` | Check host capabilities |
-| `construct mcp` | Manage MCP integrations |
+| `construct creds` | Manage provider credentials (set, rotate, revoke, list) |
 | `construct ollama` | Manage local Ollama models |
-| `construct plugin` | Manage plugin manifests |
+| `construct providers` | Provider status, circuit-breaker reset, and resource discovery |
 
 ### Observability
 
 | Command | What it does |
 |---|---|
-| `construct cost` | Token usage and cost breakdown |
-| `construct efficiency` | Read efficiency metrics |
-| `construct evals` | Evaluator catalog |
-| `construct llm-judge` | LLM-as-judge evaluations |
-| `construct optimize` | Prompt optimization |
-| `construct review` | Agent performance review |
+| `construct efficiency` | Show read efficiency, repeated files, and context-budget guidance |
+| `construct eval-datasets` | Sync scored Langfuse traces into eval datasets for prompt regression testing |
+| `construct evals` | Show evaluator catalog for prompt and agent experiments |
+| `construct llm-judge` | Run LLM-as-a-judge evaluations on unscored traces for continuous quality feedback |
+| `construct optimize` | Prompt optimization using Langfuse trace quality scores |
+| `construct review` | Generate agent performance review from Langfuse trace backend |
+| `construct telemetry` | Query telemetry traces and latency data |
+| `construct telemetry-backfill` | Backfill sparse traces with observations (trace backend) |
 
 ### Advanced
 
 | Command | What it does |
 |---|---|
-| `construct audit` | Audit Construct internals |
 | `construct auth:status` | Check auth status |
 | `construct backup` | System backups |
 | `construct beads` | Task queue management |
-| `construct cleanup` | Clean stale processes |
+| `construct ci` | Local CI mirror: run CI jobs locally or view recent run status |
 | `construct completions` | Shell completion scripts |
 | `construct config` | Deployment mode configuration |
 | `construct diff` | Show agent changes since HEAD |
@@ -158,8 +160,10 @@ Construct gets smarter on its own. Every session ends with an automatic capture:
 | `construct gates:audit` | Audit policy gates |
 | `construct hooks:health` | Check hook health |
 | `construct list` | List all agents |
+| `construct policy` | Show active policy gates with enforcement details |
 | `construct provider` | Provider management |
 | `construct role` | Role framework management |
+| `construct scheduler` | Manage scheduled background jobs (tag-mining, doc-hygiene, skill-rollup) |
 | `construct skills` | Skill relevance detection |
 | `construct uninstall` | Remove Construct state |
 | `construct update` | Reinstall this checkout |
@@ -180,10 +184,10 @@ Construct gets smarter on its own. Every session ends with an automatic capture:
 <!-- AUTO:structure -->
 ```text
 construct/
-├── agents           Registry and generated platform adapter chains
 ├── apps             User-facing apps shipped from this repo (e.g. apps/docs/, the Fumadocs docs site)
 ├── bin              CLI entrypoint (`construct`)
 ├── commands         Command prompt assets
+├── config
 ├── dashboard
 ├── db
 ├── deploy
@@ -199,6 +203,7 @@ construct/
 ├── scripts
 ├── services
 ├── skills           Reusable domain knowledge files
+├── specialists
 ├── templates
 ├── tests            Test suite
 ```