agent-apprenticeship 0.2.1 → 0.3.0

package/docs/dataset_schema.md

@@ -1,160 +0,0 @@
-# Agent Apprenticeship Dataset And Package Schema
-
-Agent Apprenticeship packages capture real agent workflows as reusable experience. A package may include task packets, Apprentice-generated task specs, audited rubrics, traces, actual outputs, artifacts, evaluator/verifier/grader records, mentor or expert checkpoint records, follow-ups, Experience Compiler outputs, and public ecosystem storage references.
-
-## Apprenticeship Modes
-
-New package metadata uses:
-
-- `apprenticeship_mode = autonomous`
-- `apprenticeship_mode = expert_led`
-- `apprenticeship_mode = org_custom`
-
-Legacy packages may include `mentor_mode` for internal compatibility. New public indexes, R2 ecosystem items, compiler manifests, and contribution manifests should include `apprenticeship_mode`.
-
-## Agent Training Contribution Mode
-
-Local settings support:
-
-- Public Ecosystem: completed Experience Compilations are shared through the Forsy R2 ecosystem backend by default.
-- Private Internal Only: completed packages remain local.
-
-This setting is local user preference. It is not written as a public ecosystem item field.
-
-## Core Package Layout
-
-Typical local package content:
-
-- `task/` for task packet, task brief, inputs, and task-intake spec
-- `rubric/` for Apprentice-generated rubric plus audit metadata
-- `attempts/<kind>/agent_trace.json`
-- `attempts/<kind>/actual_outputs.json`
-- `attempts/<kind>/artifacts/`
-- `grading/`, `feedback/`, and `signals/`
-- `mentor_checkpoints/` when expert or organization workflows record checkpoints
-- `experience_compiler/`
-- optional legacy compiler compatibility outputs
-
-`actual_outputs.json` remains the canonical output contract. Final/static outputs are represented by actual outputs, deliverable refs, artifact refs, and copied files rather than large top-level trace fields.
-
-## Experience Compiler Outputs
-
-The Experience Compiler turns completed workflows into reusable skills, evals, verifier specs, reward signals, environment-response rows, runtime learning packages, and training-ready datasets.
-
-Public compiler layout:
-
-- `experience_compiler/compiler_manifest.json`
-- `experience_compiler/compiler_report.json`
-- `experience_compiler/compiler_trace.jsonl`
-- `experience_compiler/compiler_rounds.jsonl`
-- `experience_compiler/compiler_recipe.json`
-- `experience_compiler/compiler_judge_results.jsonl`
-- `experience_compiler/learning_objects_index.json`
-- `experience_compiler/experience_pack/`
-- `experience_compiler/skill_pack/skill.md`
-- `experience_compiler/runtime_learning_package/`
-- `experience_compiler/training_time_package/`
-- `experience_compiler/evals/`
-- `experience_compiler/verifier/`
-- `experience_compiler/reward/`
-- `experience_compiler/environment/`
-- `experience_compiler/reports/`
-
-`skill_pack/skill.md` should be task-specific and evidence-grounded, with best-use guidance, prerequisites, workflow steps, decision points, common failure patterns, recovery strategies, evidence and artifact expectations, verification checklist, examples, and transfer notes.
-
-## Loop Review Evidence
-
-Current Experience Compilations may include per-iteration loop evidence under `loops/`. These artifacts make autonomous model-review loops and Expert-Led review loops inspectable before feedback or continuation decisions.
-
-Required loop review artifacts, when a loop iteration runs:
-
-- `loops/loop_manifest.json`
-- `loops/iterations/<nnn>/review_packet.json`
-- `loops/iterations/<nnn>/review_packet.md`
-- `loops/iterations/<nnn>/output_snapshot.json`
-- `loops/iterations/<nnn>/artifact_index.json`
-- `loops/iterations/<nnn>/trace_refs.json`
-- `loops/iterations/<nnn>/rubric_status.json`
-- `loops/iterations/<nnn>/verifier_status.json`
-- `loops/iterations/<nnn>/evaluator_feedback.json`
-- `loops/iterations/<nnn>/reviewer_feedback.json`
-- `loops/iterations/<nnn>/revision_plan.json`
-- `loops/iterations/<nnn>/diff_report.json`
-- `loops/iterations/<nnn>/loop_decision.json`
-
-Review packets should summarize the current goal, current outputs, actual output contract, artifacts, trace refs, key trace evidence, rubric/verifier status, known failures, missing outputs, surface and environment summaries, diffs, review instructions, and stop/continue choices. `reviewer_feedback.json` should record whether feedback came from a Mentor Model Provider, human expert, organization/custom reviewer, or simulated test checkpoint. Simulated feedback must be labelled as simulated.
-
-Experience Compiler evidence maps can reference `review_packet.json`, `reviewer_feedback.json`, `revision_plan.json`, `loop_decision.json`, and `diff_report.json`. Loop evidence can support critique/revision pairs, reward-model rows, verifier rows, process-supervision rows, failure modes, recovery strategies, and runtime decision rules. Older seed packages remain valid when loop review evidence is absent.
-
-## Runtime Learning Package
-
-Runtime learning material can be injected into future local runs as reusable experience. It may include runtime memory rows, tool-use hints, correction patterns, and Experience Pack references. It must not claim model weights were updated.
-
-## Ecosystem Learning And Experience Packs
-
-Ecosystem Learning creates reversible Experience Packs from seed tasks, Experience Compilations, or pulled ecosystem items. Each Experience Pack contains `skill.md`, compact source refs, replay results, status records, and activation metadata.
-
-## Training-Time Package
-
-Training-time material is ready for future supervised fine-tuning, eval building, verifier training, reward modeling, preference optimization, and environment-response training. It may include:
-
-- `training_examples.jsonl`
-- `evaluation_examples.jsonl`
-- `verifier_examples.jsonl`
-- `reward_model_rows.jsonl`
-- `preference_pairs.jsonl`
-- `failure_cases.jsonl`
-- `task_variants.jsonl`
-- `transfer_eval_tasks.jsonl`
-
-Rows should preserve `source_package_id`, `source_task_id`, `source_trace_id`, `source_step_ids`, `source_artifact_refs`, `source_evaluation_refs`, provenance, quality/fidelity/difficulty/learnability/reuse scores, judge source, audit status, and acceptance status.
-
-## Environment And Surface Data
-
-The environment folder can include:
-
-- `environment_spec.json`
-- `environment_response_pairs.jsonl`
-- `multi_agent_handoffs.jsonl`
-- `multimodal_artifacts.jsonl`
-- `ui_interaction_events.jsonl`
-- `physical_environment_events.jsonl`
-- `api_interaction_events.jsonl`
-- `mcp_interaction_events.jsonl`
-- `database_events.jsonl`
-- `structured_table_events.jsonl`
-- `software_execution_events.jsonl`
-- `search_retrieval_events.jsonl`
-- `enterprise_app_events.jsonl`
-- `async_workflow_events.jsonl`
-- `collaboration_events.jsonl`
-- `document_events.jsonl`
-- `cross_system_events.jsonl`
-
-Empty optional files are valid when a surface is absent.
-
-## Environment Spec
-
-`environment_spec.json` describes replay and world-model readiness. It may include environment type/domain, interaction surfaces, tools, runtime dependencies, input artifacts, setup commands, initial-state refs, allowed actions, reset strategy, verification commands, scoring refs, expected outputs, replay smoke-test details, and sections for API, MCP, database, spreadsheet, software execution, async workflows, collaboration, documents, cross-system dependencies, multi-agent, multimodal, UI/software, and physical/industrial workflows.
-
-## Evaluation Authority
-
-Goal achievement and outcome quality belong to mentor, expert, evaluator, verifier, and grader records. Apprentice Agent self-assessment is not the source of truth. Structural guardrails may check schemas, paths, refs, secrets, and package completeness, but they are not semantic judges.
-
-## R2 Public Ecosystem Records
-
-R2 ecosystem index records include item id, kind, title, summary, domain, subdomain, tags, timestamps, source, package id, task id, `apprenticeship_mode`, Apprentice Agent, Mentor Model Provider, status, counts, Experience Compiler row counts, contributor pseudonymous user id, and storage refs.
-
-Records do not include Agent Training Contribution Mode, local OS username, local hostname, secrets, Cloudflare credentials, or private local paths.
-
-## Backward Compatibility
-
-Raw seed traces and older local packages remain compatible even if new fields are missing. Normalizers should preserve new fields when present and tolerate missing optional fields in older traces. Derived/enriched outputs can be added later without mutating the original seed dataset.
-
-## Future Central Dataset Readiness
-
-Future enrichment can build environment specs, environment-response rows, training examples, eval examples, verifier examples, reward rows, preference pairs, failure cases, task variants, compiler reports, and meta-optimization records across the full seed dataset. This should be versioned clearly and uploaded through central infrastructure, not by mutating local seed data by default.
-
-## Exclusions
-
-Dataset and public package metadata must not include commerce metadata, public ranking language, Apprentice Agent self-eval as outcome truth, API keys, auth tokens, cookies, `.env`, `.env.local`, private local paths, source scrape internals, or huge embedded binaries.

