Commit Graph

11 Commits

Author SHA1 Message Date
liuyu 9caa2caa3a feat(drawing): integrate PDF reconstruction and evidence validation
Add the drawing inspection namespace and its parser, calibration, section and
independent acceptance dependencies on the current dev architecture.

Protect input BREP during material fusion and sectioning. Bind dimensions,
annotations and visual reviews to source identities and measured geometry.
Connect the workflow and generated API docs to all seven skill build targets.
Make standalone verifier tests work with the pytest console entry point.

Validation: 186 drawing, documentation, skill-target and public API tests;
16 non-render BREP query tests; compileall and skillbuild --check.
2026-09-11 13:36:27 +08:00
NiJingzhe fc28a6298b docs(addon): scadpkg consumer format spec + reading guide; drop dead v2 package schema 2026-09-10 14:36:10 +08:00
NiJingzhe 5cac586dfc feat(addon): sca addon manager — descriptor gates, platform enum, skill install, authoring doc 2026-09-10 03:05:09 +08:00
NiJingzhe 7a8404f03e feat(skill): harness-specific host bindings for 7 compile targets
- skillproj.toml: targets omp,opencode + zcode,claudecode,codex,dsh,kimicode
- single-part-modeling: 5 host-binding pairs -> 10 (ask tool, TODO tool,
  REPL/script hypothesis loop, plan state machine, isolated image review)
- zcode+claudecode share one block per binding (AskUserQuestion/TodoWrite/
  Agent-Task); codex = plain-text batched questions + update_plan + user as
  fallback reviewer; dsh/kimicode = conservative fallback pending native
  tool mapping
- references README generalizes the omp-only wording
2026-09-07 02:29:24 +08:00
NiJingzhe 09241caeff docs(skill): add QL selection playbook from verified harnesses
33/33 checks across four verification harnesses (extrude family,
primitives, sweep/loft, D-boss boolean seam + seam fillet) on dev
@ 7dcf2ef. Documents the naming-channel reach matrix (op-kwarg names
survive booleans; edge-source names survive modifiers; plain user face
tags project through nothing), the boolean seam recipe
(origin_role body/tool + incident_to distinct), and the current engine
boundaries. Boundary #5 records the plane-axes fix on this branch.
2026-09-03 17:57:55 +08:00
NiJingzhe 48b23fbe7e docs(skill): consolidate workflows to four goal routes
The FTC convention dissolved the sketch-feature-modeling discriminator
(planar profiles are sketch tier inside every part source), and
standard-part usage belongs to the assembly route. Workflow set: 6 -> 4.

- sketch-feature-modeling merged into single-part-modeling: new standing
  discipline 'Sketch tier is the default part form' carries the sketch
  gates (solve status + remaining DOF before promotion, promotion
  preserves measured geometry, stable entity ids, intentional free DOF
  recorded); capability detail stays in domains/sketch-and-features.md
- single-part-modeling gains the hard rule: if the requirement can be
  satisfied by a standard part or based on one, scad.std.* MUST be the
  basis; single std part stays here via domains/standard-parts.md,
  mechanisms mating several route to assembly
- standard-part-assembly merged into assembly-product-build: scope now
  includes stdlib mechanisms; new step 3 selects std components first
  and computes the kinematics explicitly (center distance from tooth
  counts and module, backlash, ratios, measured bearing/gear seats);
  mesh-consistency gates added; steps renumbered 1-10
- routing table and references/README workflow table reduced to four
  goal rows; step-reconstruction's citation of the removed workflow
  replaced with the sketch/geometry tier pointer; mirrors rebuilt
2026-09-01 02:21:24 +08:00
NiJingzhe aba251f604 Revert "fix(skill): keep live tree harness-neutral"
This reverts commit 062eea6da0.
2026-08-26 02:26:09 +08:00
NiJingzhe 062eea6da0 fix(skill): keep live tree harness-neutral 2026-08-26 02:12:00 +08:00
NiJingzhe 0bd286a865 docs(skill): clarify part requirement workflow 2026-08-26 01:47:40 +08:00
Ni Jingzhe 075f88e342 feat(skill): routing SOP from load-order discipline + audit-driven fixes (#19)
Rewrite SKILL.md in the routed-authority register (mandatory numbered
load order, hard rules, routing-discipline table): deterministic route
selection, forbidden route-choice menus, one pre-scripted discriminator
question for ambiguous requests, authority precedence, and an
execution-discipline section that binds every gate to a named artifact.

Apply S1-S8 from design-docs/skill-solution.md plus five deeper
patterns from session-audit-01a02469 evidence:

- S1 Ask-or-Record gate + mounting/load brief fields; S6 companion line
- S2 selection-evidence gate before fillet/chamfer (card + cardinality
  assertion + highlight render), anti-patterns named
- S3 edge-selection defaults: shared_boundary first, index getters only
  for intentional picks; wired into the workflow step
- S4 check-definition protocol (posture vs path, verification vs design
  geometry, feedback-to-predicate)
- S5 fastener envelopes precede geometry as brief inputs
- S6 visual acceptance minimum replaces 'Visual plausibility'
- S7 reading-an-API-page contract + external-dependency boundary
- S8 a run analysis ends in a verdict

Deeper audit patterns folded in: acceptance set before geometry,
own-the-methods/ask-the-requirements split, assumptions as brief fields
with derivation tracking, enumeration-is-not-repair, and
discriminating-evidence selection.
2026-08-23 01:38:45 +08:00
Ni Jingzhe c454a3af10 feat(skill): per-harness skillbuild toolchain replaces skill-pack (#18)
* feat(skill): replace skill-pack with per-harness conditional compiler

skillbuild compiles the skill tree into per-target harness builds:
- <!-- skill:if omp,!claude --> blocks include text only for matching
  targets; name-list conditions only, no else/nesting, fail-loud on
  unknown targets and unpaired/nested directives
- fence-aware: directive-looking lines inside code fences are literal
- layout is the filesystem; tree root configured in skillproj.toml
- post-build assertion: zero directive residue, SKILL.md frontmatter
  name check

Migration to the new model:
- docs/skill/ becomes the self-contained source root (SKILL.md,
  references/, generated api/stdlib/core/guides now under
  references/docs/; SDK_OVERVIEW/LICENSE/inspect are ordinary tree
  files)
- auto_docs_gen output redirected into the tree (docs/api ->
  docs/skill/references/docs/api, likewise stdlib)
- skills/simplecadapi/ is now the compiled omp target output;
  dist/generic/simplecadapi the generic target
- dropped skill-pack entry point (plus dangling evolve/make-export
  entries and their orphaned test), release workflow builds via
  skillbuild + tar; README updated

First real conditional block: harness reading paths in SKILL.md
(skill:// mount on omp vs disk-relative on generic).

Verified: 59 tests pass (skillbuild 31, auto_docs_gen 19, persistence
regression 9); both targets build; outputs residue-clean; full suite
collects (1376 tests).

* refactor(tools): auto_docs_gen moves out of the installed package

tools/ scripts are repo-checkout dev scripts, not packaged CLIs:
- auto_docs_gen.py now lives in tools/ beside the other generators;
  auto_tools/ package removed entirely
- path resolution simplifies: repo root = parent of tools/, fail-loud
  if pyproject.toml missing; site-packages/cwd fallback branches were
  dead code once the script stopped shipping in the wheel
- auto-docs-gen console script dropped from [project.scripts];
  release.yml and README invoke python tools/auto_docs_gen.py
- MANIFEST.in stale src/auto_tools include removed; CadQuery-free
  runtime scan no longer needs the auto_tools filter
- run_examples.py retired (user removal): README example-runner text
  updated to direct examples/ scripts; dangling runner-contract test
  (runpy.run_path into the deleted script) removed

Verified: 53 tests pass (auto_docs_gen + skill_build + ocp runtime
scan) and test_example_model_contract passes; regeneration from
tools/ is byte-identical (zero docs drift).

* refactor(skill): strip harness and build-tool content from the skill tree

The skill is plain harness-neutral content again:
- SKILL.md 'Reading skill files' section removed (the omp skill://
  mount block and its !omp complement were the only conditional
  blocks; the tree compiles identically for every target now)
- references/README.md: build-tool meta removed ('per-harness
  conditional compilation', skillbuild packaging/validation claims —
  link validation was never implemented, so the claim was false)
- live test now asserts the tree stays harness-neutral (zero blocks)
- skillproj.toml targets aligned with the user's output table
  (omp -> skills/simplecadapi-omp, opencode -> skills/simplecadapi-opencode;
  leftover 'generic' entry had no output and failed the build)
- compiled outputs are regenerable artifacts: skills/simplecadapi/
  untracked from git, skills/simplecadapi-*/ gitignored, release.yml
  and README build via skillbuild and tar the omp output directly
  (bsdtar has no --transform; inner dir keeps its suffixed name)

Verified: 49 tests pass; both targets build 372 files with zero
conditional blocks; no omp/conditional/directive residue in the tree
or outputs.

* chore(docs): drop stale architecture review and design notes
2026-08-22 20:20:49 +08:00