@geraldmaron/construct 1.0.7 → 1.0.8

package/commands/work/optimize-prompts.md

@@ -18,7 +18,7 @@ Optimize prompt fragments and overlays, not the runtime orchestration policy. If
 
 ## Required steps
 
-1. **Read current prompt**: read the agent's prompt from `agents/registry.json` (or its `promptFile`)
+1. **Read current prompt**: read the agent's prompt from `specialists/registry.json` (or its `promptFile`)
 2. **Fetch recent scores**: GET `{CONSTRUCT_TELEMETRY_URL}/api/public/scores?name=quality&limit=200`
 3. **Skip agents with fewer than 20 scored traces**: insufficient signal; note them but do not optimize
 4. **Diagnose failure patterns**: analyze low-scoring traces, identify top 3 recurring patterns

package/db/schema/007_tags.sql

@@ -0,0 +1,30 @@
+-- Tag attribution and migration tracking for construct_documents.
+-- The construct_documents.tags JSONB column already exists in 001_init.sql.
+-- This migration adds GIN indexing, attribution history, and migration audit.
+
+create index if not exists construct_documents_tags_gin_idx
+  on construct_documents using gin (tags jsonb_path_ops);
+
+create table if not exists construct_tag_attribution (
+  document_id text not null references construct_documents(id) on delete cascade,
+  tag text not null,
+  source text not null,  -- 'agent:classifier' | 'user' | 'curator'
+  confidence numeric,
+  applied_at timestamptz not null default now(),
+  migrated_from text,
+  primary key (document_id, tag, source)
+);
+create index if not exists construct_tag_attribution_tag_idx on construct_tag_attribution (tag);
+
+create table if not exists construct_tag_migrations (
+  id text primary key,
+  from_tag text not null,
+  to_tag text,
+  executed_at timestamptz not null default now(),
+  executed_by text not null,
+  reason text not null,
+  doc_count_before integer not null,
+  doc_count_after integer,
+  reversible boolean not null default true,
+  rolled_back_at timestamptz
+);

package/db/schema/008_skill_usage.sql

@@ -0,0 +1,24 @@
+-- db/schema/008_skill_usage.sql — Per-skill invocation log.
+--
+-- Backs `construct skills usage/orphans/hot`.  The local
+-- JSONL path (~/.cx/skill-calls.jsonl) is primary in solo mode; this table is
+-- primary in team/enterprise mode.  One-time backfill via
+-- `construct skills backfill-postgres`.
+
+create table if not exists construct_skill_invocations (
+  id           bigserial    primary key,
+  ts           timestamptz  not null,
+  skill_id     text         not null,
+  source       text         not null,  -- 'mcp' | 'role-preload' | 'prompt-composer' | …
+  agent_id     text,
+  session_id   text,
+  caller_context text,
+  latency_ms   integer,
+  tokens_returned integer
+);
+
+create index if not exists construct_skill_invocations_skill_ts_idx
+  on construct_skill_invocations (skill_id, ts desc);
+
+create index if not exists construct_skill_invocations_session_idx
+  on construct_skill_invocations (session_id);

package/db/schema/009_scheduler.sql

@@ -0,0 +1,14 @@
+-- Scheduler job state for team and enterprise deployment modes.
+-- Solo mode uses native trigger files instead of this table.
+-- The lock_holder column stores a short identifier for the process/host
+-- that currently holds the advisory lock for a running job.
+
+create table if not exists construct_scheduled_jobs (
+  id text primary key,
+  schedule text not null,
+  last_run_at timestamptz,
+  last_run_status text,
+  lock_holder text,
+  lock_acquired_at timestamptz,
+  created_at timestamptz not null default now()
+);

package/examples/internal/roles/architect/bad/clever-plan-without-contracts.md

@@ -7,7 +7,7 @@ verdict: fail
 summary: Recommends a clever architecture without exposing contracts or rejected alternatives.
 references:
   - skills/roles/architect.md
-  - agents/prompts/cx-architect.md
+  - specialists/prompts/cx-architect.md
 tags:
   - missing-contracts
   - hidden-dependencies

package/examples/internal/roles/architect/golden/explicit-tradeoff-before-plan.md

@@ -7,7 +7,7 @@ verdict: pass
 summary: Makes interface and dependency tradeoffs explicit before locking in a plan.
 references:
   - skills/roles/architect.md
-  - agents/prompts/cx-architect.md
+  - specialists/prompts/cx-architect.md
 tags:
   - tradeoffs
   - contracts

