pi-career 0.1.0

package/runtime/linux-x64-gnu/provenance.json

@@ -0,0 +1,101 @@
+{
+  "build": {
+    "cargo_version": "cargo 1.97.1 (c980f4866 2026-06-30)",
+    "command": [
+      "cargo",
+      "build",
+      "--release",
+      "--locked",
+      "-p",
+      "career-cli",
+      "--target",
+      "x86_64-unknown-linux-gnu"
+    ],
+    "host_arch": "x86_64",
+    "host_os": "linux",
+    "locked": true,
+    "os_release": "Linux 6.17.0-1020-azure",
+    "platform_key": "linux-x64-gnu",
+    "profile": "release",
+    "rustc_version": "rustc 1.97.1 (8bab26f4f 2026-07-14)",
+    "target_triple": "x86_64-unknown-linux-gnu"
+  },
+  "contract_digests": {
+    "capabilities": {
+      "schema_version": "career.capabilities.v1",
+      "sha256": "c45443be0ba7cfbcd4e20b28d8d100f33542e77b0b983ebf3110dddfdd71d3f3",
+      "size_bytes": 1855
+    },
+    "schema_catalog": {
+      "schema_count": 25,
+      "schema_version": "career.schema_catalog.v1",
+      "sha256": "398b093a1a6245e05a1a93eafd2162c0fe5afcb4b3ff3c7856730ac64628c5e0",
+      "size_bytes": 3795
+    },
+    "schema_export": {
+      "schema_id": "career.job_match.v1",
+      "sha256": "286cf0297b3f1b224f7ec7db4b06605423dbff844a38fe79d0c53fd4dea5bfde",
+      "size_bytes": 11526
+    }
+  },
+  "executable": {
+    "file_name": "career",
+    "sha256": "0d8a392fe2127b1b447f10035a00ad7b521806c2d81f140bdcae1cc99d7cb25b",
+    "size_bytes": 5516544,
+    "version_output": "career 0.1.0"
+  },
+  "licenses_and_notices": [
+    {
+      "file_name": "LICENSE-MIT",
+      "sha256": "10c3e4d0fc59a6a502c18039ae76f3ff473e3f17c3428f7e417582665e65e8e9",
+      "size_bytes": 1075
+    },
+    {
+      "file_name": "LICENSE-APACHE",
+      "sha256": "2f2746efca80d5c78999cf97ee127ec9e3b0e86346004f71de39a7f8f8b9b1e8",
+      "size_bytes": 11348
+    },
+    {
+      "file_name": "THIRD_PARTY_NOTICES.md",
+      "sha256": "50c74854ed27f9347ea2f647a42a18c3c5579fd32f19a416941eab50fca59ca1",
+      "size_bytes": 1141
+    }
+  ],
+  "native_verification": [
+    {
+      "golden_fixture": "fixtures/resume/phase3/complete-analysis.expected.json",
+      "input_fixture": "fixtures/resume/phase3/complete-analysis.input.json",
+      "operation": "resume.analyze",
+      "output_schema_version": "career.resume_analysis.v1",
+      "output_sha256": "01eb6332172ea2e747be7b409fe31f646882079a36d327eb66bf3f3a92bb4acc",
+      "output_size_bytes": 12416
+    },
+    {
+      "golden_fixture": "fixtures/job/phase4b/complete-match.expected.json",
+      "input_fixture": "fixtures/job/phase4b/complete-match.input.json",
+      "operation": "job.match",
+      "output_schema_version": "career.job_match.v1",
+      "output_sha256": "872727a02f690b8269533c845e701086a90523a8579ccd0bee3abc8561764e96",
+      "output_size_bytes": 17598
+    }
+  ],
+  "package": {
+    "archive_file": "career-pi-runtime-linux-x64-gnu-x86_64-unknown-linux-gnu-a3cdb4c6d7f966397e93ea4664071975bca7228c.tar.gz",
+    "contents": [
+      "career",
+      "metadata.json",
+      "LICENSE-MIT",
+      "LICENSE-APACHE",
+      "THIRD_PARTY_NOTICES.md"
+    ],
+    "unsigned": true
+  },
+  "publication_status": "not_a_public_release",
+  "purpose": "maintainer_input_for_external_pi_career",
+  "schema_version": "career.pi_career_runtime_artifact.v1",
+  "source": {
+    "git_dirty": false,
+    "git_sha": "a3cdb4c6d7f966397e93ea4664071975bca7228c",
+    "repository": "https://github.com/revazi/career-core"
+  }
+}

package/runtime/manifest.json

@@ -0,0 +1,109 @@
+{
+  "schema_version": "pi.career.runtime_manifest.v1",
+  "career_core": {
+    "repository": "https://github.com/revazi/career-core",
+    "commit": "a3cdb4c6d7f966397e93ea4664071975bca7228c",
+    "version": "0.1.0",
+    "artifact_run": {
+      "id": 30953471793,
+      "url": "https://github.com/revazi/career-core/actions/runs/30953471793",
+      "workflow": "Prepare pi-career runtime artifacts"
+    }
+  },
+  "distribution": {
+    "public_repository": true,
+    "unsigned": true,
+    "publication_status": "not_a_public_release"
+  },
+  "contracts": {
+    "capabilities": {
+      "schema_version": "career.capabilities.v1",
+      "sha256": "c45443be0ba7cfbcd4e20b28d8d100f33542e77b0b983ebf3110dddfdd71d3f3",
+      "size_bytes": 1855
+    },
+    "schema_catalog": {
+      "schema_version": "career.schema_catalog.v1",
+      "schema_count": 25,
+      "sha256": "398b093a1a6245e05a1a93eafd2162c0fe5afcb4b3ff3c7856730ac64628c5e0",
+      "size_bytes": 3795
+    },
+    "schema_export": {
+      "schema_id": "career.job_match.v1",
+      "sha256": "286cf0297b3f1b224f7ec7db4b06605423dbff844a38fe79d0c53fd4dea5bfde",
+      "size_bytes": 11526
+    },
+    "representative_operations": {
+      "resume.analyze": {
+        "schema_version": "career.resume_analysis.v1",
+        "sha256": "01eb6332172ea2e747be7b409fe31f646882079a36d327eb66bf3f3a92bb4acc",
+        "size_bytes": 12416
+      },
+      "job.match": {
+        "schema_version": "career.job_match.v1",
+        "sha256": "872727a02f690b8269533c845e701086a90523a8579ccd0bee3abc8561764e96",
+        "size_bytes": 17598
+      }
+    }
+  },
+  "licenses_and_notices": [
+    {
+      "path": "runtime/LICENSE-MIT",
+      "sha256": "10c3e4d0fc59a6a502c18039ae76f3ff473e3f17c3428f7e417582665e65e8e9",
+      "size_bytes": 1075
+    },
+    {
+      "path": "runtime/LICENSE-APACHE",
+      "sha256": "2f2746efca80d5c78999cf97ee127ec9e3b0e86346004f71de39a7f8f8b9b1e8",
+      "size_bytes": 11348
+    },
+    {
+      "path": "runtime/THIRD_PARTY_NOTICES.md",
+      "sha256": "50c74854ed27f9347ea2f647a42a18c3c5579fd32f19a416941eab50fca59ca1",
+      "size_bytes": 1141
+    }
+  ],
+  "targets": {
+    "darwin-arm64": {
+      "platform": "darwin",
+      "arch": "arm64",
+      "libc": null,
+      "target_triple": "aarch64-apple-darwin",
+      "path": "runtime/darwin-arm64/career",
+      "provenance_path": "runtime/darwin-arm64/provenance.json",
+      "provenance_sha256": "0e5cd03385dd11283551b3d198d071aebbef4ab99b7c278a60fba2ab8269e0c6",
+      "provenance_size_bytes": 3275,
+      "sha256": "9e46972c1d4b2a1ca695595c0953c4198bfb12af2ba39f040e955b5b11952790",
+      "size_bytes": 4522688,
+      "mode": "0755",
+      "version_output": "career 0.1.0",
+      "source_artifact": {
+        "id": 8910079991,
+        "name": "career-pi-runtime-darwin-arm64-aarch64-apple-darwin-a3cdb4c6d7f966397e93ea4664071975bca7228c",
+        "archive_file": "career-pi-runtime-darwin-arm64-aarch64-apple-darwin-a3cdb4c6d7f966397e93ea4664071975bca7228c.tar.gz",
+        "archive_sha256": "3847ca2b06e8b41d86b6a4e3d4ce1f0a0cfd2322bf7f9a19330abb3f58b9ef2c",
+        "download_size_bytes": 1486583
+      }
+    },
+    "linux-x64-gnu": {
+      "platform": "linux",
+      "arch": "x64",
+      "libc": "gnu",
+      "target_triple": "x86_64-unknown-linux-gnu",
+      "path": "runtime/linux-x64-gnu/career",
+      "provenance_path": "runtime/linux-x64-gnu/provenance.json",
+      "provenance_sha256": "98ee468bb78d3ade4f398ec11615a4ae7469c850817655c63cfea94a7b79cc0f",
+      "provenance_size_bytes": 3300,
+      "sha256": "0d8a392fe2127b1b447f10035a00ad7b521806c2d81f140bdcae1cc99d7cb25b",
+      "size_bytes": 5516544,
+      "mode": "0755",
+      "version_output": "career 0.1.0",
+      "source_artifact": {
+        "id": 8910084163,
+        "name": "career-pi-runtime-linux-x64-gnu-x86_64-unknown-linux-gnu-a3cdb4c6d7f966397e93ea4664071975bca7228c",
+        "archive_file": "career-pi-runtime-linux-x64-gnu-x86_64-unknown-linux-gnu-a3cdb4c6d7f966397e93ea4664071975bca7228c.tar.gz",
+        "archive_sha256": "966f2b0693f815926eb53ee36933f5f1e8b6ea599ca7f33b308b82fc6cb88eed",
+        "download_size_bytes": 1679647
+      }
+    }
+  }
+}

