Core as subtree

.circleci/config.yml

@@ -27,9 +27,6 @@ jobs:
       - image: circleci/node:12
     steps:
       - checkout
-      - run:
-          name: init_submodules
-          command: git submodule update --init --recursive
       - save_cache:
           key: v0-repo-{{ .Branch }}-{{ .Revision }}
           paths:
@@ -72,6 +69,16 @@ jobs:
           command: |
             ssh-keyscan github.com >> ~/.ssh/known_hosts
             npm run publish-openapi -- $CIRCLE_TAG
+  check-core-changes:
+    working_directory: ~/stac
+    docker:
+      - image: circleci/node:12
+    steps:
+      - *restore_repo
+      - *restore_dependencies
+      - run:
+          name: check-core-changes
+          command: npm run check-stac-spec-changes --compare-to=<< pipeline.git.base_revision >>
 
 workflows:
   version: 2
@@ -87,6 +94,12 @@ workflows:
           filters:
             tags:
               only: /^v.*/
+      - check-core-changes:
+          requires:
+            - validate
+          filters:
+            tags:
+              only: /^v.*/
       - publish:
           requires:
             - build

.github/pull_request_template.md

@@ -10,4 +10,5 @@
 
 - [ ] This PR is made against the dev branch (all proposed changes except releases should be against dev, not master).
 - [ ] This PR has **no** breaking changes.