package/examples/internal/roles/engineer/bad/speculative-abstraction.md

@@ -7,7 +7,7 @@ verdict: fail
 summary: Introduces an abstraction for future cases without evidence from the code.
 references:
   - skills/roles/engineer.md
-  - agents/prompts/cx-engineer.md
+  - specialists/prompts/cx-engineer.md
 tags:
   - speculative-abstraction
   - unnecessary-surface-area

package/examples/internal/roles/engineer/golden/read-before-write.md

@@ -7,7 +7,7 @@ verdict: pass
 summary: Reads the touched files and surrounding pattern before proposing code changes.
 references:
   - skills/roles/engineer.md
-  - agents/prompts/cx-engineer.md
+  - specialists/prompts/cx-engineer.md
 tags:
   - read-before-write
   - local-conventions

package/examples/internal/roles/qa/bad/coverage-theater.md

@@ -7,7 +7,7 @@ verdict: fail
 summary: Treats a green suite or coverage number as proof that the behavior is safe.
 references:
   - skills/roles/qa.md
-  - agents/prompts/cx-qa.md
+  - specialists/prompts/cx-qa.md
 tags:
   - coverage-theater
   - false-confidence

package/examples/internal/roles/qa/golden/regression-gate.md

@@ -7,7 +7,7 @@ verdict: pass
 summary: Verifies changed behavior with regression-oriented tests instead of coverage theater.
 references:
   - skills/roles/qa.md
-  - agents/prompts/cx-qa.md
+  - specialists/prompts/cx-qa.md
 tags:
   - regression
   - changed-behavior

package/examples/seed-observations/decisions.md

@@ -33,4 +33,4 @@ Hook guards for workflow, drive, bootstrap, and task behavior are expressed as Y
 
 ## Registry as Single Source of Truth
 
-`agents/registry.json` is the canonical definition for all agents on all platforms (Claude Code, OpenCode, Codex, Copilot). `construct sync` regenerates all platform-specific files from the registry. Never edit generated files directly: edits are overwritten on the next sync.
+`specialists/registry.json` is the canonical definition for all agents on all platforms (Claude Code, OpenCode, Codex, Copilot). `construct sync` regenerates all platform-specific files from the registry. Never edit generated files directly: edits are overwritten on the next sync.

package/lib/audit-skills.mjs

@@ -11,7 +11,7 @@ import path from 'node:path';
 function findConstructRoot(startPath = process.cwd()) {
   let current = path.resolve(startPath);
   while (true) {
-    if (fs.existsSync(path.join(current, 'agents', 'registry.json'))) return current;
+    if (fs.existsSync(path.join(current, 'specialists', 'registry.json'))) return current;
     const parent = path.dirname(current);
     if (parent === current) return path.resolve(startPath);
     current = parent;
@@ -36,7 +36,7 @@ function collectSkillFiles(skillsDir) {
 
 export function auditSkills({ rootDir, silent = false } = {}) {
   const root = rootDir ?? findConstructRoot();
-  const registryPath = path.join(root, 'agents', 'registry.json');
+  const registryPath = path.join(root, 'specialists', 'registry.json');
   const skillsDir = path.join(root, 'skills');
 
   const registry = JSON.parse(fs.readFileSync(registryPath, 'utf8'));
@@ -46,7 +46,7 @@ export function auditSkills({ rootDir, silent = false } = {}) {
   const agentsWithNoSkills = [];
   const missingSkillFiles = [];
 
-  for (const agent of registry.agents ?? []) {
+  for (const agent of registry.specialists ?? []) {
     const skills = agent.skills ?? [];
     if (skills.length === 0) {
       agentsWithNoSkills.push(agent.name);

package/lib/auto-docs.mjs

@@ -397,10 +397,10 @@ function renderAgentsPage(rootDir) {
   return [
     '---',
     'title: Specialists',
-    'description: The 28 specialists behind the construct persona. Generated from agents/registry.json.',
+    'description: The 28 specialists behind the construct persona. Generated from specialists/registry.json.',
     '---',
     '',
-    '> Generated from `agents/registry.json`. Re-run `construct docs:site` to refresh.',
+    '> Generated from `specialists/registry.json`. Re-run `construct docs:site` to refresh.',
     '',
     'Construct ships one persona (`construct`) and 28 specialists behind it. You address `@construct` for all everyday work; it routes to specialists internally. Each specialist has a role, model tier, and prompt file that defines its decision authority.',
     '',