package/skills/career-core/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: career-core
+description: Discovers and invokes the package-owned deterministic Career Core runtime for source-grounded resume evaluation/normalization/readiness analysis, reviewed external suggestions and replacements, assisted-variant review/materialization, job normalization, and conservative matching. Use for supported career-document analysis or local integration work.
+license: MIT OR Apache-2.0
+compatibility: Requires Pi with pi-career on supported darwin-arm64 or linux-x64-gnu; CAREER_CLI_PATH is an optional bounded developer/recovery override.
+metadata:
+  author: revazi
+  version: "0.1.0"
+---
+
+# Career Core through pi-career
+
+Use the package-owned Career Core runtime through the three native tools. Career Core is authoritative; the extension only transports bounded argv/stdin JSON. Never recreate scoring, schemas, errors, evidence rules, uncertainty, or repair behavior in prompts or TypeScript.
+
+## Privacy decision before document use
+
+Pi may persist tool arguments and results in session JSONL even though Career Core and this extension do not persist career documents. Before putting private resume or job content in `career_core_resume` or `career_core_job`, require the user to make an explicit Pi session-persistence decision. Recommend starting a new transient run:
+
+```bash
+pi --no-session
+```
+
+Do not claim secure erasure or removal of previous sessions, backups, shell history, provider copies, or separately saved results. If the user does not approve private content in Pi context, do not call a document tool. Local-session approval is not approval to send content to an external model/provider.
+
+## Discover first
+
+1. Call `career_core_discover` with `operation: "capabilities"`.
+2. Invoke only capabilities whose status is `available`; never treat planned entries as callable.
+3. Call `career_core_discover` with `operation: "schema-list"`.
+4. Export the exact input schema needed with `operation: "schema-export"` and its returned schema ID.
+5. Construct exactly one versioned input object matching that schema, serialize it as the `input_json` string, and call the relevant document tool.
+
+Do not infer input shapes from this prose. The bundled runtime embeds the reviewed Draft 2020-12 schemas and discovery performs no network request.
+
+## Deterministic slash commands
+
+On supported targets, users can run `/career-setup`, `/career-library`, `/career-vacancy`, `/career-match`, and `/career-analyze` without involving a provider/model. These commands invoke the same package-owned runtime directly rather than calling the native tools through the LLM. They scan only configured Markdown/text roots, keep assisted variants and inputs over 50,000 Unicode scalar values out of authoritative analysis/matching, require persisted-session consent before private custom entries, and never store full Core JSON.
+
+Use the native tool flow below for operations not exposed by those commands or when the user explicitly requests direct schema-level work.
+
+## Native tool surface
+
+- `career_core_discover`
+  - `capabilities`
+  - `schema-list`
+  - `schema-export` (requires exact `schema_id` from the list)
+- `career_core_resume`
+  - `evaluate`
+  - `analyze`
+  - `analysis-suggestions-review`
+  - `analysis-replacements-review`
+  - `normalize`
+  - `enrich`
+  - `variant-review`
+  - `variant-materialize`
+- `career_core_job`
+  - `normalize`
+  - `match`
+
+The document tools send `input_json` only to package-owned runtime stdin with `--input - --format json-compact`. They never search PATH, invoke Cargo, fetch URLs, call a provider/model, or write payload/result files. Successful tool text is the complete runtime JSON without semantic transformation.
+
+## Failure handling
+
+A `career.pi_error.v1` value is adapter/process status, not a deterministic career result.
+
+- `unsupported_platform` means no reviewed bundled runtime exists for this platform/libc; do not guess, download, or fall back to PATH/Cargo.
+- `bundled_runtime_invalid` means local integrity verification failed; do not request paths, hashes, environment values, or raw filesystem errors.
+- On `career_cli_error`, inspect only the nested, validated, bounded `career.error.v1`.
+- Correct typed invalid input before trying again; do not repair by guesswork or retry unchanged validation failures.
+- On `result_too_large` or `result_too_many_lines`, do not request or use partial output. Full-result export is not yet available through pi-career.
+- Do not ask for raw stderr, paths, environment values, source copies, or hidden process errors.
+
+## Resume operation rules
+
+### `evaluate`
+
+This is recognized core-section header coverage only. Preserve `limited_evaluation_scope` and parser uncertainty. Never present it as complete resume quality, proprietary ATS compatibility, visual-layout inspection, or a hiring prediction. Use `analyze` for full deterministic readiness analysis.
+
+### `analyze`
+
+Read `raw_score`, confidence-adjusted `score`, checks, evidence, `basis_check_id`, actions, warnings, and limitations together. Treat `inconclusive` checks and `provisional` findings as unverified. It independently scores only deterministic normalization of the original input; assisted documents cannot enter.
+
+### `normalize`
+
+Preserve source-grounded fields, source spans, confidence, statuses, warnings, and `enrichment_request`. `not_detected` is not confirmed absence.
+
+### `enrich`
+
+This validates an explicit, already supplied source-grounded external proposal; it does not generate one or call a provider. Use only when the deterministic request is eligible and the proposal exactly matches the exported schema. Values must come from source text and target only eligible empty fields. Preserve the unchanged authoritative `baseline`; keep `assisted_document` separate and never feed it into authoritative analysis or matching.
+
+### `analysis-suggestions-review`
+
+This reruns and preserves the deterministic `baseline_analysis` while reviewing at most the schema-bounded source-targeted suggestions. Retained suggestions are assisted/non-authoritative and bound to current failed canonical actions. Exact occurrence does not prove factual entailment or rewrite safety. The v1 `suggestion` is advisory text, not a replacement. Do not create selection, mutation, export, or materialization semantics.
+
+### `analysis-replacements-review`
+
+This reruns and preserves `baseline_analysis` and returns canonical exact before/proposed-after values for non-authoritative diff display. Preserve action/status, evidence, discard codes, and warnings. Exact occurrence does not certify factuality or rewrite safety. It creates no candidate, selection, application, export, persistence, source mutation, or materialization path.
+
+### `variant-review`
+
+Review only the bounded external proposal supplied by the caller. Use Core-assigned canonical retained-change IDs and discard codes. Exact evidence occurrence is structural grounding, not factual certification. Do not repair discarded changes or select changes for the user.
+
+### `variant-materialize`
+
+Call only after the user explicitly selects canonical IDs. Core revalidates the complete proposal and applies only selected changes. Preserve the exact baseline and assisted/non-authoritative labels. Never overwrite the original automatically or pass the assisted result to `analyze` or `job match`.
+
+## Job operation rules
+
+### `normalize`
+
+Provide caller-supplied plain text only; never fetch a vacancy URL. Preserve required/preferred classifications, source spans, confidence, statuses, metadata, unclassified lines, and warnings. Lexical classification is not semantic certainty, and `not_detected` remains unverified.
+
+### `match`
+
+Use original resume and original job inputs matching the exported schema. Matching independently reruns both deterministic baselines and cannot consume assisted documents.
+
+- Distinguish category `raw_score` from confidence-bounded `score`.
+- Keep `confirmed_match`, `partial_match`, `likely_missing`, and `unverified` distinct.
+- Cite resume/job spans when present and preserve null spans for derived signals.
+- Accept only `normalized_exact` and returned `conservative_alias` skill equivalence.
+- Never substitute adjacent technologies or repair a conservative false negative.
+- Preserve top strengths/gaps, confidence bounds, warnings, and provisional recommendation status.
+- Treat `apply_now`, `apply_after_small_edits`, and `improve_first` as bounded workflow guidance, never a hiring prediction.
+- Review `unassessed_required_qualifications`; do not infer support or absence.
+
+## Output discipline
+
+- Treat returned JSON as authoritative and complete.
+- Preserve every warning, evidence item, source span, basis ID, confidence value, uncertainty status, baseline boundary, discard code, limitation, and assisted/non-authoritative label.
+- Do not reorder, truncate, silently repair, upgrade uncertainty into fact, or claim Core generated prose it only reviewed.
+- Do not modify source documents unless the user separately requests and approves that change.
+- Never place API keys in tool input, output, files, or logs.
+
+See [`references/cli-contract.md`](references/cli-contract.md) for bundled-runtime selection and process details. Package installation and removal are in [`../../README.md`](../../README.md).

