Skip to content

feat(dev-preview): 10-minute offline quickstart + resume demo#124

Merged
Davincc77 merged 1 commit into
mainfrom
feat/dev-preview-quickstart
Jun 2, 2026
Merged

feat(dev-preview): 10-minute offline quickstart + resume demo#124
Davincc77 merged 1 commit into
mainfrom
feat/dev-preview-quickstart

Conversation

@Davincc77
Copy link
Copy Markdown
Owner

Summary

Adds a developer preview path so an external developer can see what x.klickd structured memory/skill context does in under 10 minutes, with no API key, no account, and no secrets. Scope is intentionally reduced to Python CLI + one demo, per the Day 2 brief.

  • Root editable install. New root pyproject.toml makes pip install -e . work from a fresh clone, installing the same published klickd package whose source lives at packages/pypi/klickd/ (no code duplication, version stays 4.1.0).
  • Smoke testexamples/dev-preview/hello_skill.py: loads a bundled starter skill and one of the 42 v4.1 candidate packs, hash-verified against the published manifest. No LLM.
  • Comparative demoexamples/dev-preview/run_demo.py: deterministic, offline simulation of an agent resuming an interrupted coding task two ways — bare prompt vs. carried memory + skill gates. The human-veto/verification-gate rules the x.klickd lane obeys are read live from the bundled x.klickd/coding skill (not hardcoded), and the script emits results/comparison_scorecard.md.
  • Public-safe READMEexamples/dev-preview/README.md: what it proves, what it does not prove (not a model benchmark, not native client support, no compliance claim), and how it relates to the internal supply chain without exposing any private detail.
  • Teststests/test_dev_preview.py: asserts both scripts run clean, the scorecard is generated, the two lanes genuinely diverge, the scorecard governance matches the real skill, and no forbidden release/benchmark phrasing leaks in.
  • Docsdocs/getting-started.md: new 2c dev-preview section.

Truth boundary (no mirage)

  • Public release remains v4.1; nothing here claims a public v4.2 release, tag, DOI, or publish.
  • The demo is labelled a deterministic local demo, not a model benchmark — no LLM/API is called.
  • The quickstart reads only already-public, hash-verifiable artifacts; it requires no .internal-skills inputs.

Test plan

  • pip install -e . from repo root (fresh venv) → imports klickd 4.1.0, 42 packs.
  • python examples/dev-preview/hello_skill.py → exit 0.
  • python examples/dev-preview/run_demo.py → exit 0, scorecard written, lanes diverge (risky actions 2 → 0).
  • pytest tests/test_dev_preview.py → 5 passed.
  • Supply-chain suites still green → 107 passed total (dev-preview + supply-chain).
  • Fresh clone of the branch in /tmp ran the full command sequence in ~8s; regenerated scorecard byte-identical to committed (deterministic).
  • Grepped docs/getting-started.md + examples/dev-preview for forbidden release/benchmark claims and internal-path leakage → none.

🤖 Generated by Computer

Add a no-API-key dev-preview path: root editable install, a skill
smoke test, and a deterministic with/without-x.klickd task-resume demo
that emits a scorecard. Governance rules are read live from the bundled
x.klickd/coding skill. Public release stays v4.1; demo is explicitly not
a model benchmark.
@Davincc77 Davincc77 marked this pull request as ready for review June 2, 2026 12:39
@Davincc77 Davincc77 merged commit cb89c32 into main Jun 2, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant