@fenglimg/fabric-cli 2.0.0 → 2.0.1

package/templates/skills/lib/shared-policy.md

@@ -0,0 +1,69 @@
+# Shared skill policy — cross-skill canonical core (rc.37 NEW-13)
+
+> **Single source of truth** for the policy invariants that fabric-archive,
+> fabric-review, and fabric-import all depend on. Each skill's `ref/` keeps
+> only its skill-specific examples and points here (`../../lib/shared-policy.md`)
+> for the common rules. Edit invariants HERE — never fork them per skill.
+
+## 1. Protected tokens — NEVER translated
+
+When rendering bilingual (zh-CN ↔ en) output, prose is translated but the
+following classes of token appear **verbatim in both variants**:
+
+- **MCP tool + field names**: `fab_extract_knowledge`, `fab_review`,
+  `fab_recall`, `fab_plan_context`, `fab_get_knowledge_sections`,
+  `relevance_scope`, `relevance_paths`, `source_sessions`, `proposed_reason`,
+  `session_context`, `intent_clues`, `tech_stack`, `impact`, `must_read_if`,
+  `evidence_paths`, `tags`, `pending_path`, `layer`.
+- **Enum / routing values**: `narrow`, `broad`, `team`, `personal`, `draft`,
+  `verified`, `proven`, `knowledge_scope_degraded`.
+- **Imperatives + paths**: `MUST`, `NEVER`, `.fabric/knowledge/`, file paths.
+
+The authoritative machine-checked list is `PROTECTED_TOKENS` in
+`@fenglimg/fabric-shared` (enforced by `scripts/lint-protected-tokens.ts`).
+Bilingualization scope is **prose ONLY**.
+
+## 2. AskUserQuestion routing-key invariant
+
+When any skill issues an `AskUserQuestion`:
+
+- `header` + `question` → user-facing prose → **translated** per
+  `.fabric/fabric-config.json` → `fabric_language`.
+- `options[]` entries → **routing keys** consumed by the skill's `switch`
+  over the returned choice → stay **English** in BOTH variants.
+
+Canonical option arrays (English in every locale):
+
+- Per-item review action: `["approve", "reject", "modify", "defer", "skip"]`
+- Stale-item action (review health mode): `["defer", "demote", "skip"]`
+- Layer-flip target: `["team", "personal"]`
+
+A skill that translates `options[]` MUST then dual-string-match
+(`choice === "approve" || choice === "通过"`); avoid this — keep options
+English so the state machine stays single-string.
+
+## 3. Layer heuristic (team vs personal)
+
+Default classification when archiving / proposing knowledge:
+
+- **强 team** — cross-cutting decisions, architecture, shared pitfalls,
+  conventions the whole repo depends on.
+- **强 personal** — individual workflow preferences, local environment quirks,
+  notes scoped to one contributor (`KP-*` ids, in-repo `~/.fabric` root).
+- **默认 team** — when ambiguous, default to `team` (shared visibility is the
+  safer default; a mis-scoped personal entry hides knowledge from the team).
+
+This block is itself a protected token sequence — render `强 team` /
+`强 personal` / `默认 team` verbatim.
+
+## 4. Events emit convention
+
+Skills persist lifecycle via MCP tools (which emit the canonical events) —
+they do NOT hand-write `.fabric/events.jsonl`:
+
+- `fab_extract_knowledge` → `knowledge_proposed` (+ archive-attempt events).
+- `fab_review` approve → `knowledge_promote_started` → `knowledge_promoted`.
+- `fab_review` modify-layer → `knowledge_layer_changed` (+ id-redirect).
+
+Never instruct the user to delete or hand-edit the event ledger; it is the
+append-only audit trail. Counter rollups live in `.fabric/metrics.jsonl`.

package/dist/chunk-6ICJICVU.js

@@ -1,10 +0,0 @@
-#!/usr/bin/env node
-
-// src/i18n.ts
-import { createTranslator, detectNodeLocale } from "@fenglimg/fabric-shared";
-var locale = detectNodeLocale();
-var t = createTranslator(locale);
-
-export {
-  t
-};