package/docs/local_usage.md

@@ -1,191 +0,0 @@
-# Local Usage
-
-Initialize Agent Apprenticeship:
-
-```bash
-apprentice init --setup
-```
-
-`apprentice` is the short command used in normal docs. `agent-apprenticeship` remains available as the long-form compatibility command.
-
-Run a task:
-
-```bash
-apprentice run "Analyze this CSV and produce an executive summary" --asset ./data.csv
-```
-
-Start interactively:
-
-```bash
-apprentice start
-```
-
-Continue or finish a run:
-
-```bash
-apprentice continue <run_id> "Add sensitivity analysis" --asset ./updated_assumptions.csv
-apprentice finish <run_id>
-```
-
-Each run is written under `~/.agent-apprenticeship/runs/<run-id>/` with progress files, task outputs, traces, Experience Compiler outputs, and an Experience Compilation.
-
-```text
-run_status.json
-progress_events.jsonl
-actual_outputs.json
-experience_compiler/
-contribution_bundle/
-```
-
-Check or watch progress:
-
-```bash
-apprentice status <run_id>
-apprentice watch <run_id>
-```
-
-Use output modes when scripting:
-
-```bash
-apprentice run "Prepare a market brief" --quiet
-apprentice run "Prepare a market brief" --verbose
-apprentice run "Prepare a market brief" --json-progress
-```
-
-## Configuration
-
-Configure the Apprentice Agent, Mentor Model Provider, Apprenticeship Mode, and Agent Training Contribution Mode:
-
-```bash
-apprentice configure agent
-apprentice configure model
-apprentice configure apprenticeship
-apprentice configure contribution
-apprentice settings
-apprentice doctor
-```
-
-Apprenticeship Modes:
-
-- `autonomous`: Autonomous Apprenticeship. The agent works through the task with model guidance, iterative improvement loops, evaluation, and Experience Compiler outputs.
-- `expert-led`: Expert-Led Apprenticeship. The agent works with human expert checkpoints until acceptance criteria are met, expert sign-off is recorded, or the configured loop limit is reached.
-- `org-custom`: Organization Custom. For teams that need private deployment, custom integrations, internal storage, workflow-specific capture, or forward-deployed setup.
-
-Autonomous Apprenticeship needs a ready Mentor Model Provider. API keys are read from exported environment variables first and then from `.env.local` in the project or app home. `.env.local` is gitignored and key values are never printed.
-
-Agent Training Contribution Modes:
-
-- `public-ecosystem`: completed task and follow-up packages are shared to the Forsy ecosystem through Cloudflare R2.
-- `private-internal-only`: packages stay local unless explicitly contributed later.
-
-```bash
-apprentice ecosystem configure --training-contribution public-ecosystem
-apprentice ecosystem configure --training-contribution private-internal-only
-```
-
-## Integrations
-
-Apprentice Agents:
-
-- `codex`
-- `cursor`
-- `claude-code`
-- `openclaw`
-- `opencode`
-- `hermes-agent`
-- `custom`
-
-Mentor Model Providers:
-
-- `openai`
-- `anthropic`
-- `google`
-- `openrouter`
-
-Run:
-
-```bash
-apprentice integrations
-apprentice certify-integrations --all
-```
-
-Use `--all-combinations` only when you intentionally want every Apprentice Agent and Mentor Model Provider pair; it is slower and can consume provider quota.
-
-## Experience Compiler
-
-The Experience Compiler turns each completed workflow into reusable skills, evals, verifier specs, reward signals, environment-response data, runtime learning packages, and training-ready datasets.
-
-Public packages include:
-
-```text
-experience_compiler/
-  experience_pack/
-  skill_pack/
-  runtime_learning_package/
-  training_time_package/
-  evals/
-  verifier/
-  reward/
-  environment/
-  reports/
-```
-
-`actual_outputs.json` remains the canonical output contract for completed task artifacts.
-
-## Ecosystem
-
-Cloudflare R2 is the default ecosystem storage backend.
-
-```bash
-apprentice ecosystem status
-apprentice ecosystem list
-apprentice ecosystem search "finance"
-apprentice ecosystem inspect <item_id>
-apprentice ecosystem pull <item_id>
-```
-
-Share a package explicitly:
-
-```bash
-apprentice ecosystem contribute ~/.agent-apprenticeship/runs/<run-id>/contribution_bundle
-```
-
-Dry-run a share:
-
-```bash
-apprentice ecosystem contribute ~/.agent-apprenticeship/runs/<run-id>/contribution_bundle --dry-run
-```
-
-Legacy GitHub issue submission remains available only when explicitly selected:
-
-```bash
-apprentice ecosystem contribute <bundle_path> --storage github
-```
-
-Inspect local sharing history:
-
-```bash
-apprentice ecosystem identity
-apprentice ecosystem shared
-apprentice ecosystem shared --json
-apprentice ecosystem list --mine
-```
-
-## Ecosystem Learning
-
-Use Ecosystem Learning when you want your Apprentice Agent to learn from an ecosystem task, trace, or package through a reversible Experience Pack.
-
-```bash
-apprentice ecosystem search cloud
-apprentice ecosystem pull aa-seed-task-501
-apprentice learn create aa-seed-task-501
-apprentice learn preview <pack_id>
-apprentice learn replay <pack_id>
-apprentice learn keep <pack_id>
-apprentice run "Create a related incident response checklist" --experience-pack <pack_id>
-apprentice learn revert <pack_id>
-```
-
-Experience Packs live in `~/.agent-apprenticeship/experience_packs/<pack_id>/`.
-
-Rich artifacts are included through indexing rather than special folder rules. Reports, spreadsheets, CSV/JSON/Markdown, screenshots, browser logs, MCP/tool logs, notebooks, code, and generated files are packaged when they appear in the run/package artifact areas and are linked to trace steps.

