frontend-project-context 1.0.0 → 1.2.0

package/PROJECT_STATE.json

@@ -1,176 +0,0 @@
-{
-  "schemaVersion": 43,
-  "status": "1.0.0-public-npm-release-ready",
-  "product": {
-    "name": "Frontend Project Context",
-    "identity": "A project-local, model-neutral context governance and compilation layer between a repository and existing AI coding tools.",
-    "promise": "Maintain one human-approved project contract with provenance, compile scoped context for existing AI tools, and detect source, contract, and projection drift.",
-    "kernel": [
-      "source-registration-and-provenance",
-      "human-governed-project-contract",
-      "scope-aware-context-compiler",
-      "tool-projection-boundary",
-      "conflict-and-drift-checking"
-    ],
-    "discoveryRole": "Optional conservative bootstrap; never a requirement to understand every frontend technology or project convention."
-  },
-  "hardBoundaries": {
-    "humanAuthority": "Only an explicit human action may approve or change normative contract content.",
-    "runtime": "No model Provider or agent loop.",
-    "businessCode": "No user development task execution or application-code edits.",
-    "git": "No Git state management.",
-    "externalEffects": "No automatic dependency installation, network access, external mutation, or shell workflow execution.",
-    "generatedFiles": "Only explicitly managed and still-owned projections may be overwritten after an explicit write action.",
-    "conflicts": "Report stale sources and conflicts; never silently resolve or promote them.",
-    "taskContext": "Ephemeral task constraints cannot expand authority or rewrite the persistent Contract."
-  },
-  "implementation": {
-    "version": "1.0.0",
-    "license": "Apache-2.0",
-    "copyright": "Copyright 2026 Fushan",
-    "entrypoint": "bin/project-context.mjs",
-    "modules": "src/project-context/",
-    "tests": "test/project-context/",
-    "runtime": "node-standard-library-only",
-    "dependenciesAdded": 0,
-    "schemas": {
-      "contract": 2,
-      "contractReadable": [
-        1,
-        2
-      ],
-      "proposal": 1,
-      "sourceLock": 1,
-      "projectionLock": 1,
-      "projectionRenderer": 3,
-      "dashboardViewModel": 3
-    },
-    "closures": [
-      "v1-authoring",
-      "knowledge-maintenance",
-      "read-only-governance-dashboard",
-      "context-efficiency-and-governance-hardening",
-      "formal-release-readiness",
-      "source-lifecycle"
-    ],
-    "hardening": [
-      "symlink-safe-parent-creation",
-      "verification-kind-schema-semantics",
-      "proposal-create-only-same-id-revision-guard",
-      "strict-contract-value-json-compatibility",
-      "grouped-multipath-context-rendering",
-      "primary-locale-context-with-explicit-en-or-all",
-      "compact-approval-json-receipt",
-      "dashboard-derived-data-deduplication",
-      "deprecated-source-io-suppression",
-      "projection-lock-snapshot-precondition"
-    ],
-    "acceptance": {
-      "command": "npm run check",
-      "range": "A-01-through-A-45-plus-B0-01-B0-02-and-CLI",
-      "testCount": 49,
-      "status": "passed-source-lifecycle-closure-local",
-      "teamMaintenance": {
-        "date": "2026-09-08",
-        "fixture": "isolated-temporary-project",
-        "workflow": "source-change-review-accept-revise-deprecate-reapprove-republish-final-check",
-        "result": "passed"
-      },
-      "releaseReadiness": {
-        "date": "2026-09-08",
-        "package": "frontend-project-context@1.0.0",
-        "publicSurface": "project-context-cli",
-        "packagePrivate": false,
-        "registry": "https://registry.npmjs.org/",
-        "access": "public",
-        "license": "Apache-2.0",
-        "result": "public-release-configured-authenticated-ready"
-      }
-    },
-    "compatibility": "Contract schema 1 and 2 are readable. Existing schema-1 stores remain byte-stable until the first successful deprecate-source write lazily upgrades the Contract to schema 2; proposal and both locks remain schema 1. Renderer 1 and 2 projections remain readable and stale until explicit owned republish to renderer 3. Dashboard JSON consumers must opt into View Model schema 3; --full-json preserves the former verbose approval result on demand."
-  },
-  "planning": {
-    "releaseBlocker": {
-      "id": "source-lifecycle-closure",
-      "classification": "kernel-defect",
-      "targetPackageVersion": "1.0.0",
-      "status": "implemented-local-verified-release-hold-resolved",
-      "design": "docs/15-SOURCE-LIFECYCLE-CLOSURE-DESIGN.md",
-      "evidence": [
-        "accept-source-change rejects missing or unreadable registered sources",
-        "register rejects a changed locator under an existing source ID",
-        "contract schema 1 has no safe source retirement state",
-        "a missing, relocated, or retired source therefore requires direct store editing to return check to clean"
-      ],
-      "frozenScope": [
-        "contract-schema-2-active-and-deprecated-source-lifecycle",
-        "explicit-deprecate-source-command",
-        "schema-1-lazy-compatibility-migration",
-        "checker-dashboard-context-and-publish-lifecycle-consistency",
-        "A-40-through-A-45"
-      ],
-      "result": {
-        "date": "2026-09-08",
-        "tests": 49,
-        "contractSchemasReadable": [
-          1,
-          2
-        ],
-        "contractSchemaWrittenByLifecycle": 2,
-        "dashboardViewModel": 3,
-        "selfHostedContractSchema": 1,
-        "selfHostedMigrationReason": "No self-hosted source is obsolete; schema 1 remains valid until a real source retirement requires lazy migration."
-      }
-    },
-    "laterCandidates": [
-      {
-        "id": "ci-reconciliation-artifacts",
-        "classification": "optional-adapter",
-        "status": "candidate-after-release-decision",
-        "boundary": "Reuse check and dashboard in external CI; do not add a scheduler, daemon, automatic acceptance, or approval."
-      },
-      {
-        "id": "targeted-context-consumer-protocol",
-        "classification": "optional-adapter",
-        "status": "candidate-requires-separate-design-authorization",
-        "boundary": "Coding Agent or IDE resolves candidate paths and consumes context --path; no Provider, Agent Runtime, business-code execution, or automatic authority expansion."
-      }
-    ]
-  },
-  "executionAuthority": {
-    "providerCallsAllowed": false,
-    "dependencyInstallationAllowed": false,
-    "networkAllowed": true,
-    "productImplementationAllowed": false,
-    "realProjectBetaAllowed": false,
-    "teamAcceptanceAllowed": false,
-    "releaseWorkAllowed": true,
-    "gitWriteOperationsAllowed": true,
-    "note": "The user authorized completing the public release and npmjs.org CLI authentication is verified as fushanyx1. Public npm visibility, private:false, release verification, Git release commit/tag/push, and npm publication are in scope for this release workflow. Provider calls, dependency installation, real-project access, and product expansion remain unauthorized."
-  },
-  "sourceOfTruth": {
-    "constitution": "docs/00-PRODUCT-CONSTITUTION.md",
-    "startup": "RTK.md",
-    "overview": "README.md",
-    "documentationIndex": "docs/README.md",
-    "programDesign": "docs/04-PROGRAM-DESIGN.md",
-    "acceptanceContract": "docs/05-ACCEPTANCE-CONTRACT.md",
-    "v1AuthoringClosureDesign": "docs/11-V1-AUTHORING-CLOSURE-DESIGN.md",
-    "knowledgeMaintenanceClosureRoadmap": "docs/12-KNOWLEDGE-MAINTENANCE-CLOSURE-ROADMAP.md",
-    "readOnlyGovernanceDashboardDesign": "docs/13-READ-ONLY-GOVERNANCE-DASHBOARD-DESIGN.md",
-    "formalReleaseReadiness": "docs/14-FORMAL-RELEASE-READINESS.md",
-    "sourceLifecycleClosureDesign": "docs/15-SOURCE-LIFECYCLE-CLOSURE-DESIGN.md",
-    "license": "LICENSE",
-    "notice": "NOTICE",
-    "installationAndDistribution": "docs/08-INSTALLATION-AND-DISTRIBUTION.md",
-    "historicalEvidence": [
-      "docs/06-HISTORICAL-PROTOTYPE.md",
-      "docs/07-REAL-TASK-EVIDENCE.md",
-      "docs/09-B0-DTG-TMC-MOBILE.md",
-      "docs/10-B0-DTG-TMC-PC.md"
-    ]
-  },
-  "next": [
-    "publish-frontend-project-context-1.0.0-to-public-npm"
-  ]
-}

package/RTK.md

@@ -1,13 +0,0 @@
-# Frontend Project Context — 启动路由
-
-按顺序读取：
-
-1. `docs/00-PRODUCT-CONSTITUTION.md`：产品身份、内核、永久边界与治理规则；
-2. `PROJECT_STATE.json`：当前版本、实现、授权和唯一下一步；
-3. 仅在任务需要时读取 `PROJECT_STATE.json.sourceOfTruth` 指向的设计或证据。
-
-当前摘要：`1.0.0-public-npm-release-ready`。v1 已冻结为 `frontend-project-context@1.0.0`，采用 Apache-2.0 与 `Copyright 2026 Fushan`；Source Lifecycle Closure 和全部 49 项本地验收通过。Contract reader 支持 schema 1/2，schema 1 只在首次成功 `deprecate-source --write` 时延迟升级为 2；proposal 与两个 lock 保持 1，projection renderer 为 3，Dashboard View Model 为 3。
-
-根 `AGENTS.md` 由人工维护；`.project-context/` 是本仓库自托管真源；投影只是可重新生成的消费端文件。任何历史文档与宪法冲突时以宪法为准，任何动态状态与 `PROJECT_STATE.json` 冲突时以后者为准。
-
-用户已授权完成公开发布；package 已固定 `private: false`、public access 和官方 npm registry，npmjs.org CLI 身份已验证。当前唯一下一步是完成最终 pack、release commit、`v1.0.0` tag/push 与 `npm publish`。Provider、依赖安装、真实业务项目访问和产品扩张仍未授权。