+- [ ] This PR does not make any changes to the core spec in the `stac-spec` directory (these are included as a subtree and should be updated directly in [radiantearth/stac-spec](https://github.com/radiantearth/stac-spec))
 - [ ] I have added my changes to the [CHANGELOG](https://github.com/radiantearth/stac-api-spec/blob/dev/CHANGELOG.md) **or** a CHANGELOG entry is not required.

fragments/itemcollection/README.md

@@ -31,7 +31,7 @@ This object describes a STAC ItemCollection. The fields `type` and `features` ar
 practices](../../stac-spec/best-practices.md#mixing-stac-versions) in mind.
 
 **stac_extensions**: A list of STAC content extensions the ItemCollection implements. The list contains URLs to the JSON Schema files it 
-can be validated against. For official [content extensions](../../stac-spec/extensions/README.md#list-of-content-extensions), a "shortcut"
+can be validated against. For official [STAC extensions](https://stac-extensions.github.io/#list-of-stac-extensions), a "shortcut"
 can be used. This means you can specify the folder name of the extension, for example `single-file-stac` for the Single File 
 STAC extension. This does *not* apply for [API extensions](../../extensions.md). If the versions of the extension and the item diverge, 
 you can specify the URL of the JSON schema file. This list must only contain extensions that extend the ItemCollection itself, see the 
@@ -41,5 +41,5 @@ the 'Scope' column in the list of extensions. It must not contain extensions tha
 
 - The [Context Extension](../../item-search/README.md#context) adds additional fields to STAC ItemCollection relevant 
   to their use as search results.
-- The [Single File STAC Extension](../../stac-spec/extensions/single-file-stac/README.md) provides a set of Collections and Items 
+- The [Single File STAC Extension](https://github.com/stac-extensions/single-file-stac/blob/main/README.md) provides a set of Collections and Items 
   as a single file catalog.

package.json

@@ -15,7 +15,8 @@
     "check-openapi-item-search": "spectral lint item-search/openapi.yaml --ruleset .circleci/.spectral.yml",
     "check-openapi-fragments": "spectral lint fragments/*/openapi.yaml --ruleset .circleci/.spectral-fragments.yml",
     "build-openapi": ".circleci/build-openapi.sh",
-    "publish-openapi": "node .circleci/publish.js"
+    "publish-openapi": "node .circleci/publish.js",
+    "check-stac-spec-changes": "git diff --quiet HEAD ${npm_config_compare_to} -- stac-spec"
   },
   "dependencies": {
     "@stoplight/spectral": "^5.7.1",

stac-spec/.circleci/config.yml

@@ -0,0 +1,53 @@
+version: 2
+jobs:
+  test_examples:
+    working_directory: ~/stac
+    docker:
+      - image: circleci/node:12
+    steps:
+      - checkout
+      - run:
+          name: install
+          command: npm install
+      - run:
+          name: validate
+          command: npm run check-examples
+  test_docs:
+    working_directory: ~/stac
+    docker:
+      - image: circleci/node:12
+    steps:
+      - checkout
+      - run:
+          name: install
+          command: npm install
+      - run:
+          name: validate
+          command: npm run check-markdown
+  publish_schemas:
+    working_directory: ~/stac
+    docker:
+      - image: circleci/node:12
+    steps:
+      - checkout
+      - run:
+          name: install
+          command: npm install
+      - add_ssh_keys:
+          fingerprints:
+            - "9b:0a:88:ff:12:d1:29:9a:ff:bb:72:ab:7d:81:df:59"
+      - run:
+          name: publish
+          command: npm run publish-schemas -- $CIRCLE_TAG
+workflows:
+  version: 2
+  ci:
+    jobs:
+      - test_examples
+      - test_docs
+      - publish_schemas:
+          filters:
+            tags:
+              only: /^v.*/
+            branches:
+              ignore: /^((?!dev).)*$/

stac-spec/.circleci/publish-schemas.js

@@ -0,0 +1,40 @@
+const klaw = require('klaw-sync');
+const path = require('path');
+const fs = require('fs');
+const ghpages = require('gh-pages');
+
+function filterFn (item) {
+	const basename = path.basename(item.path);
+	return basename === '.' || basename === 'node_modules' || basename[0] !== '.';
+}
+
+let args = process.argv.slice(2);
+let tag = 'dev';
+if (args.length && args[0].trim().length > 0) {
+	tag = args[0];
+}
+
+var folder = '.';
+var jsonSchemaFolderPattern = path.sep + 'json-schema' + path.sep;
+for (let file of klaw(folder, {filter: filterFn})) {
+	if (file.path.includes(jsonSchemaFolderPattern) && path.extname(file.path) === '.json') {
+		let source = file.path;
+		let target = 'schemas' + path.sep + tag + path.sep + path.relative(folder, file.path);
+		fs.mkdirSync(path.dirname(target), { recursive: true });
+		fs.copyFileSync(source, target);
+		console.log(target);
+	}
+}
+
+ghpages.publish('schemas/' + tag, {
+	src: '**',
+	dest: tag,
+	message: 'Publish JSON Schemas [ci skip]',
+	user: {
+	  name: 'STAC CI',
+	  email: '[email protected]'
+	}
+}, error => {
+	console.error(error ? error : 'Deployed to gh-pages');
+	process.exit(error ? 1 : 0);
+});

stac-spec/.circleci/rc.yaml

@@ -0,0 +1,46 @@
+plugins:
+# Check links
+  - validate-links
+# Apply some recommended defaults for consistency
+  - remark-preset-lint-consistent
+  - remark-preset-lint-recommended
+# No HTML for security - can't activate yet due to STAC logo in README.md
+# - lint-no-html
+# General formatting
+#  - - remark-lint-emphasis-marker
+#    - '*'
+  - remark-lint-hard-break-spaces
+  - remark-lint-blockquote-indentation
+  - remark-lint-no-consecutive-blank-lines
+# Detect overly long lines - be liberal for now and don't restrict to 80 yet
+#  - - remark-lint-maximum-line-length
+#    - 150
+# Code
+  - remark-lint-fenced-code-flag
+  - remark-lint-fenced-code-marker
+  - remark-lint-no-shell-dollars
+  - - remark-lint-code-block-style
+    - 'fenced'
+# Headings
+  - remark-lint-heading-increment
+  - remark-lint-no-duplicate-headings
+  - remark-lint-no-multiple-toplevel-headings
+  - remark-lint-no-heading-punctuation
+  - - remark-lint-maximum-heading-length
+    - 70
+  - - remark-lint-heading-style
+    - atx
+# Lists
+  - remark-lint-list-item-bullet-indent
+  - remark-lint-ordered-list-marker-style
+  - remark-lint-ordered-list-marker-value
+  - remark-lint-checkbox-character-style
+#  - - remark-lint-unordered-list-marker-style
+#    - '-'
+  - - remark-lint-list-item-indent
+    - space 
+# Tables
+  - remark-lint-table-pipes
+#  - remark-lint-table-pipe-alignment # Wait for https://github.com/remarkjs/remark-lint/issues/226  
+# Urls
+  - remark-lint-no-literal-urls

stac-spec/.github/pull_request_template.md

@@ -0,0 +1,14 @@
+**Related Issue(s):** #
+
+
+**Proposed Changes:**
+
+1. 
+2. 
+
+**PR Checklist:**
+
+- [ ] This PR is made against the dev branch (all proposed changes except releases should be against dev, not master).
+- [ ] This PR has **no** breaking changes.
+- [ ] I have added my changes to the [CHANGELOG](https://github.com/radiantearth/stac-spec/blob/dev/CHANGELOG.md) **or** a CHANGELOG entry is not required.
+- [ ] This PR affects the [STAC API spec](https://github.com/radiantearth/stac-api-spec), and I have opened issue/PR #XXX to track the change.

stac-spec/.gitignore

@@ -0,0 +1,69 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+package-lock.json
+
+# Typescript v1 declaration files
+typings/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+
+# next.js build output
+.next
+
+# IntelliJ IDEA files
+.idea/
+*.iml
+
+# Folder created when CI puhlishes JSON Schemas
+schemas/

stac-spec/.remarkignore

@@ -0,0 +1 @@
+/CHANGELOG.md