package/docs/scaling_to_1000_tasks.md

@@ -1,3 +0,0 @@
-# Scaling to 1000 tasks
-
-Use `run-batch` with checkpointing, resume, progress logging, local packages, and release export. Start with 1, then 3, then 10 tasks before increasing parallelism. Each task packet preserves workflow traces, artifacts, model-judged evaluation, verifier-backed reliability, and revision signals for downstream research use.

package/docs/trace_schema.md

@@ -1,192 +0,0 @@
-# Agent Apprenticeship Trace Schema
-
-## Purpose
-
-Agent Apprenticeship traces record authentic task work so completed workflows can become reusable agent experience. AgentTrace records observable workflow steps: task state, Apprentice Agent action, observed environment response, next state, artifacts produced, and evidence used by mentors, evaluators, verifiers, and graders.
-
-Official quality labels come from mentor, expert, evaluator, verifier, and grader records, not from Apprentice Agent self-evaluation. This separation keeps the raw trace focused on what happened while outcome labels remain grounded in external evidence.
-
-## Public Product Model
-
-Public task metadata uses `apprenticeship_mode`:
-
-- `autonomous` for Autonomous Apprenticeship
-- `expert_led` for Expert-Led Apprenticeship
-- `org_custom` for Organization Custom
-
-The older internal `mentor_mode` field may remain in legacy packages for compatibility, but public docs and new package metadata should prefer `apprenticeship_mode`. Mentor Model Providers, experts, evaluators, verifiers, and graders remain outcome evidence sources. Apprentice Agent self-assessment is not outcome truth.
-
-## Authentic Workflow Tracing
-
-Trace real task work only. Do not trace Agent Apprenticeship packaging, public upload mechanics, or ecosystem storage steps as task work. Keep one meaningful action per step. Do not compress multiple actions into a vague paragraph. Preserve causality through `caused_by`, `causal_type`, and `causal_note`.
-
-## Canonical Outputs
-
-`actual_outputs.json` is the canonical output contract. Traces should include `actual_outputs_ref` when known, plus `artifact_refs`, `deliverable_refs`, `files_created`, `output_summary`, and `final_output_summary` derived from actual outputs rather than copied raw deliverables.
-
-Large files, screenshots, PDFs, tables, logs, audio, video, workbooks, and binary artifacts must be referenced through package-relative artifact refs. Do not embed huge binaries in JSON.
-
-## Observation, Input, Output, State Change
-
-`observation` records what the agent saw before acting. `input` records the exact command, tool request, user instruction, artifact, or feedback used. `output` records the observed tool/environment response. `state_change` records what changed after the action.
-
-## Step Core Fields
-
-Meaningful non-user steps should populate:
-
-- `step`, `turn`, `actor`, `action`
-- `operation`, `tool`
-- `observation`, `input`, `output`, `state_change`
-- `reasoning`
-- `caused_by`, `causal_type`, `causal_note`
-- `success`, `step_outcome`
-- `artifact_refs` when evidence or outputs are created, read, or validated
-
-## Conditional Fields
-
-Populate conditional fields when the event calls for them:
-
-- `input_source` when input comes from the user, a prior step, a tool result, an artifact, mentor feedback, verifier feedback, expert feedback, a follow-up, or retry context.
-- `feedback_type` and `feedback_content` when the step records feedback, correction, approval, clarification, revision guidance, or follow-up instructions.
-- `retry_of` when a step repairs or revises a prior step.
-- `alternatives_considered` for meaningful strategy, tool, remediation, or design choices.
-- `execution_mode` defaults to `serial`; use `parallel` and `parallel_group` only for real fanout work.
-- `started_at` and `ended_at` only when measured by runtime.
-
-## Environment Domain Taxonomy And Interaction Surface Taxonomy
-
-Every meaningful operation should identify its direct interface with `interaction_surface`, broader category with `environment_domain`, and a subtype with `surface_type` when useful.
-
-Supported surfaces:
-
-- `api`
-- `mcp_tool`, `mcp_resource`, `mcp_prompt`
-- `browser`, `computer_use`
-- `cli`, `file`, `codebase`
-- `database`
-- `spreadsheet`, `table`
-- `search`
-- `cloud_console`, `saas_app`
-- `async_job`, `queue`, `webhook`, `scheduler`
-- `messaging`, `email`, `collaboration`
-- `document`, `pdf`
-- `multimodal`
-- `device`, `industrial`, `physical`
-- `mixed`, `other_tool`, `other_surface`, `unknown`
-
-If a workflow crosses systems, use `environment_domain = mixed`, record `connected_surfaces`, split actions by system, and preserve `cross_system_dependencies`, `handoff_refs`, `state_sync_refs`, `consistency_checks`, and `system_of_record`.
-
-## Surface-Specific Evidence
-
-When an operation clearly uses a surface, do not leave the relevant fields silently empty. If data is unavailable, set `surface_capture_status`, `surface_capture_notes`, and `missing_surface_fields`.
-
-API steps should capture endpoint, method, version, status, request/response refs, resource IDs, auth mode without secrets, pagination, rate limits, retries, and errors.
-
-MCP steps should capture server, capability type, tool/resource/prompt name, argument refs, result refs, schemas, call IDs, and errors.
-
-Database steps should capture database type, schema/table, query type, query ref or hash, row counts, affected rows, transaction IDs, snapshots, explain plans, rollback refs, and errors.
-
-Spreadsheet and table steps should capture workbook refs, sheet names, ranges, row/column counts, formula refs, pivots, charts, validation refs, before/after refs, and diffs.
-
-CLI, file, and codebase steps should capture command, cwd ref, exit code, stdout/stderr refs, file operations, paths, diffs, patches, git state, test/build/lint refs, process IDs, and timeouts.
-
-Search steps should capture query, provider, scope, filters, result count, selected result refs, citation refs, ranking signals, time range, and errors.
-
-Browser, computer-use, and software steps should capture UI surface, app name/version, OS, device, window/page title, URL or resource ID, visible-state refs, screenshot refs, DOM/accessibility refs, selectors, coordinates, action type, input text, before/after refs, network/API refs, and software state refs.
-
-Cloud, SaaS, and enterprise app steps should capture service, workspace/project/tenant identifiers when safe, resource or ticket IDs, object state refs, permission context, region, environment, deployment IDs, audit logs, and change-request refs.
-
-Async, queue, webhook, and scheduler steps should capture job/message/webhook/schedule IDs, trigger type, enqueue/start/completion times, retry count, delivery/polling/callback status, result refs, and dead-letter refs.
-
-Messaging, email, and collaboration steps should capture platform, channel/thread/message IDs, sender/recipient roles, message refs, attachment refs, decisions, approval state, and follow-up requirements.
-
-Document, PDF, report, and extraction steps should capture document refs, document type, page/section refs, text/OCR/table/figure/citation/annotation refs, summaries, and document diffs.
-
-Device, industrial, and physical workflow steps should capture physical environment type, device details when safe, sensor/telemetry refs, actuator command summaries, control mode, before/after physical state refs, calibration refs, safety state, safety limits, operator override, human supervision, simulation or real-world status, latency, tolerance, rollback action, emergency stop, and compliance refs.
-
-## Multi-Agent And Multimodal Support
-
-Multi-agent workflows should preserve `actor_kind`, `actor_role`, `agent_id`, `agent_name`, `subagent_id`, `subagent_name`, `subagent_role`, `parent_agent_id`, `delegation_id`, `delegation_source_step`, `handoff_reason`, `handoff_payload_ref`, `handoff_output_refs`, `subagent_output_refs`, `coordination_pattern`, `communication_channel`, and `depends_on_agent_outputs`.
-
-Multimodal workflows should preserve `modality`, `modalities`, `media_type`, `mime_type`, `artifact_role`, `artifact_hash`, `artifact_preview_ref`, `ocr_text_ref`, `transcript_ref`, `annotation_ref`, `bbox_refs`, `frame_refs`, `timecode_refs`, `table_refs`, `sheet_refs`, and `derived_text_summary`.
-
-## Completeness Warnings
-
-New traces should record warnings, not fabricate missing values:
-
-- `surface_capture_status = complete | partial | unavailable | not_applicable`
-- `surface_capture_notes`
-- `missing_surface_fields`
-- `trace_quality_warnings`
-
-Old seed traces remain compatible when these fields are absent.
-
-## Loop Review Packets
-
-Each new iterative workflow loop should create review artifacts after an Apprentice Agent iteration and before model or expert review. The package-level structure is:
-
-```text
-loops/
-  loop_manifest.json
-  iterations/
-    001/
-      review_packet.md
-      review_packet.json
-      output_snapshot.json
-      artifact_index.json
-      trace_refs.json
-      rubric_status.json
-      verifier_status.json
-      evaluator_feedback.json
-      reviewer_feedback.json
-      revision_plan.json
-      diff_report.json
-      loop_decision.json
-```
-
-`review_packet.json` is the current iteration dossier. It should include `loop_id`, `loop_iteration`, mode, task/package/run ids, the current goal, output refs, `actual_outputs_ref`, artifact refs and previews, trace refs, key trace steps, rubric and verifier status, evaluator status, known failures, missing outputs, open questions, surface/environment summaries, previous iteration refs, diff from the previous iteration, reviewer instructions, recommended review focus, stop/continue options, and `created_at`.
-
-Autonomous model review should use the review packet as the review source before judging the attempt. Expert-Led review should show or link the packet before collecting expert feedback. Review feedback records should say whether the reviewer was `mentor_model_provider`, `human_expert`, `org_custom_reviewer`, or `simulated_for_test`; simulated or auto-test checkpoints must not be presented as real human review.
-
-Revision plans should cite feedback refs, list issues to fix, artifacts and outputs to update, verification steps, stop conditions, and creation time. The next iteration should record feedback refs used, changes made, changed artifacts/outputs, and whether feedback was applied. Record-only follow-ups may create a follow-up review update without inventing new execution data.
-
-## Experience Compiler Use
-
-The Experience Compiler runs after completed task work and follow-ups. It derives reusable runtime learning and training-time data from package evidence: task packets, rubrics, traces, `actual_outputs.json`, artifacts, attempt manifests, evaluator feedback, grader results, verifier results, revision plans, process supervision, reward modeling, revision preference pairs, lessons, follow-up records, mentor checkpoints, loop review packets, reviewer feedback, loop decisions, and diff reports.
-
-The compiler emits:
-
-- Experience Pack material
-- Skill Pack material, including `skill_pack/skill.md`
-- Runtime Learning Package material
-- Training-Time Package material
-- eval, verifier, reward, and preference rows
-- observed environment-response rows
-- surface event rows
-- `environment_spec.json`
-- reports and transfer-readiness records
-
-It does not claim model training happened. It produces training-ready and runtime-ready material grounded in observed workflow evidence.
-
-## World-Model-Ready Fields
-
-World-model-ready fields include `environment_domain`, `interaction_surface`, `state_before`, `agent_action`, `observed_environment_response`, `state_after`, `turn_idx`, `total_turns`, and environment-response quality scores.
-
-## World-Model-Ready Observed Rows
-
-Observed environment-response rows should include state/action/next-state style data:
-
-- `environment_domain`
-- `interaction_surface`
-- `state_before`
-- `agent_action`
-- `observed_environment_response`
-- `state_after`
-- `turn_idx`, `total_turns`
-- `format_score`, `factuality_score`, `consistency_score`, `realism_score`, `training_quality_score`, `environment_response_quality_score`
-
-These rows are saved as `environment_response_pairs.jsonl` in Experience Compiler outputs. `environment_spec.json` describes replay and environment readiness. No simulated environment responses are part of the product flow. There is no Qwen-AgentWorld runtime or simulator config in the product flow, and traces must not emit `simulated_environment_response`.
-
-## Not Included
-
-Do not add commerce metadata, public ranking language, or Apprentice Agent self-eval as outcome truth. Do not include secrets, API keys, auth headers, cookies, private local paths, `.env`, `.env.local`, source scrape internals, or huge binaries in JSON.