package/skills/career-core/references/cli-contract.md

@@ -0,0 +1,45 @@
+# Bundled runtime contract reference
+
+Use this reference only after reading the parent skill. Export exact schemas through `career_core_discover`; this file intentionally does not copy the authoritative schema catalog.
+
+## Runtime selection
+
+Normal operations use the reviewed package-owned runtime for exactly:
+
+- `darwin-arm64`
+- `linux-x64-gnu` with positive glibc detection
+
+Selection order is a bounded absolute `CAREER_CLI_PATH` developer/recovery override first, then the verified bundled target. There is no PATH, sibling-checkout, Cargo, install-script, or download fallback. Windows, macOS x64, Linux arm64/musl, and unknown targets fail closed with `unsupported_platform`.
+
+Before first bundled execution per process, pi-career verifies the regular file's exact mode, size, and SHA-256 against its committed runtime manifest. A mismatch fails as `bundled_runtime_invalid`. These errors are payload-free and must not be expanded with platform details, paths, hashes, environment values, or raw failures.
+
+## Discovery and operations
+
+Use only the three native tools:
+
+- `career_core_discover`: `capabilities`, `schema-list`, `schema-export`
+- `career_core_resume`: `evaluate`, `analyze`, `analysis-suggestions-review`, `analysis-replacements-review`, `normalize`, `enrich`, `variant-review`, `variant-materialize`
+- `career_core_job`: `normalize`, `match`
+
+Invoke only capabilities whose status is `available`. Pass one exact versioned JSON object in `input_json`; the adapter writes it only to runtime stdin. Do not concatenate document text into commands, place source content in argv, or infer schemas from prose.
+
+## Machine framing
+
+- The adapter uses `--format json-compact`; successful runtime output is one JSON document with one framing newline.
+- Known diagnostics are one bounded `career.error.v1` on stderr with a nonzero status.
+- The runtime makes no implicit network request and does not modify input.
+- Single-document input is bounded at 262,144 UTF-8 bytes; composite job-match and variant envelopes are bounded at 1,048,576 bytes.
+
+## Pi adapter framing
+
+The native tools use direct `spawn(executable, argv, { shell: false })`, stdin-only document JSON, fixed operation mappings, timeout/cancellation cleanup, separate stdout/stderr capture bounds, fatal UTF-8 decoding, and exact-one-object success.
+
+Successful JSON is returned complete, with only the single framing newline removed. The process adapter writes no payload/result files and has no model/provider/network behavior. The separate deterministic slash-command layer calls this process helper directly and owns only its bounded config, scan, UI, and custom-session-entry behavior.
+
+Known adapter failures use `career.pi_error.v1`. Only `career_cli_error` may include a nested strictly validated allowlisted `career.error.v1`. Other errors do not expose raw diagnostics, input/output, executable paths, hashes, platform details, environment values, or Node/filesystem errors.
+
+If a complete result exceeds 50,000 bytes or 2,000 lines, the tool fails as `result_too_large` or `result_too_many_lines`. Do not request or use partial output. Full-result export is not yet available through pi-career.
+
+## Privacy
+
+Pi may persist native tool arguments/results in session JSONL. Require an explicit decision before private use and recommend a new `pi --no-session` run when session persistence is not wanted. This is not secure erasure and is separate from consent for any external provider.