package/docs/v0.2_release_notes.md

@@ -1,63 +0,0 @@
-# Agent Apprenticeship v0.2.1 Technical Release Notes
-
-Agent Apprenticeship v0.2.1 includes the v0.2 Experience Compilation system plus a small npm-package polish patch for the public README intro, first-run npm runtime setup, and installed Runtime Training metadata.
-
-## Core Product Changes
-
-- Full Experience Compilation packages now include traces, attempts, artifacts, actual outputs, loop review packets, evaluation/verifier/grader records, Runtime Training, training-time packages, eval packages, environment/replay packages, manifests, and source evidence maps where available.
-- Public Ecosystem mode defaults to automatic upload of the full Experience Compilation after completed tasks.
-- Private Internal Only mode records a no-upload path and does not upload completed tasks.
-- Ecosystem consumption is centered on two actions: Export Full Experience Compilation and Install Runtime Training.
-- Runtime Training install/use records installed skill refs, selected Runtime Training refs, confidence metadata, injected sections, and compact contract-focused context.
-- `apprentice bundle check` accepts local Experience Compilation folders that use task/package/compiler manifests, including regenerated seed task packages.
-- v0.2.1 adds a first-run npm runtime setup lock so concurrent CLI invocations share one Python runtime bootstrap safely.
-- v0.2.1 records `package_version` and `runtime_training_confidence` in installed Runtime Training metadata.
-
-## Experience Compiler And Training Packages
-
-- Experience Compiler outputs now include stronger package metadata, schema versions, compiler versions, package versions from `get_package_version()`, row counts, public/private mode, and provenance fields.
-- Generated package material is no longer treated as only prompt/completion data. The package supports SFT and LoRA-ready instruction rows, process supervision, reward model rows, verifier model rows, preference pairs, critique/revision pairs, failure cases, task variants, eval/rubric rows, environment/replay rows, and agentic rollout material.
-- Source evidence maps now include stable evidence IDs, evidence types, visibility, confidence, content hashes where available, row evidence links, and validation for broken refs.
-- Eval and environment packages now have first-class manifests and replay/scoring-oriented metadata.
-
-## Demo B Local Proof
-
-Demo B is a local ALE workflow-family mirrored transfer proof, not an official ALE benchmark score.
-
-- Completed workflow families: 7
-- Improved: 7
-- Same: 0
-- Worse: 0
-- Severe regressions: 0
-- Average baseline score: 0.3429
-- Average treatment score: 0.8929
-- Average delta: +0.5500
-- Median delta: +0.4500
-- Leakage check: passed
-
-The supported claim is that Agent Apprenticeship Runtime Training from source Experience Compilations improved related held-out mirrored workflow-family tasks in this local proof set.
-
-## Seed Dataset v0.2
-
-Seed Dataset v0.2 is an Experience Compilation dataset generated from seed tasks. It is not the specialized bioactive/wellness model-training dataset.
-
-- Full Experience Compilations: 505
-- Skill packs: 505
-- Runtime Training packages: 505
-- Training-time packages: 505
-- Eval packages: 505
-- Environment/replay packages: 505
-- Source evidence maps: 505
-- Source evidence rows: 6,483
-- Row evidence links: 15,004
-- Viewer/export configs: 15
-- Normalized Data Viewer rows: 39,835
-
-Use the wording “505 Experience Compilations plus 39,835 normalized Data Viewer rows.” Do not describe the normalized viewer rows as tasks.
-
-## Release Boundary
-
-- The package version is 0.2.1 for this npm patch release candidate.
-- The regenerated Seed Dataset v0.2 records the local package/compiler metadata used for its generation and later metadata restamp.
-- No model weights are included.
-- No official ALE benchmark score is claimed for the mirrored transfer tasks.

package/src/agent_apprenticeship_trace/io.py

@@ -1,20 +0,0 @@
-from __future__ import annotations
-import json, hashlib
-from pathlib import Path
-from pydantic import BaseModel
-
-def write_json(path: Path, obj):
-    path.parent.mkdir(parents=True, exist_ok=True)
-    data = obj.model_dump(mode='json') if isinstance(obj, BaseModel) else obj
-    path.write_text(json.dumps(data, indent=2, sort_keys=True)+"\n")
-
-def read_json(path: Path): return json.loads(path.read_text())
-def append_jsonl(path: Path, obj):
-    path.parent.mkdir(parents=True, exist_ok=True)
-    data = obj.model_dump(mode='json') if isinstance(obj, BaseModel) else obj
-    with path.open('a') as f: f.write(json.dumps(data, sort_keys=True)+"\n")
-def read_jsonl(path: Path):
-    if not path.exists(): return []
-    return [json.loads(l) for l in path.read_text().splitlines() if l.strip()]
-def sha256_file(path: Path):
-    h=hashlib.sha256(); h.update(path.read_bytes()); return h.hexdigest()